SDK y CLI
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/mcpes 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_preflightyazoth_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, conAZOTH_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_spendazoth_block_decisionsazoth_unmandated_usesazoth_mandates_overviewazoth_accountabilityazoth_journal_entryazoth_model_choiceazoth_proof_statusazoth_active_rulesazoth_data_flowsazoth_applicable_lawazoth_regulatory_changesazoth_compliance_coverageazoth_evidence_summaryazoth_workspace_healthazoth_footprintazoth_support_docsazoth_support_changelogazoth_support_statusazoth_support_errorazoth_journal_queryazoth_evidence_exportazoth_export_dossierazoth_system_modulesLa 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:readLa 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.
El conector remoto
El conector remoto no está activado en este despliegue.