AI アシスタント連携(MCP)
Claude Code や Codex から、Thoughtree のマップを読んだり編集したりする
Thoughtree Pro(Mac版)は Model Context Protocol(MCP)に対応しています。Claude Code や Codex など、自分で接続した AI アシスタントに、Thoughtree フォルダ内のマップを読み取らせたり、許可すればトピックの追加・整理をさせたりできます。
使うには
AI アシスタント連携は Thoughtree Pro の機能です(読み取りも含め、全体が Pro 限定です)。
- 設定 > AI アシスタント タブを開きます
- 「MCP サーバーを有効にする」をオンにします
- マップの追加・編集もさせたい場合は、その下の「エージェントによるマップの編集を許可」もオンにします(読み取りだけなら不要です)
- 「接続コマンド」欄の Claude Code/Codex それぞれの行にある「コピー」でコマンドをコピーし、ターミナルで実行して登録します(
claude mcp add thoughtree -- "…/thoughtree-mcp"の形)
Pro でない場合はトグルが無効になっており、代わりに「Pro にアップグレード…」ボタンが表示されます。
できること
「エージェントによるマップの編集を許可」がオフでも使えるのは読み取り系だけです。
| 読み取り系 | 書き込み系(編集の許可も必要) |
|---|---|
| マップの一覧を見る | 新しいマップを作る(最初に表示する階層の深さも指定できます) |
| マップの中身(アウトライン)を読む(大きなマップは一つの枝だけ・浅い階層だけに絞って読めます) | トピックを追加する |
| キーワードでトピックを探す | トピックを編集する(タイトル・メモ・リンク・タスク・折りたたみ) |
| 未完了のタスクを一覧する | トピックを移動する・削除する |
| テーマの一覧を見る | トピック同士に関連線を引く |
| マップを Thoughtree で前面に開く(トピックを選んだ状態にもできます) | テーマを適用する/マップや枝を画像として書き出す |
| マップ名を変更する/他形式のテキストから取り込む | |
| 変更履歴を見る・元に戻す |
トピックの編集・移動・削除のあとは、変更後のトピック(削除では残った兄弟)と、その親・兄弟の並びがその場で AI アシスタントに返ります。マップ全体を読み直さずに、続けて整理を進められます。
AI アシスタント側がプロンプトに対応していれば、「会話の要約をマップにする」という定型の指示も用意しています。それまでの会話を主要な枝と短いタイトルに整理し、詳細はメモに入れたマップを作って開きます。
アプリで開いているマップに書き込むとき
Thoughtree でそのマップを開いていて保存していない編集がある場合、AI アシスタントはまず Thoughtree に保存を頼み、保存が終わってから書き込みます(アプリは前面に出ません)。20 秒待っても保存されないときは、何も書き込まずにエラーを返します。
AI アシスタントの書き込みを Thoughtree が読み込んだあとは、Mac 標準の ⌘Z で読み込み前の状態に戻せます(「元に戻す」メニューには「外部の変更の読み込み」と表示されます)。戻した内容は通常どおり自動保存されます。
プライバシー
既定はオフです。有効にし、さらに AI アシスタント側にも接続コマンドを登録して初めて動きます。有効にすると、AI アシスタントが要求したマップの内容(トピックのテキスト・メモ・リンク・タスク情報など)は、お使いの Mac 上でその AI アシスタントに渡ります。渡した内容は、接続先の提供元(Anthropic、OpenAI など)のポリシーのもとで処理されます。Thoughtree 自身が内容を外部サーバーへ送信することはありません。編集を許可するかどうかは、読み取りとは別のスイッチです。AI アシスタントによる変更を取り消せるよう、変更前の内容は文書ごとに最大50件・7日間、端末内に保存されます。
うまくいかないときは
Thoughtree はサーバーが実際に接続中かどうかは表示しません(トグル自体が有効化の状態を示します)。
- コマンドが動かない場合は、設定 > AI アシスタント で「コピー」を押し直し、最新のコマンドで登録し直してください
- ツールが見えない・期待どおり使えない場合は、Thoughtree Pro の状態と2つのトグルの設定を確認してください
- 実行ファイルの場所は同じタブの「サーバーの場所」の「Finder に表示」で確認できます
