# MCP

Dos cosas distintas: una pasarela MCP gobernada a través de la cual tus agentes llaman a sus herramientas, y un servidor MCP que permite a un asistente leer tu espacio de trabajo.

## La pasarela MCP gobernada

- Un único endpoint, `POST /api/v1/mcp`, para cualquier cliente MCP estándar (Streamable HTTP), con una clave vinculada a un agente, creada en **Agentes › Herramientas MCP**.
- Un propietario o administrador mantiene el catálogo: los servidores, cómo se autentica Azoth ante ellos — secretos cifrados, nunca enviados a un agente — y la revisión de cada herramienta con su reversibilidad. Solo se exponen las herramientas aprobadas, y una definición modificada vuelve a revisión.
- Cada llamada a una herramienta pasa por el mandato del agente y por Azoth Guard; una llamada irreversible o financiera espera la aprobación de una persona. Los resultados se analizan y se marcan como no fiables. No se conserva ningún argumento ni ningún resultado: la llamada se sella con códigos y un hash.
- Por ahora solo herramientas: no se ofrecen recursos, prompts ni sampling. La pasarela está desactivada salvo que el despliegue la active (`FEATURE_MCP_GATEWAY`).

```
URL      https://www.azothos.ai/api/v1/mcp
Header   Authorization: Bearer az_live_…     # a key bound to one agent (Agents › MCP tools)
```

## El servidor MCP de Azoth

- `@azothos/mcp` es un servidor MCP sin dependencias, de código abierto bajo licencia Apache-2.0: se ejecuta en tu ordenador con Node.js 18 o posterior, sobre stdio, y lee tu espacio de trabajo con una clave de API.
- Sus herramientas devuelven las mismas cifras del panel: los mandatos y quién responde de una decisión, las reglas vigentes, las decisiones de bloqueo, el derecho aplicable, la cobertura de cumplimiento, el estado de la prueba, el gasto y la huella, y las fuentes de soporte.
- Todas las herramientas leen, salvo aquellas cuyas anotaciones indican que registran algo: `azoth_export_dossier` — cada exportación se ancla, recibe un sello de tiempo y se sella en el diario, como desde **Pruebas › Expedientes** — y, en el perfil completo, `azoth_preflight` y `azoth_compress`. Los borradores del asistente no se ofrecen: un borrador necesita que una persona lo confirme en su pantalla.

## Instalación

El servidor aún no está publicado: su paquete npm y su extensión de Claude Desktop se enlazarán aquí en cuanto lo estén.

## Perfiles

- `public`, el predeterminado: los mandatos, las reglas, la prueba, el gasto y las fuentes de soporte — las herramientas de abajo.
- `full`, con `AZOTH_MCP_PROFILE=full` (el interruptor **Full profile** de la extensión): además, las herramientas de optimización y FinOps, las de las funciones que un despliegue activa, y los nombres antiguos de las herramientas, conservados durante una versión.
- Una herramienta fuera del perfil no aparece en la lista, y una llamada a ella se rechaza indicando el perfil que la ofrece.

- `azoth_spend` — Spend and budgets by mandate
- `azoth_block_decisions` — Blocked decisions
- `azoth_unmandated_uses` — Unmandated AI uses
- `azoth_mandates_overview` — Mandates overview
- `azoth_accountability` — Who answers for a decision
- `azoth_journal_entry` — Sealed decision
- `azoth_model_choice` — Why this model and region
- `azoth_proof_status` — Proof status
- `azoth_active_rules` — Rules in force
- `azoth_data_flows` — Data flows
- `azoth_applicable_law` — Applicable law
- `azoth_regulatory_changes` — Regulatory changes
- `azoth_compliance_coverage` — Compliance coverage
- `azoth_evidence_summary` — This quarter's evidence
- `azoth_workspace_health` — Workspace health
- `azoth_footprint` — Energy and carbon
- `azoth_support_docs` — Search the documentation
- `azoth_support_changelog` — What changed in Azoth
- `azoth_support_status` — Service status
- `azoth_support_error` — Error code explained
- `azoth_journal_query` — Search the decision journal
- `azoth_evidence_export` — Evidence pack
- `azoth_export_dossier` — Export a verifiable dossier
- `azoth_system_modules` — System modules

## La clave de API

Créala en **Ajustes › Acceso**. Es preferible una clave personal, con el rol de lectura, una fecha de caducidad y solo los scopes que su perfil necesita:

```
public  insights:read journal:read usage:read
full    advisory:read agents:read insights:read journal:read policy:read usage:read
```

La mayoría de las herramientas del perfil público leen las funciones del propio panel: requieren el plan Starter o superior, y el asistente del espacio de trabajo activado (**Ajustes › Organización**). Una clave nunca recibe la dirección de correo electrónico de un miembro.

## Privacidad

- El servidor no guarda nada en tu ordenador y no envía telemetría.
- Cada llamada envía la clave y los argumentos de la herramienta a `AZOTH_API_URL` — el servicio de Azoth, o tu propio despliegue — y a nada más. La dirección debe usar HTTPS (HTTP simple solo en tu propio ordenador), y no se sigue ninguna redirección.
- Lo que devuelve una herramienta va a tu cliente MCP y al modelo que utiliza, según la política de privacidad de ese cliente: identificadores, códigos, recuentos, costes y los nombres que pusieron tus miembros — nunca la dirección de correo electrónico de un miembro.

Lo que Azoth conserva de estas llamadas se describe en su [política de privacidad](https://www.azothos.ai/legal/privacy).

## El conector remoto

El conector remoto no está activado en este despliegue.
