ThinkReview MCP

ThinkReview MCP permite que assistentes de codificação com IA executem revisões de código ao vivo em URLs de pull requests ou merge requests — sem precisar colar um diff no chat. O ThinkReview busca os arquivos alterados por meio das suas credenciais git armazenadas e retorna uma revisão estruturada (resumo, sugestões, notas de segurança, boas práticas e perguntas sugeridas).

Endpoint hospedado: https://mcp.thinkreview.dev/v1

Autenticação — escolha uma:

OAuth (recomendado) — configuração MCP apenas com URL e, em seguida, Autenticar no navegador no portal ThinkReview. Sem token em arquivos de configuração.
Token Bearer — copie um token de longa duração da página de configuração do MCP e coloque Authorization: Bearer <token> nos cabeçalhos do cliente (também usado pela extensão do navegador).

Configurações interativas para ambos os métodos: portal.thinkreview.dev/mcp.

Pré-requisitos

Antes de conectar um cliente MCP, certifique-se de ter:

Uma conta ThinkReview com um plano ativo ou créditos de revisão disponíveis.
Um cliente MCP que suporte OAuth para servidores HTTP remotos (Cursor, Claude Code, Claude Desktop Connectors e VS Code Copilot suportam).
Credenciais git configuradas no portal em Configurações → Integrações. Isso é obrigatório para que as revisões por URL via MCP funcionem. O ThinkReview usa seu Personal Access Token (PAT) para chamar as APIs do GitHub, GitLab, Bitbucket ou Azure DevOps e buscar o diff do PR/MR. Sem integrações, as revisões falharão com um erro de credenciais git ou de acesso.

Os hosts git suportados correspondem à extensão: GitHub, GitLab, Bitbucket e Azure DevOps (nuvem e muitos padrões self-hosted). Consulte Integração com GitHub, Integração com GitLab e a documentação relacionada para escopos de PAT.

O que o servidor MCP oferece

O ThinkReview MCP expõe uma ferramenta:

Ferramenta	Finalidade
`review_url_code`	Executar uma revisão de código ao vivo baseada em URL em uma URL de PR ou MR

Parâmetros opcionais:

Parâmetro	Descrição
`prUrl`	Obrigatório. URL de PR/MR completa ou no formato de domínio (ex.: `https://github.com/org/repo/pull/42`)
`language`	Idioma da resposta (padrão: inglês)
`mrId`	ID de rastreamento opcional para seu fluxo de trabalho
`forceRegenerate`	Defina como `true` para ignorar o cache e forçar uma nova revisão

As revisões por URL usam os mesmos créditos de revisão que as revisões na extensão do navegador. Resultados em cache são reutilizados quando a lista de arquivos do PR não mudou (consulte Revisões em Cache).

Revisões de agente (agentes de revisão personalizados configurados no portal) não são acionadas por padrão via MCP. O MCP retorna apenas a revisão de código principal.

Regras personalizadas do portal se aplicam às revisões por URL via MCP, incluindo o layout de severidade padrão. Consulte Regras Personalizadas.

Configuração no Cursor

Abra Cursor → Configurações → MCP (ou edite seu arquivo de configuração MCP).
Adicione o servidor ThinkReview (apenas URL):

{
  "mcpServers": {
    "thinkreview": {
      "url": "https://mcp.thinkreview.dev/v1"
    }
  }
}

Ative o servidor thinkreview e clique em Autenticar. Conclua o login e o consentimento no portal ThinkReview.
Reinicie o Cursor ou recarregue os servidores MCP se as ferramentas não aparecerem.

Exemplo de prompt: "Chame review_url_code para https://github.com/org/repo/pull/123”

Configuração no Claude Code

Opção A — CLI

claude mcp add --transport http thinkreview https://mcp.thinkreview.dev/v1

Opção B — Arquivo de configuração (~/.claude.json ou projeto .mcp.json):

{
  "mcpServers": {
    "thinkreview": {
      "type": "http",
      "url": "https://mcp.thinkreview.dev/v1"
    }
  }
}

Em seguida, execute /mcp no Claude Code e Autentique. Conclua o consentimento no portal no navegador. Reinicie o Claude Code se as ferramentas não aparecerem após a autenticação.

Observação: o JSON type / url do Claude Code não é válido no claude_desktop_config.json do Claude Desktop. Use a seção Desktop abaixo.

Configuração no Claude Desktop

O Claude Desktop tem dois mecanismos MCP diferentes:

Mecanismo	Onde	Suporta HTTP remoto + OAuth?
Connectors (recomendado)	Configurações → Connectors	Sim — MCP remoto nativo
`claude_desktop_config.json`	Configurações → Desenvolvedor → Editar Config	apenas stdio — use `mcp-remote` como ponte

Abra Claude Desktop → Configurações → Connectors (ou Personalizar → Connectors).
Adicione um connector personalizado e insira: https://mcp.thinkreview.dev/v1
Clique em Conectar / conclua o consentimento OAuth no navegador no portal ThinkReview.
Ative o connector para a conversa via + → Connectors.

Connectors remotos são intermediados pela sua conta Claude (a nuvem da Anthropic acessa mcp.thinkreview.dev). Planos gratuitos são limitados a um connector personalizado.

Opção B — Ponte local via mcp-remote

Se preferir o arquivo de configuração (mesmo padrão de outros servidores remotos), mescle isto em claude_desktop_config.json (requer Node.js para que npx funcione) e, em seguida, saia e reabra completamente o Claude Desktop:

{
  "mcpServers": {
    "thinkreview": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.thinkreview.dev/v1"]
    }
  }
}

mcp-remote abre o fluxo OAuth no navegador. Não use o bloco "type": "http" do Claude Code aqui — o Desktop não o carregará.

Configuração no GitHub Copilot (VS Code)

Execute MCP: Open User Configuration ou crie .vscode/mcp.json no seu projeto.
Adicione (apenas URL — o Copilot usa a chave servers):

{
  "servers": {
    "thinkreview": {
      "type": "http",
      "url": "https://mcp.thinkreview.dev/v1"
    }
  }
}

Use Auth / Autenticar no servidor thinkreview (CodeLens ou interface de servidores MCP) e conclua o consentimento no portal no navegador.
Ative o servidor thinkreview no Copilot Chat e invoque review_url_code pelo seu assistente.

Avançado: Token Bearer (opcional)

Prefira OAuth para MCP. Um token Bearer do portal ainda está disponível em portal.thinkreview.dev/mcp para a extensão do navegador ThinkReview e para clientes que não conseguem concluir OAuth. Se precisar usá-lo, adicione:

Authorization: Bearer <your-token>

Regenerar esse token invalida a extensão / clientes baseados em Bearer. Sessões MCP OAuth são separadas e não são revogadas pela regeneração do token.

Boas práticas de segurança

Prefira OAuth para que tokens de longa duração não sejam armazenados em arquivos de configuração MCP.
Se usar um token Bearer, trate-o como uma senha. Não o envie para o git nem o compartilhe em canais públicos.
Regenerar o token Bearer no portal se ele for exposto.
Use PATs git com os escopos mínimos necessários para ler pull requests e diffs de arquivos dos repositórios que você revisa.

Solução de problemas

"Não autorizado" ou o MCP pede autenticação

Para clientes OAuth: execute Autenticar novamente e conclua o consentimento em portal.thinkreview.dev/mcp/oauth enquanto estiver conectado à sua conta ThinkReview.
Confirme que sua configuração é apenas URL (sem cabeçalho Authorization obsoleto ou vazio que possa confundir alguns clientes).
Se você usa autenticação Bearer intencionalmente, confirme que Authorization: Bearer <token> está definido corretamente e copie um token novo do portal após regeneração ou logout.
Reinicie seu cliente MCP após atualizar a configuração.

Credenciais git indisponíveis / não é possível acessar o repositório

Adicione ou atualize seu PAT em portal.thinkreview.dev → Configurações → Integrações. O MCP não pode revisar um PR sem esta etapa.
Para repositórios de organizações privadas (ex.: GitHub), garanta que o PAT tenha acesso à organização e que o SSO esteja autorizado para o token se sua organização exigir.
Verifique se a URL do PR corresponde ao host e ao repositório para o qual sua credencial está configurada.

A revisão retorna resultados em cache

As revisões por URL são armazenadas em cache por usuário quando a impressão digital dos arquivos alterados não mudou. Passe forceRegenerate: true em review_url_code para solicitar uma revisão nova.

Ainda com problemas?

Entre em contato com o suporte ou relate um bug com seu host git, URL do PR (remova segredos) e a mensagem de erro do seu cliente MCP.

Resumo: Adicione o ThinkReview MCP em https://mcp.thinkreview.dev/v1 (apenas URL), Autentique no navegador, configure credenciais git em Integrações e peça ao seu assistente para chamar review_url_code com uma URL de PR.