Saltar a contenido

Servidor MCP

HodeiShield aloja un servidor MCP — el protocolo abierto con el que un asistente de IA usa herramientas externas — en https://mcp.hodeishield.com/mcp, con el transporte HTTP «streamable» de la especificación. No instalas nada: conectas tu cliente MCP a esa URL y el asistente gana visibilidad de sólo lectura sobre los datos de tu inquilino.

Sólo lectura, y propuestas que aprueba una persona

Ninguna de las trece herramientas de lectura modifica nada, y tampoco las dos de propuestas: propose_action sólo registra una propuesta que una persona de tu organización tiene que aprobar en la consola (ver Propuestas). Cada herramienta corresponde a una operación de la API pública /v1: el servidor MCP nunca accede a la base de datos directamente, sólo llama a esa API con tu propia identidad.

Plan requerido

El servidor MCP está disponible en los planes Operate y Enterprise. Si tu inquilino está en un plan inferior, la pantalla de autorización lo indica y no se emite ningún token de acceso para este recurso. El plan y la licencia se comprueban de nuevo en cada llamada a una herramienta: si el inquilino baja de plan, o su licencia se suspende, se revoca o caduca, la siguiente llamada se rechaza con 403 (MCP_TIER_INSUFFICIENT o LICENCE_INACTIVE). Mientras la beta de tu organización está en curso, el servidor MCP está incluido sea cual sea tu plan: la beta da acceso completo (nivel Enterprise), también a los inquilinos cliente de un MSSP en la beta.

Conectar

  1. En tu cliente MCP (Claude.ai u otro que soporte servidores remotos con OAuth), añade un conector con la URL https://mcp.hodeishield.com/mcp. En Claude.ai esto se hace como conector personalizado; la ubicación exacta del menú depende de cada cliente.
  2. El cliente hace una primera petición sin credenciales. El servidor responde 401 con una cabecera WWW-Authenticate que apunta al documento de descubrimiento https://mcp.hodeishield.com/.well-known/oauth-protected-resource (RFC 9728). El cliente lee ese documento y localiza el servidor de autorización sin que tengas que configurar nada a mano.
  3. Se abre el navegador para que inicies sesión en app.hodeishield.com con OAuth 2.1 (código de autorización + PKCE), con los mismos factores que ya usas hoy — 2FA, passkey o SSO. El detalle de ese flujo, sus ámbitos y cómo revocar el acceso concedido a una aplicación se documenta en Autenticación y claves de API; esta página no lo repite.
sequenceDiagram
    participant U as Tu asistente / cliente MCP
    participant M as Servidor MCP
    participant A as app.hodeishield.com
    participant V as API /v1

    U->>M: Llamada a una herramienta, sin token
    M-->>U: 401 + WWW-Authenticate (descubrimiento OAuth)
    U->>A: Inicio de sesión (OAuth 2.1 + PKCE, con tu 2FA/passkey/SSO)
    A-->>U: Token de acceso
    U->>M: Misma llamada, con el token
    M->>V: Petición de lectura con tu identidad
    V-->>M: Datos de tu inquilino, según tus ámbitos
    M-->>U: Resultado envuelto en un sobre

Al conceder el acceso eliges un inquilino de los que ves en la consola. Lo que ve el asistente es exactamente lo que verías tú en ese inquilino, y sólo con los ámbitos de lectura que concediste. Ninguna herramienta acepta un identificador de inquilino u organización como parámetro — no hay forma de pedirle datos de otro inquilino. Para trabajar con otro, vuelve a iniciar sesión desde tu cliente y elígelo.

Herramientas disponibles

Trece herramientas, una por operación de /v1 que responde JSON (la descarga del fichero de un informe, GET /v1/reports/{id}/download, es sólo de la API: su respuesta es un PDF o un libro de cálculo, no datos que lea un modelo). Las de listado paginan con page y per_page (hasta 50) y aceptan los mismos filtros que la operación equivalente de la API — la referencia completa de cada filtro vive en Referencia de la API.

Herramienta Operación de /v1
list_vendors / get_vendor Proveedores
list_alerts / get_alert Alertas
list_risks / get_risk Riesgos
list_compliance_controls Controles de cumplimiento por marco
get_framework_posture Postura de un marco de cumplimiento
list_evidence / get_evidence Evidencias
list_endpoints Endpoints
list_reports / get_report Informes generados

list_compliance_controls y get_framework_posture reciben un parámetro framework con uno de estos valores: nis2, ens, iso27001, dora, gdpr, soc2, iso42001, nistcsf, pcidss, euaiact, hipaa, cmmc, cyberessentials, uaeia, sama, saudiecc, ndpa. Cada marco exige su propio ámbito de lectura: conceder acceso a nis2 no da visibilidad sobre dora.

Propuestas

propose_action pide a HodeiShield que registre una propuesta de una acción: create_task, schedule_vendor_scan o request_vendor_evidence. No cambia nada hasta que una persona de tu organización la aprueba en la bandeja de propuestas de la consola, que la ejecuta con el rol de quien aprueba; quien la propuso no puede aprobarla. Una propuesta que nadie decide caduca a los 7 días. Una propuesta aprobada aún puede acabar como refused: si, cuando va a ejecutarse, el acceso que la propuso se ha revocado o el plan del inquilino ya no incluye el acceso MCP, no se ejecuta. get_proposal_status te dice qué pasó con una propuesta hecha desde la misma aplicación: proposed, approved, executed, rejected, refused (con un motivo) o expired.

Proponer necesita el permiso act:propose, que la pantalla de consentimiento muestra como «Proponer acciones que una persona de tu organización tendrá que aprobar», y hay que pedirlo junto con el permiso de lectura del área a la que pertenece la acción. Si tu conexión se hizo sin él, la herramienta lo dice; vuelve a conectar HodeiShield y permítelo. Como mucho 10 propuestas por minuto y 20 pendientes de decisión, por aplicación y usuario, y lo mismo por usuario sumando todas sus aplicaciones.

Modelo de seguridad

  • Cada resultado va envuelto en un sobre con source: "hodeishield:/v1" y una nota explícita de que es un dato de tu inquilino, nunca una instrucción para el asistente.
  • Inyección indirecta de instrucciones. El texto de un proveedor, de una evidencia o de una nota lo escribe una persona o un tercero — no HodeiShield. Un modelo de lenguaje puede llegar a tratar ese texto como una orden. El servidor no puede impedir lo que tu cliente MCP haga con el resultado: revisa siempre, con otras herramientas, cualquier acción que el asistente proponga a partir de un dato que provenga de aquí.
  • El texto de terceros va entrecomillado. El texto libre de un resultado (nombres, títulos, descripciones, notas) llega dentro de elementos <untrusted_data>, sin caracteres de control, de anchura cero ni bidireccionales, y truncado si supera los 2.000 caracteres; el enlace de origen de una alerta se reduce a su host (source_host). El sobre enumera esos campos en third_party_fields. Así el modelo ve el límite; no sustituye tu revisión.
  • Límite de tasa propio. Además de las cuotas de la API, el servidor MCP aplica su propio límite por usuario de 60 peticiones por minuto (el valor por defecto de MCP_RATE_LIMIT_PER_SUBJECT_PER_MINUTE); al superarlo responde 429 con Retry-After.
  • Los registros no guardan contenido. El servidor anota qué herramienta se llamó y con qué resultado técnico, pero nunca los argumentos de la llamada, sus resultados ni tu token.

Siguiente paso