Saltar al contenido principal

MODEL_CONTEXT_PROTOCOL_INTEGRATION_CORE

AI_COGNITIVE_CHANNEL: ACTIVE

DevOps Monitor implementa de forma nativa el Model Context Protocol (MCP) desarrollado por Anthropic. Esto permite que agentes cognitivos externos e Inteligencias Artificiales (como Claude, Gemini o GPT-4) se conecten de manera segura a tu Workspace, expongan métricas DORA de forma contextual y ejecuten diagnósticos automáticos.

01_MCP_ARCHITECTURE​

El transporte de datos de MCP en DevOps Monitor utiliza una arquitectura híbrida basada en Server-Sent Events (SSE) para la transmisión unidireccional del servidor al agente, y llamadas HTTP POST para el envío de peticiones JSON-RPC del agente al servidor.

+--------------+        1. GET /mcp (SSE Connection Init)        +----------------------+
|  AI AGENT    | ----------------------------------------------> | DevOps Monitor Core  |
|  (Claude/etc)| <---------------------------------------------- | (Genera sessionId)   |
+--------------+             2. Server-Sent Events (SSE)         +----------------------+
       |
       | 3. POST /mcp/message?sessionId=XYZ (JSON-RPC Tools)
       v
+-------------------------------+
|  JSON-RPC Command Execution   | --> [ Lee BigQuery / Azure DevOps ]
+-------------------------------+

02_MCP_ESTABLISH_SESSION​

Endpoint: GET /mcp

Abre un canal continuo de Server-Sent Events (SSE) para el cliente de IA. Es una ruta autenticada mediante tokens JWT.

A. Estructura de Petición​

  • Parámetros Query:
    • token (Opcional): Token JWT del operador si no se provee en las cabeceras estándar.
  • Encabezados:
    • Authorization: Bearer <YOUR_JWT_TOKEN>
    • Accept: text/event-stream

B. Evento de Conexión (SSE Stream Output)​

Al iniciar la conexión con éxito, el servidor responde con un código 200 OK y emite un evento inicial que provee el identificador de sesión (sessionId) y el endpoint seguro para despachar comandos:

event: endpoint
data: "https://devsecops-monitor.newinntech.com/api/mcp/message?sessionId=5eb12e197e06a76ccdefc121"

03_MCP_EXECUTE_TOOLS​

Endpoint: POST /mcp/message

Toda llamada a herramientas (Tools) una vez iniciada la sesión se realiza en formato estándar JSON-RPC 2.0.

A. Invocación de Herramientas (Request Body)​

Los agentes de IA envían peticiones JSON-RPC especificando el nombre del método y los argumentos necesarios para recuperar contexto del Workspace.

  • Parámetros Query: sessionId=5eb12e197e06a76ccdefc121
  • Cuerpo (JSON-RPC):
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "get_workspace_failing_tasks",
    "arguments": {
      "workspaceId": 1,
      "severity": "CRITICAL"
    }
  }
}

B. Respuesta del Servidor (JSON-RPC Response)​

El servidor ejecuta la consulta internamente sobre la base de datos de telemetría y responde con el contexto en formato estructurado de texto para ser absorbido por el cerebro del LLM:

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "SYS_TELEMETRY Tarea 'TypeScript Compile' fallando repetidamente en rama 'main' de repo 'DevOpsMonitor' (Tasa de fallo: 78.4%)."
      }
    ],
    "isError": false
  }
}

04_SECURITY_SANDBOXING​

  • Aislamiento de Contexto: Los agentes de IA conectados vía MCP están estrictamente restringidos al Workspace asociado al token JWT utilizado para iniciar la conexión en /mcp. Un agente nunca podrá consultar datos de organizaciones ajenas.
  • Permisos de Escritura: Por defecto, los canales MCP operan en modo Read-Only para proteger la integridad de tus repositorios y pipelines.