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¶
- 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. - El cliente hace una primera petición sin credenciales. El servidor responde
401con una cabeceraWWW-Authenticateque apunta al documento de descubrimientohttps://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. - Se abre el navegador para que inicies sesión en
app.hodeishield.comcon 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 enthird_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 responde429conRetry-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.