読み取りから反映まで、ひとつの接続先で。
キーに付けた権限のないツールは、エージェントに見えません。
- 全体をつかむ
tooon_capabilities で、使える操作と取得できない範囲を最初に確かめる。
- 業務の一覧
プロジェクト・タスク・取引先・パートナーなどを、続きがなくなるまで取得する。
- ページとデータベース
本文、参照ブロック、データベースの項目と行を読み取る。
- 関係をたどる
表示位置、プロジェクト、参照元、添付ファイルから、つながりを補う。
- ユニットの表示
サイドバーのユニットと、その中に表示されるプロジェクトを確かめる。
- 変更案と反映書き込み権限
tooon_preview_change で変更案を作り、確かめた案だけを tooon_apply_change で反映する。
まず、全体を 読み取る。
読み取りだけのキーでつなげば、エージェントはプロジェクト・タスク・取引先・ページを最後までたどります。取得できなかった一覧や権限のない範囲は、0件と区別して残します。
同じ名前と、同じものを 見分けて図にする。
IDと参照関係をそのまま渡すので、エージェントは親子・参照・表示位置を別の線にして図にできます。同じページが2つのユニットにあっても、重複とは数えません。
変更案を見てから、 反映する。
エージェントは、変更の前に必ず変更案を作ります。対象と変更前後を確かめて反映すると、その時点の権限と更新状況をもう一度確かめてから保存します。変更案の有効期限は5分。ほかの人が先に更新していたら、新しい状態で作り直します。
書き込み権限人が決めることは、 画面に残す。
MCPから作成・更新できるのは、プロジェクト・タスク・取引先だけです。削除、ページの移動や統合、請求や支払い、公開、外部への送信はできません。どれを統合するか提案はできても、自動で統合はしません。
Codexでも、 Claude Codeでも。
接続先はワークスペースごとに1つ。CodexとClaude Codeの設定例は接続ガイドにあります。キーは起動する環境の変数で渡し、設定ファイルやチャットには書きません。
3つの手順で、つながる。
- 1Solo以上のプランにする
MCPは、Solo・Pro・Businessのワークスペースで使えます。
- 2用途別のAPIキーを発行する
管理者が「設定 → 連携」で発行。棚卸しなら読み取りの権限だけを選びます。
- 3エージェントに設定する
接続ガイドの設定例のワークスペースIDを置き換え、キーを環境変数で渡します。