# Configuration du connecteur MCP

SweetHive expose son API Agent Client sous forme de **serveur MCP**. Tout agent
compatible MCP — Claude Desktop, Claude Code, Cowork, les agents de type OpenClaw et
d'autres — se connecte avec un **jeton d'accès à portée limitée** que vous émettez
depuis SweetHive. Un serveur, un modèle de jeton, tous les clients.

D'abord, [créez un jeton](/fr/connect-an-agent/) dans
**Mes agents → Connecter un agent** et téléchargez le paquet de configuration (il
contient votre `endpoint` et votre `token`).

## Ce que votre agent obtient

| Outil | Rôle |
|---|---|
| `whoami` | la portée effective du jeton, sa capacité et son propriétaire |
| `contexts` | l'arborescence hive/contexte accordée |
| `items` | les éléments récents d'un contexte et de sa sous-arborescence |
| `search` | rechercher messages, notes et fichiers dans les contextes accordés |
| `post_message` | publier dans un contexte (jetons *Lecture + publication* uniquement ; la première publication demande votre confirmation) |
| `chat_pull` / `chat_reply` | la [discussion dans SweetHive](/fr/chat-with-your-agent/) avec vous |

## Configurer votre client

**Connecteur local (stdio)** — fonctionne aujourd'hui avec Claude Desktop, Claude
Code et tout client MCP stdio. Installez le connecteur SweetHive packagé, puis
ajoutez :

```json
{
  "mcpServers": {
    "sweethive": {
      "command": "node",
      "args": ["/absolute/path/to/sweethive-connector/dist/index.js"],
      "env": {
        "SWEETHIVE_ENDPOINT": "https://sweethive.com/server/web",
        "SWEETHIVE_TOKEN": "shv_..."
      }
    }
  }
}
```

**Distant (HTTP streamable)** — là où le point d'accès MCP hébergé est activé,
pointez votre client dessus avec le jeton comme identifiant Bearer :

```json
{
  "mcpServers": {
    "sweethive": {
      "url": "https://sweethive.com/mcp",
      "headers": { "Authorization": "Bearer shv_..." }
    }
  }
}
```

Votre agent peut maintenant répondre à des questions comme *« qu'est-ce qui a changé
dans le Projet A cette semaine ? »* ou *« rédige un point d'avancement pour le
DevGroup. »*

## Remarques

- **La capacité** (Lecture / Lecture + brouillon / Lecture + publication) est fixée
  sur le jeton ; la lecture seule est le défaut.
- **La révocation et les changements de groupes prennent effet immédiatement** — il
  n'y a pas de portée en cache. Une configuration divulguée expose une portée bornée
  et révocable, jamais les identifiants de votre compte.
- Le contenu entrant d'un agent externe est traité comme non fiable : il ne peut pas
  porter de mentions privilégiées ni invoquer les agents internes de SweetHive, et il
  est limité en débit par jeton.