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 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 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 :
{
"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 :
{
"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.