# AI アシスタント連携（MCP） (/ja/docs/guide/ai-assistant)



Thoughtree Pro（Mac版）は Model Context Protocol（MCP）に対応しています。Claude Code や Codex など、自分で接続した AI アシスタントに、Thoughtree フォルダ内のマップを読み取らせたり、許可すればトピックの追加・整理をさせたりできます。

## 使うには [#使うには]

AI アシスタント連携は Thoughtree Pro の機能です（読み取りも含め、全体が Pro 限定です）。

1. **設定 > AI アシスタント** タブを開きます
2. 「MCP サーバーを有効にする」をオンにします
3. マップの追加・編集もさせたい場合は、その下の「エージェントによるマップの編集を許可」もオンにします（読み取りだけなら不要です）
4. 「接続コマンド」欄の Claude Code／Codex それぞれの行にある「コピー」でコマンドをコピーし、ターミナルで実行して登録します（`claude mcp add thoughtree -- "…/thoughtree-mcp"` の形）

Pro でない場合はトグルが無効になっており、代わりに「Pro にアップグレード…」ボタンが表示されます。

## できること [#できること]

「エージェントによるマップの編集を許可」がオフでも使えるのは読み取り系だけです。

| 読み取り系             | 書き込み系（編集の許可も必要）            |
| ----------------- | -------------------------- |
| マップの一覧を見る         | 新しいマップを作る                  |
| マップの中身（アウトライン）を読む | トピックを追加する                  |
| キーワードでトピックを探す     | トピックを編集する（タイトル・メモ・リンク・タスク） |
| 未完了のタスクを一覧する      | トピックを移動する・削除する             |
| テーマの一覧を見る         | テーマを適用する／マップを画像として書き出す     |
|                   | マップ名を変更する／他形式のテキストから取り込む   |
|                   | 変更履歴を見る・元に戻す               |

## プライバシー [#プライバシー]

既定は**オフ**です。有効にし、さらに AI アシスタント側にも接続コマンドを登録して初めて動きます。有効にすると、AI アシスタントが要求したマップの内容（トピックのテキスト・メモ・リンク・タスク情報など）は、お使いの Mac 上でその AI アシスタントに渡ります。渡した内容は、接続先の提供元（Anthropic、OpenAI など）のポリシーのもとで処理されます。Thoughtree 自身が内容を外部サーバーへ送信することはありません。編集を許可するかどうかは、読み取りとは別のスイッチです。AI アシスタントによる変更を取り消せるよう、変更前の内容は文書ごとに最大50件・7日間、端末内に保存されます。

## うまくいかないときは [#うまくいかないときは]

Thoughtree はサーバーが実際に接続中かどうかは表示しません（トグル自体が有効化の状態を示します）。

* コマンドが動かない場合は、**設定 > AI アシスタント** で「コピー」を押し直し、最新のコマンドで登録し直してください
* ツールが見えない・期待どおり使えない場合は、Thoughtree Pro の状態と2つのトグルの設定を確認してください
* 実行ファイルの場所は同じタブの「サーバーの場所」の「Finder に表示」で確認できます

<img src="/screenshots/ai-assistant-mac-ja.png" alt="Mac の設定 > AI アシスタントタブ。MCPサーバーの有効化トグル、編集許可トグル、Claude Code・Codex 向けの接続コマンドが表示されている" />