ThinkReview MCP
Revisiones de código con IA para URLs de PR/MR de GitHub, GitLab, Azure DevOps y Bitbucket desde Cursor, Claude o Copilot.
Documentación
ThinkReview MCP permite que los asistentes de codificación con IA ejecuten revisiones de código en vivo sobre URLs de pull requests o merge requests — sin necesidad de pegar un diff en el chat. ThinkReview obtiene los archivos modificados a través de tus credenciales de git almacenadas y devuelve una revisión estructurada (resumen, sugerencias, notas de seguridad, mejores prácticas y preguntas sugeridas).
Endpoint alojado: https://mcp.thinkreview.dev/v1
Autenticación — elige una:
- OAuth (recomendado) — Configuración MCP solo con URL, luego Autentícate en el navegador en el portal de ThinkReview. Sin token en archivos de configuración.
- Token Bearer — Copia un token de larga duración desde la página de configuración de MCP y coloca
Authorization: Bearer <token>en los encabezados del cliente (también utilizado por la extensión del navegador).
Configuraciones interactivas para ambos métodos: portal.thinkreview.dev/mcp.
Requisitos previos
Antes de conectar un cliente MCP, asegúrate de tener:
- Una cuenta de ThinkReview con un plan activo o créditos de revisión disponibles.
- Un cliente MCP que soporte OAuth para servidores HTTP remotos (Cursor, Claude Code, Claude Desktop Connectors y VS Code Copilot lo soportan).
- Credenciales de git configuradas en el portal en Configuración → Integraciones. Esto es obligatorio para que funcionen las revisiones de URLs MCP. ThinkReview utiliza tu Token de Acceso Personal (PAT) para llamar a las APIs de GitHub, GitLab, Bitbucket o Azure DevOps y obtener el diff del PR/MR. Sin integraciones, las revisiones fallarán con un error de credenciales de git o de acceso.
Los hosts de git compatibles coinciden con la extensión: GitHub, GitLab, Bitbucket y Azure DevOps (nube y muchos patrones autoalojados). Consulta Integración con GitHub, Integración con GitLab y la documentación de configuración relacionada para los alcances del PAT.
Qué proporciona el servidor MCP
ThinkReview MCP expone una herramienta:
| Herramienta | Propósito |
|---|---|
review_url_code | Ejecuta una revisión de código en vivo basada en URL sobre una URL de PR o MR |
Parámetros opcionales:
| Parámetro | Descripción |
|---|---|
prUrl | Obligatorio. URL completa o de estilo dominio del PR/MR (p. ej. https://github.com/org/repo/pull/42) |
language | Idioma de la respuesta (predeterminado: inglés) |
mrId | ID de seguimiento opcional para tu flujo de trabajo |
forceRegenerate | Establécelo en true para omitir la caché y forzar una nueva revisión |
Las revisiones por URL utilizan los mismos créditos de revisión que las revisiones en la extensión del navegador. Los resultados en caché se reutilizan cuando la lista de archivos del PR no ha cambiado (consulta Revisiones en caché).
Revisiones de agentes (agentes de revisión personalizados configurados en el portal) no se activan de forma predeterminada a través de MCP. MCP devuelve solo la revisión de código principal.
Reglas personalizadas del portal sí se aplican a las revisiones de URLs MCP, incluido el diseño de severidad predeterminado. Consulta Reglas personalizadas.
Configuración en Cursor
- Abre Cursor → Configuración → MCP (o edita tu archivo de configuración MCP).
- Agrega el servidor de ThinkReview (solo URL):
{
"mcpServers": {
"thinkreview": {
"url": "https://mcp.thinkreview.dev/v1"
}
}
}
- Habilita el servidor thinkreview, luego haz clic en Autenticar. Completa el inicio de sesión y el consentimiento en el portal de ThinkReview.
- Reinicia Cursor o recarga los servidores MCP si las herramientas no aparecen.
Ejemplo de prompt: "Llama a review_url_code para https://github.com/org/repo/pull/123”
Configuración en Claude Code
Opción A — CLI
claude mcp add --transport http thinkreview https://mcp.thinkreview.dev/v1
Opción B — Archivo de configuración (~/.claude.json o .mcp.json del proyecto):
{
"mcpServers": {
"thinkreview": {
"type": "http",
"url": "https://mcp.thinkreview.dev/v1"
}
}
}
Luego ejecuta /mcp en Claude Code y autentícate. Completa el consentimiento del portal en el navegador. Reinicia Claude Code si las herramientas no aparecen después de la autenticación.
Nota: El JSON de type / url de Claude Code no es válido en claude_desktop_config.json de Claude Desktop. Usa la sección de Desktop a continuación.
Configuración en Claude Desktop
Claude Desktop tiene dos mecanismos MCP diferentes:
| Mecanismo | Ubicación | ¿Soporta HTTP remoto + OAuth? |
|---|---|---|
| Connectors (recomendado) | Configuración → Connectors | Sí — MCP remoto nativo |
claude_desktop_config.json | Configuración → Desarrollador → Editar configuración | solo stdio — usa mcp-remote como puente |
- Abre Claude Desktop → Configuración → Connectors (o Personalizar → Connectors).
- Agrega un connector personalizado e ingresa:
https://mcp.thinkreview.dev/v1 - Haz clic en Conectar / completa el consentimiento OAuth en el navegador en el portal de ThinkReview.
- Habilita el connector para la conversación mediante + → Connectors.
Los connectors remotos se gestionan a través de tu cuenta de Claude (la nube de Anthropic llega a mcp.thinkreview.dev). Los planes gratuitos están limitados a un connector personalizado.
Opción B — Puente local mediante mcp-remote
Si prefieres el archivo de configuración (mismo patrón que otros servidores remotos), fusiona esto en claude_desktop_config.json (requiere Node.js para que npx funcione), luego cierra y vuelve a abrir completamente Claude Desktop:
{
"mcpServers": {
"thinkreview": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.thinkreview.dev/v1"]
}
}
}
mcp-remote abre el flujo OAuth en el navegador. No uses el bloque "type": "http" de Claude Code aquí — Desktop no lo cargará.
Configuración en GitHub Copilot (VS Code)
- Ejecuta MCP: Abrir configuración de usuario o crea
.vscode/mcp.jsonen tu proyecto. - Agrega (solo URL — Copilot usa la clave
servers):
{
"servers": {
"thinkreview": {
"type": "http",
"url": "https://mcp.thinkreview.dev/v1"
}
}
}
- Usa Auth / Autenticar en el servidor thinkreview (CodeLens o interfaz de servidores MCP) y completa el consentimiento del portal en el navegador.
- Habilita el servidor thinkreview en Copilot Chat e invoca
review_url_codedesde tu asistente.
Avanzado: Token Bearer (opcional)
Prefiere OAuth para MCP. Un token Bearer del portal sigue disponible en portal.thinkreview.dev/mcp para la extensión del navegador de ThinkReview y para clientes que no pueden completar OAuth. Si debes usarlo, agrega:
Authorization: Bearer <your-token>
Regenerar ese token invalida la extensión / los clientes basados en Bearer. Las sesiones MCP OAuth son independientes y no se revocan con la regeneración del token.
Mejores prácticas de seguridad
- Prefiere OAuth para que los tokens de larga duración no se almacenen en archivos de configuración MCP.
- Si usas un token Bearer, trátalo como una contraseña. No lo confirmes en git ni lo compartas en canales públicos.
- Regenera el token Bearer desde el portal si alguna vez se expone.
- Usa PATs de git con los alcances mínimos necesarios para leer pull requests y diffs de archivos de los repositorios que revisas.
Solución de problemas
"No autorizado" o MCP solicita autenticación
- Para clientes OAuth: ejecuta Autenticar nuevamente y completa el consentimiento en portal.thinkreview.dev/mcp/oauth mientras estás conectado a tu cuenta de ThinkReview.
- Confirma que tu configuración sea solo URL (sin encabezado
Authorizationobsoleto o vacío que pueda confundir a algunos clientes). - Si usas intencionalmente autenticación Bearer, confirma que
Authorization: Bearer <token>esté configurado correctamente y copia un token nuevo desde el portal después de la regeneración o el cierre de sesión. - Reinicia tu cliente MCP después de actualizar la configuración.
Credenciales de git no disponibles / no se puede acceder al repositorio
- Agrega o actualiza tu PAT en portal.thinkreview.dev → Configuración → Integraciones. MCP no puede revisar un PR sin este paso.
- Para repositorios de organizaciones privadas (p. ej., GitHub), asegúrate de que el PAT tenga acceso a la organización y que SSO esté autorizado para el token si tu organización lo requiere.
- Verifica que la URL del PR coincida con el host y el repositorio para el que está configurada tu credencial.
La revisión devuelve resultados en caché
- Las revisiones por URL se almacenan en caché por usuario cuando la huella del archivo modificado no cambia. Pasa
forceRegenerate: trueenreview_url_codepara solicitar una revisión nueva.
¿Sigue atascado?
Contacta con soporte o reporta un error con tu host de git, URL del PR (redacta secretos) y el mensaje de error de tu cliente MCP.
Resumen: Agrega ThinkReview MCP en https://mcp.thinkreview.dev/v1 (solo URL), autentícate en el navegador, configura credenciales de git en Integraciones y luego pide a tu asistente que llame a review_url_code con una URL de PR.