Agent からドキュメントを安全に操作

仕組み

通常のドキュメントツールのモデル機能は Agent 側が提供します。Koinote は認証、ツール、競合検出、監査を担当し、GEO 要約の生成時だけ設定済みの内蔵モデルまたは BYOK チャネルを呼び出します。Feishu を連携すると、書き込みトークンで sync_document_to_feishu を呼び出し、Feishu ドキュメントを作成または更新できます。

準備

• 永久会員を有効化 — MCP は永久会員向け機能です。
• 個人トークンを作成 — 読み取り専用、読み書き、または公開専用の権限と、期限付きまたは無期限を選びます。
• クライアントを設定 — 下記の方法で https://koinote.app/mcp に接続します。

各 Agent の接続方法

トークンはアカウントの認証情報です。環境変数か安全な保存領域に置き、リポジトリへコミットしないでください。

• ~/.codex/config.toml にリモート MCP を登録し、環境変数からトークンを読み込んで Codex を再起動します。
• Claude Code CLI で HTTP MCP と Bearer 認証ヘッダーを追加します。
• opencode.json に remote MCP を定義し、環境変数からヘッダーを渡します。
• OpenClaw CLI で Streamable HTTP サーバーを登録し、doctor で確認します。
• WorkBuddy などは Streamable HTTP と Authorization ヘッダーを設定できれば接続できます。

Agent からの使い方

特別な構文は不要です。Koinote を操作すると伝えれば Agent が MCP ツールを選びます。Feishu 連携後は sync_document_to_feishu を呼び出して Koinote から Feishu へ一方向同期できます。置換やゴミ箱操作では対象文書と結果を明確にしてください。公開専用トークンでは、指定した文書を連携済み WeChat 公式アカウントの下書きへ送るほか、GEO 要約の生成・管理も依頼できます。送信時に GEO を含めることを明示してください。

設定後に試せるプロンプト

• Koinote で最近更新した 5 件のドキュメントを一覧にして。
• リモートワークの記事を書いて Koinote に保存して。
• 「リリースチェックリスト」を探して振り返りの節を追記して。
• 「古い下書き」を完全削除せずゴミ箱へ移して。

権限と削除の境界

• 読み取り専用トークンは一覧、検索、本文と履歴の閲覧ができます。
• 読み書きトークンは作成、追記、更新、履歴復元、ゴミ箱への移動と復元ができます。Feishu 連携後は sync_document_to_feishu で Feishu ドキュメントを作成・更新できます。
• 公開専用トークンは文書を読み取り、push_wechat_draft で公式アカウントの下書きを作成できますが、Koinote 文書の変更・削除はできません。
• 読み書きと公開専用トークンは WeChat GEO 要約を生成・管理できます。内蔵モデルの生成は credits を消費し、下書きには明示しない限り含まれません。
• Agent は完全削除できません。完全削除は Web のゴミ箱で確認が必要です。
• トークンは個別に失効でき、期限切れや会員失効時には直ちに使えなくなります。