> ## 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 完全访问每日笔记和任务
  * 以编程方式创建、更新和删除文档
  * 集合管理，包括模式的创建与编辑
  * 高级搜索，支持正则表达式和时区感知的日期筛选
  * 基于文件夹的组织方式，支持递归子文件夹

  请查阅官方 MCP 文档 ([https://www.craft.do/imagine/](https://www.craft.do/imagine/)) 以获取完整详细信息。
</Info>

在 Craft 中创建 MCP 连接后，请从 Imagine 选项卡复制生成的 MCP 链接或凭据。后续步骤将在 Craft 之外进行。

打开你要使用的兼容 MCP 的工具（例如 AI 助手或开发环境），找到添加 MCP 服务器或连接器的选项，并粘贴你复制的信息。从此，该工具将仅根据你设置的权限访问该连接中包含的笔记或文档。

## 支持的 MCP 连接

Craft 目前支持与以下服务的 MCP 集成：

* **Claude**（桌面版与 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="/zh-Hans/integrate/mcp/security">
    了解 MCP 的安全功能和访问控制
  </Card>

  <Card title="ChatGPT 限制" href="/zh-Hans/integrate/mcp/chatgpt-limitations">
    了解在使用 MCP 与 ChatGPT 时的当前限制
  </Card>
</CardGroup>