centinela-mcp

Este es un prototipo de un servidor MCP remoto, que actúa como middleware para el proveedor de API Sentry ascendente.

Se basa en el trabajo de Cloudflare hacia los MCP remotos .

Empezando

Encontrarás todo lo que necesitas saber visitando el servicio implementado en producción:

https://mcp.sentry.dev

Si desea contribuir, aprender cómo funciona o ejecutar esto para Sentry autohospedado, continúe a continuación.

Stdio vs. Remoto

Si bien este repositorio se centra en actuar como un servicio MCP, también admitimos el transporte stdio . Aún estamos en desarrollo, pero es la forma más sencilla de adaptar la ejecución del MCP en una instalación autoalojada de Sentry.

Para utilizar el transporte stdout , deberá crear un token de API personal (PAT) en Sentry con los alcances necesarios. Al momento de escribir esto:

org:read
project:read
project:write
team:read
team:write
event:read

Clona el repositorio y configúralo como lo harías normalmente:

pnpm install
pnpm build

Lanzar el transporte:

pnpm start:stdio --access-token=sentry-pat --host=sentry.example.com

Nota: También puedes utilizar variables de entorno:

SENTRY_AUTH_TOKEN=
SENTRY_HOST=

Inspector de MCP

MCP incluye un Inspector , para probar fácilmente el servicio:

pnpm inspector

Ingresa https://[domain].workers.dev/sse (TODO) y pulsa "Conectar". Una vez completado el proceso de autenticación, verás las herramientas funcionando:

Acceda al servidor MCP remoto desde Claude Desktop

Abra Claude Desktop y vaya a Configuración. Presione ⌘ + , (coma) -> Desarrollador -> Editar configuración. Esto abre el archivo de configuración que controla los servidores MCP a los que Claude puede acceder.

Reemplace el contenido con la siguiente configuración. Al reiniciar Claude Desktop, se abrirá una ventana del navegador con su página de inicio de sesión de OAuth. Complete el proceso de autenticación para otorgarle a Claude acceso a su servidor MCP. Tras otorgarle acceso, podrá usar las herramientas.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-github-oauth.<your-subdomain>.workers.dev/sse"
      ]
    }
  }
}

Una vez que las Herramientas (bajo 🔨) aparezcan en la interfaz, puedes pedirle a Claude que las use. Por ejemplo: "¿Podrías usar la herramienta matemática para sumar 23 y 19?". Claude debería invocar la herramienta y mostrar el resultado generado por el servidor MCP.

Desarrollo local

Si desea iterar y probar su servidor MCP, puede hacerlo en el desarrollo local. Para ello, deberá crear otra aplicación OAuth en Sentry (Configuración => API => Aplicaciones ).

Para la URL de la página de inicio, especifique http://localhost:8788
Para las URI de redirección autorizada, especifique http://localhost:8788/callback
Anote su ID de cliente y genere un secreto de cliente.
Cree un archivo .dev.vars en la raíz de su proyecto con:

SENTRY_CLIENT_ID=your_development_sentry_client_id
SENTRY_CLIENT_SECRET=your_development_sentry_client_secret

Verificar

Ejecute el servidor localmente para que esté disponible en http://localhost:8788

pnpm dev

Para probar el servidor local, ingrese http://localhost:8788/sse en el Inspector y haga clic en Conectar. Una vez que siga las instrucciones, podrá ver "Herramientas".

Pruebas

Se incluyen dos conjuntos de pruebas: pruebas unitarias básicas y algunas evaluaciones.

Las pruebas unitarias se pueden ejecutar utilizando:

pnpm test

Las evaluaciones requerirán un archivo .env con alguna configuración:

OPENAI_API_KEY=

Una vez hecho esto, puedes ejecutarlos usando:

pnpm test

Notas

Uso de Claude y otros clientes MCP

Al usar Claude para conectarse a su servidor MCP remoto, es posible que vea algunos mensajes de error. Esto se debe a que Claude Desktop aún no es compatible con servidores MCP remotos, por lo que a veces genera confusión. Para verificar si el servidor MCP está conectado, pase el cursor sobre el icono 🔨 en la esquina inferior derecha de la interfaz de Claude. Debería ver sus herramientas disponibles allí.

Uso de Cursor y otros clientes MCP

Para conectar Cursor con su servidor MCP, elija Type : "Comando" y en el campo Command , combine los campos de comando y argumentos en uno (por ejemplo npx mcp-remote https://<your-worker-name>.<your-subdomain>.workers.dev/sse ).

Tenga en cuenta que si bien Cursor admite servidores HTTP+SSE, no admite la autenticación, por lo que aún deberá usar mcp-remote (y usar un servidor STDIO, no uno HTTP).

Puede conectar su servidor MCP a otros clientes MCP como Windsurf abriendo el archivo de configuración del cliente, agregando el mismo JSON que se utilizó para la configuración de Claude y reiniciando el cliente MCP.

Sentry MCP

Integrations