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.