> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> MCP を使って Craft を AI アシスタントや開発ツールと接続します。

Craft は MCP (Model Context Protocol) をサポートしており、Craft のドキュメントを外部ツールに安全に接続できます。これにより、互換性のあるアプリ（AI アシスタントや開発ツールを含む）が、あなたが共有することを選んだコンテンツを読み取り、操作できるようになります。

## MCP とは何ですか？

MCP (Model Context Protocol) は、外部アプリケーションが特定の情報ソースに接続できるようにする標準です。Craft では、MCP によりこれらのツールが選択したコンテンツへの制御されたアクセスを得られるため、安全に読み取り、処理、操作することができます。

MCP を有効にすると、外部ツールは次のことができます：

* Craft のドキュメントの内容を読み取る
* 要約、洞察、変換を生成する
* 執筆や構成の補助を行う
* ドキュメントをライブなナレッジソースとして利用する
* 選択したドキュメント内を検索する

これにより、手動でのエクスポートやコピー＆ペーストの必要がなくなります。

## Craft における MCP の仕組み

サイドバーの Imagine タブから **MCP 接続** を作成して、ワークスペースの共有したい部分を外部ツールと共有します。

選択できるのは次のいずれかです：

* **すべてのデイリーノート** を含む MCP 接続を作成する、または
* 特定のドキュメント（1 件以上）を選択する **カスタム接続** を設定する

各接続ではアクセス権と表示範囲を定義できるため、何が共有されるかを常にコントロールできます。接続を作成すると、Craft はその接続専用の **一意の MCP エンドポイント** を自動生成します。生成されたエンドポイントを MCP 対応ツールに追加すると、その接続で選んだドキュメントにのみ安全にアクセスでき、ワークスペースの他の部分はプライベートに保たれます。

<Info title="完全なスペースレベルアクセス（v3.3.5+）">
  Craft の MCP サーバーは現在、拡張機能を備えた **完全なスペースレベルのアクセス** をサポートしています：

  * フォルダ、タグ、日付フィルターで **すべてのドキュメント** を検索できます
  * **デイリーノート** と **タスク** へ MCP を通じて完全にアクセスできます
  * プログラムからドキュメントを **作成、更新、削除** できます
  * **コレクション管理**（スキーマの作成・編集を含む）
  * 正規表現対応やタイムゾーン認識の日付フィルターを備えた **高度な検索**
  * 再帰的なサブフォルダ対応を持つ **フォルダベースの整理**

  詳細は公式の MCP ドキュメントをご覧ください： [https://www.craft.do/imagine/](https://www.craft.do/imagine/)
</Info>

Craft で MCP 接続を作成したら、Imagine タブから生成された MCP リンクまたは認証情報をコピーします。次の手順は Craft の外部で行います。

使用する MCP 対応ツール（例：AI アシスタントや開発環境）を開き、MCP サーバーまたはコネクタを追加するオプションを見つけて、コピーした詳細を貼り付けます。その時点以降、そのツールは接続に含めたノートやドキュメントに対して、あなたが設定した権限に基づいてのみアクセスできるようになります。

## 対応する MCP 接続

現在、Craft は次の MCP 統合をサポートしています：

* **Claude**（Desktop と Claude Code）
* **ChatGPT**
* **Windsurf**
* **Cursor**
* **Visual Studio Code**
* **Raycast**
* **その他の標準的な MCP クライアント**

これらのツールは、あなたの Craft ドキュメントに直接接続して内容の読み取りや支援を行うことができます。

## MCP でできること

MCP を有効にすると、次のことが可能になります：

* AI アシスタントにドキュメントの分析や要約を依頼する
* Craft のドキュメントを元にコンテンツを生成・書き換える
* 開発ツールを使って Craft コンテンツを利用したカスタムワークフローやスクリプトを構築する
* VS Code、Cursor、Windsurf などのコーディング環境からドキュメントとやり取りする
* プログラムからドキュメントを検索・フィルタリングする
* 自身の MCP 対応ツールや自動化で Craft を拡張する

MCP により、Craft をお好みの AI や開発ツールとシームレスに連携できます。

## 完全なガイドとドキュメント

セットアップ手順や統合ガイドはすべて以下でご覧いただけます：

👉 [**https://www.craft.do/imagine/**](https://www.craft.do/imagine/)

ここには Claude、ChatGPT、その他サポートされている MCP ツール向けの専用ガイドがあります。

## トラブルシューティング

CraftとMCPクライアント（特にClaudeのように頻繁にアップデートされるツール）との間で接続の問題が発生した場合、以下の手順で問題が解決することがほとんどです：

<Steps>
  <Step title="再接続">
    クライアントアプリでMCPサーバーをいったん切断し、再接続を試みてください。
  </Step>

  <Step title="コネクタの再作成">
    再接続で解決しない場合は、クライアントアプリからMCPコネクタを削除し、同じリンクを使って再度セットアップしてください。
  </Step>

  <Step title="Craftでリンクを再作成">
    問題が解決しない場合は、CraftのImagineタブでMCP接続を削除し、新しい接続を作成してください。その後、新しいリンクをクライアントアプリに追加してください。
  </Step>
</Steps>

<Info>
  MCPクライアントの中には非常に頻繁にアップデートをリリースするものがあり、既存の接続が切断されることがあります。ほとんどの問題はこれらの手順で解決しますが、まれにクライアントアプリ側の修正を待つ必要がある場合もあります。
</Info>

<CardGroup cols={2}>
  <Card title="MCP セキュリティ" href="/ja/integrate/mcp/security">
    MCP のセキュリティ機能とアクセス制御について
  </Card>

  <Card title="ChatGPT の制限" href="/ja/integrate/mcp/chatgpt-limitations">
    MCP を使った ChatGPT 利用時の現在の制限事項を理解する
  </Card>
</CardGroup>
