Guide d’intégration MCP
Autorisez vos agents à travailler avec vos documents
Connectez Codex, Claude Code, OpenCode, OpenClaw ou tout client MCP Streamable HTTP compatible à Koinote.
Fonctionnement
Pour les outils documentaires habituels, le modèle est fourni par votre agent. Koinote gère l’autorisation, les outils, les conflits et l’audit ; la génération d’un résumé GEO peut appeler le modèle intégré ou votre canal BYOK configuré. Après avoir lié Feishu, un jeton d’écriture peut aussi appeler sync_document_to_feishu pour créer ou mettre à jour un document Feishu.
Avant de commencer
- Activez l’offre à vie — MCP est un avantage de l’offre à vie.
- Créez un jeton — Choisissez lecture seule, lecture-écriture ou publication seule, avec une durée limitée ou permanente.
- Configurez le client — Utilisez la méthode correspondante pour https://koinote.app/mcp.
Connexion des agents
Un jeton est un identifiant de compte. Gardez-le dans une variable d’environnement ou un stockage sécurisé, jamais dans Git.
- Déclarez le MCP dans ~/.codex/config.toml, lisez le jeton depuis l’environnement, puis redémarrez Codex.
- Ajoutez le serveur HTTP et son en-tête Bearer avec la CLI Claude Code.
- Déclarez un MCP remote dans opencode.json et injectez l’en-tête depuis l’environnement.
- Enregistrez le serveur avec la CLI OpenClaw, puis vérifiez-le avec doctor.
- WorkBuddy et les autres clients doivent accepter Streamable HTTP et un en-tête Authorization.
Utilisation depuis un agent
Aucune syntaxe spéciale n’est requise. Demandez simplement à l’agent d’utiliser Koinote et précisez le document pour les remplacements ou la corbeille. Après avoir lié Feishu, demandez-lui d’appeler sync_document_to_feishu pour effectuer une synchronisation à sens unique de Koinote vers Feishu. Avec un jeton de publication seule, demandez à l’agent d’envoyer un document nommé vers les brouillons du compte WeChat lié ou de générer et gérer son résumé GEO ; demandez explicitement l’inclusion du GEO lors de l’envoi.
Exemples à essayer
- Liste mes cinq documents Koinote modifiés le plus récemment.
- Rédige un article sur le travail à distance et enregistre-le dans Koinote.
- Trouve « Checklist de lancement » et ajoute une section de bilan.
- Place « Ancien brouillon » dans la corbeille sans suppression définitive.
Permissions et suppression
- Les jetons en lecture seule peuvent lister, rechercher et lire les documents et l’historique.
- Les jetons en écriture peuvent créer, ajouter, mettre à jour, restaurer et gérer la corbeille ; après liaison de Feishu, ils peuvent aussi appeler sync_document_to_feishu pour créer ou mettre à jour un document Feishu.
- Les jetons de publication seule peuvent lire les documents et appeler push_wechat_draft pour créer un brouillon WeChat, sans modifier ni supprimer les documents Koinote.
- Les jetons d’écriture et de publication seule peuvent générer ou gérer un résumé GEO WeChat ; le modèle intégré consomme des credits et les brouillons l’omettront sauf demande explicite.
- Un agent ne peut pas supprimer définitivement un document ; cette action reste dans l’interface web.
- Chaque jeton peut être révoqué et cesse de fonctionner à son expiration ou à la fin de l’adhésion.