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 的工具，讓該工具安全地連接到你選定的文件 – 同時保持工作區的其他內容私密。

Craft 的 MCP 伺服器現在支援 完整空間級別存取，具備進階功能：

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

詳細資訊請參閱 官方 MCP 文件。

在 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/

在那裡你會找到針對 Claude、ChatGPT 與其他受支援 MCP 工具的專屬指南。

​

疑難排解

如果您遇到 Craft 與 MCP 客戶端之間的連線問題（尤其是使用 Claude 等頻繁更新的工具），以下步驟通常可以解決問題：

1. 重新連線

   嘗試在您的客戶端應用程式中中斷連線並重新連接 MCP 伺服器。

2. 重新建立連接器

   如果重新連線無效，請從您的客戶端應用程式中移除 MCP 連接器，然後使用相同的連結重新設定。

3. 在 Craft 中重新建立連結

   如果問題持續存在，請刪除 Craft「Imagine」標籤中的 MCP 連線並建立新的連線，然後將新連結新增至您的客戶端應用程式。

部分 MCP 客戶端的更新頻率非常高，偶爾可能導致現有連線中斷。上述步驟可解決大多數問題，但在極少數情況下，您可能需要等待客戶端應用程式提供修復程式。

MCP 安全性

了解 MCP 的安全特性與存取控制

ChatGPT 限制

了解使用 MCP 與 ChatGPT 時的現有限制