> ## 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

> 使用 Model Context Protocol 將 Craft 與 AI 助手及開發工具連接。

Craft 支援 MCP (Model Context Protocol)，可讓你安全地將 Craft 文件連接到外部工具。這使得相容的應用程式 – 包括 AI 助手與開發工具 – 能夠讀取並處理你選擇分享的內容。

## 什麼是 MCP？

MCP (Model Context Protocol) 是一項標準，允許外部應用程式連接到特定的訊息來源。在 Craft 中，MCP 讓這些工具對你所選內容擁有受控存取權，以便安全地讀取、處理並使用該內容。

啟用 MCP 後，外部工具可以：

* 讀取你 Craft 文件的內容
* 產生摘要、洞見或轉換結果
* 協助你撰寫或重構內容
* 將你的文件作為即時知識來源使用
* 在你選定的文件中進行搜尋

這免除了手動匯出或複製貼上的需要。

## MCP 在 Craft 中的運作方式

從側邊欄的 Imagine 標籤建立一個 **MCP 連線**，以將工作區中合適的部分分享給外部工具。

你可以選擇：

* 建立一個包含 **所有每日筆記** 的 MCP 連線，或
* 設定一個 **自訂連線**，由你挑選要包含的一個或多個文件

每個連線都可讓你定義存取權限與可見性，讓你掌控所分享的內容。建立後，Craft 會自動為該連線產生一個 **唯一的 MCP 端點**。你可以將此端點加入任何支援 MCP 的工具，讓該工具安全地連接到你選定的文件 – 同時保持工作區的其他內容私密。

<Info title="完整 空間 API 存取 (v3.3.5+)">
  Craft 的 MCP 伺服器現在支援 **完整空間級別存取**，具備進階功能：

  * **跨所有文件搜尋**，並支援資料夾、標籤與日期篩選
  * **每日筆記與任務** 可透過 MCP 完整存取
  * **以程式方式建立、更新與刪除** 文件
  * **集合管理**，包含建立與編輯結構（schema）
  * **進階搜尋**，支援正則表達式與時區感知的日期篩選
  * **以資料夾為基礎的組織**，支援遞迴子資料夾

  詳細資訊請參閱 [官方 MCP 文件](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 內容為基礎的自訂工作流程或腳本
* 從像是 Visual Studio 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="/zh-Hant/integrate/mcp/security">
    了解 MCP 的安全特性與存取控制
  </Card>

  <Card title="ChatGPT 限制" href="/zh-Hant/integrate/mcp/chatgpt-limitations">
    了解使用 MCP 與 ChatGPT 時的現有限制
  </Card>
</CardGroup>