SDK et CLI
MCP
Deux choses différentes : une passerelle MCP gouvernée par laquelle vos agents appellent leurs outils, et un serveur MCP qui permet à un assistant de lire votre espace de travail.
La passerelle MCP gouvernée
- Un seul point d’accès,
POST /api/v1/mcp, pour tout client MCP standard (Streamable HTTP), avec une clé liée à un agent, créée dans Agents › Outils MCP. - Un propriétaire ou administrateur tient le catalogue : les serveurs, la façon dont Azoth s’y authentifie — secrets chiffrés, jamais envoyés à un agent — et la revue de chaque outil avec sa réversibilité. Seuls les outils approuvés sont exposés, et une définition modifiée retourne en revue.
- Chaque appel d’outil passe par le mandat de l’agent et par Azoth Guard ; un appel irréversible ou financier attend l’approbation d’une personne. Les résultats sont analysés et marqués non fiables. Aucun argument ni aucun résultat n’est conservé : l’appel est scellé avec des codes et une empreinte.
- Seulement des outils pour l’instant : les ressources, les prompts et l’échantillonnage ne sont pas proposés. La passerelle est désactivée tant que le déploiement ne l’active pas (
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)Le serveur MCP Azoth
@azothos/mcpest un serveur MCP sans dépendance, open source sous licence Apache-2.0 : il tourne sur votre ordinateur avec Node.js 18 ou plus récent, sur stdio, et lit votre espace de travail avec une clé d’API.- Ses outils renvoient les chiffres mêmes du tableau de bord : les mandats et qui répond d’une décision, les règles en vigueur, les décisions bloquantes, le droit applicable, la couverture de conformité, l’état de la preuve, les dépenses et l’empreinte, et les sources du support.
- Chaque outil lit, sauf ceux dont les annotations disent qu’ils enregistrent quelque chose :
azoth_export_dossier— chaque export est ancré, horodaté et scellé, comme depuis Preuves › Dossiers — et, dans le profil complet,azoth_preflightetazoth_compress. Les brouillons de l’assistant ne sont pas proposés : un brouillon exige qu’une personne le confirme sur son écran.
Installation
Le serveur n’est pas encore publié : son paquet npm et son extension Claude Desktop seront liés ici dès qu’ils le seront.
Profils
public, par défaut : les mandats, les règles, la preuve, les dépenses et les sources du support — les outils ci-dessous.full, avecAZOTH_MCP_PROFILE=full(l’interrupteur Full profile de l’extension) : en plus, les outils d’optimisation et FinOps, les outils des fonctions qu’un déploiement active, et les anciens noms d’outils, conservés une version.- Un outil hors du profil n’est pas listé, et un appel à cet outil est refusé en nommant le profil qui le propose.
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 clé d’API
Créez-la dans Réglages › Accès. Préférez une clé personnelle, avec le rôle lecture, une date d’expiration et seulement les scopes dont son profil a besoin :
public insights:read journal:read usage:read
full advisory:read agents:read insights:read journal:read policy:read usage:readLa plupart des outils du profil public lisent les fonctions mêmes du tableau de bord : ils demandent l’offre Starter ou supérieure, et l’assistant de l’espace de travail activé (Réglages › Organisation). Une clé ne reçoit jamais l’adresse e-mail d’un membre.
Confidentialité
- Le serveur ne garde rien sur votre ordinateur et n’envoie aucune télémétrie.
- Chaque appel envoie la clé et les arguments de l’outil à
AZOTH_API_URL— le service d’Azoth, ou votre propre déploiement — et à rien d’autre. L’adresse doit utiliser HTTPS (HTTP simple seulement sur votre propre ordinateur), et aucune redirection n’est suivie. - Ce qu’un outil renvoie va à votre client MCP et au modèle qu’il utilise, selon la politique de confidentialité de ce client : des identifiants, des codes, des comptes, des coûts et les noms donnés par vos membres — jamais l’adresse e-mail d’un membre.
Ce qu’Azoth conserve de ces appels est décrit dans sa politique de confidentialité.
Le connecteur distant
Le connecteur distant n’est pas activé sur ce déploiement.