# 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/mcp` est 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_preflight` et `azoth_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`, avec `AZOTH_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_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 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:read
```

La 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é](https://www.azothos.ai/legal/privacy).

## Le connecteur distant

Le connecteur distant n’est pas activé sur ce déploiement.
