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

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

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

在此您将找到针对 Claude、ChatGPT 以及其他受支持 MCP 工具的专门指南。

​

故障排除

如果您遇到 Craft 与 MCP 客户端之间的连接问题（尤其是在使用 Claude 等频繁更新的工具时），以下步骤通常可以解决问题：

1. 重新连接

   尝试在您的客户端应用中断开并重新连接 MCP 服务器。

2. 重新创建连接器

   如果重新连接没有帮助，请从您的客户端应用中移除 MCP 连接器，然后使用相同的链接重新设置。

3. 在 Craft 中重新创建链接

   如果问题仍然存在，请在 Craft 的 Imagine 标签页中删除 MCP 连接并创建一个新连接，然后将新链接添加到您的客户端应用中。

部分 MCP 客户端更新非常频繁，这有时会导致现有连接中断。上述步骤可解决大多数问题，但在极少数情况下，您可能需要等待客户端应用发布修复程序。

MCP 安全

了解 MCP 的安全功能和访问控制

ChatGPT 限制

了解在使用 MCP 与 ChatGPT 时的当前限制