centinela-mcp

código decodificador insignia de herrería

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 stdoio , 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

Lanzar el transporte:

npx @sentry/mcp-server@latest --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

Ingrese la URL del servidor MCP ( http://localhost:5173 ) y haga clic en "Conectar". Esto debería iniciar el proceso de autenticación.

Nota: Si tiene problemas con su flujo OAuth al acceder al inspector en 127.0.0.1 , intente usar localhost en su lugar visitando http://localhost:6274 .

Related MCP server: Sentry MCP Server

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, introduzca http://localhost:8788/sse en el Inspector y pulse 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@latest 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.