Puesta en marcha y configuración - MCP

Qué hace esta integración

El servidor remoto MCP (Model Context Protocol) permite a los asistentes de IA y a otras herramientas que hablan este estándar comunicarse directamente con los datos de monitorización de DockRay - buscar proyectos y errores, leer su detalle diagnóstico y, con los permisos adecuados, cambiar el estado de un error o gestionar un proyecto. Hay un único endpoint: POST https://dockray.io/api/mcp, JSON-RPC 2.0, versión de protocolo 2025-06-18. Es un componente de pago del plan, independiente de la ingesta de errores - una cuenta sin él no puede emitir una clave funcional.

Crear una clave de acceso

En el panel ve a Ajustes → Integración MCP y crea una clave nueva. Ponle un nombre que corresponda al cliente o a la automatización que la usará, y marca solo los permisos que esa herramienta necesita de verdad. El token generado se muestra una sola vez, al crearlo - DockRay solo guarda su hash, así que un token perdido no se puede recuperar, solo sustituir generando una clave nueva.

Conectar un cliente MCP

En un cliente que hable MCP, configura como endpoint https://dockray.io/api/mcp y añade una cabecera de autorización con el token:

Authorization: Bearer dockray_mcp_…

Una vez conectado, el cliente debería llamar a la petición estándar tools/list - la respuesta solo lista las herramientas para las que la clave tiene permiso. Una herramienta para la que la clave no tiene permiso simplemente no existe desde su punto de vista: no aparece en la lista, y llamarla falla como si nunca se hubiera definido.

La primera prueba

Llama desde el cliente a projects.list - debería devolver los proyectos de la cuenta a la que pertenece la clave, junto con su estado actual de monitorización. Si has marcado el permiso de lectura de errores, prueba también issues.list en uno de los proyectos. Una respuesta vacía a pesar de haber datos suele significar que a la clave le falta el permiso adecuado, no que la cuenta no tenga nada que mostrar.

Cómo es una llamada

El servidor habla JSON-RPC 2.0 puro, así que llamar a una herramienta es una petición POST normal con el método tools/call:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "projects.list",
    "arguments": {"limit": 10}
  }
}

Una herramienta desconocida o no permitida recibe exactamente la misma forma de respuesta que la llamada a un método que nunca existió - desde el punto de vista del protocolo no hay diferencia entre 'sin permiso' y 'esta herramienta no está definida'.

Claves separadas para clientes separados

Merece la pena emitir una clave distinta para cada cliente o automatización, incluso si necesitan los mismos permisos. Las claves se revocan de forma independiente: perder una herramienta, o terminar la relación con un proveedor, no obliga entonces a interrumpir las demás integraciones.