Craft 官方 Cursor 插件 1.0.0基于 OAuth 的远程 MCP 服务器接入与知识库操作指南【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins本篇文章以third_party/craft插件的 CHANGELOG.md 为骨架结合同目录下的 README.md、mcp.json 与仓库级配置说明系统讲解该插件如何在 Cursor 中通过官方远程 MCP 服务器连接 Craft 空间实现文档、日常笔记、任务与集合的搜索、创建与更新。读完本文你将掌握该插件的安装方式、零 API Key 的 OAuth 鉴权流程、单空间作用域模型、多空间接入策略以及底层mcpServers配置的解析原理。一、插件定位Cursor 与 Craft 之间的 MCP 桥梁Craftcraft.do是一款面向文档、笔记与知识管理的协作产品。在plugins125/plugins仓库中third_party/craft是一个由 Cursor 官方维护的第三方集成插件其核心作用是把 Craft 的能力通过官方托管的远程 Model Context ProtocolMCP服务器暴露给 Cursor 内的 Agent。从仓库根目录的 README.md 插件清单可以看到该插件被归类为 Integrations集成市场描述为 “Search, create, and update documents and daily notes.”对应的 marketplace 注册条目位于 .cursor-plugin/marketplace.json{ name: craft, source: third_party/craft, description: Search, create, and update documents and daily notes. }source字段指向third_party/craft说明插件的全部内容清单、MCP 配置、文档都存放在该目录下。按照仓库结构规范一个完整插件目录应包含mcp.json、README.md、CHANGELOG.md与LICENSEthird_party/craft恰好齐备。二、版本 1.0.0 首发CHANGELOG 逐条解读CHANGELOG 记录了该插件的首个正式版本共包含三条关键变更逐条展开如下。2.1 新增指向 Craft 官方托管服务的craftMCP 服务器Added thecraftMCP server pointing athttps://mcp.craft.do/my/mcp.这是插件最核心的配置。所谓“远程 MCP 服务器”是指 MCP 端点以 HTTP(S) URL 形式托管在云端而非本地进程。插件通过type: http声明这一连接类型。仓库中的实际配置文件 mcp.json 内容如下{ mcpServers: { craft: { type: http, url: https://mcp.craft.do/my/mcp } } }该配置在 Cursor 的插件机制中会被合并进客户端的 MCP 服务器清单成为 Agent 可调用的一组工具。插件本身不包含任何本地代码工具的运行时由 Craft 官方托管服务提供。2.2 鉴权采用 OAuth无需配置 API Key 或 Client IDAuth uses OAuth — no API key or client ID to configure.与仓库内其他需要令牌的集成形成鲜明对比。例如 third_party/github/mcp.json 需要在headers中注入${GITHUB_PERSONAL_ACCESS_TOKEN}才能访问而 Craft 插件采用标准的 OAuth 授权码流程插件配置中没有任何密钥字段。用户在 Cursor 弹出授权界面时登录 Craft 并选择要授权的空间即可完成鉴权。这一设计显著降低了配置门槛也避免了令牌在配置文件中硬编码的安全风险。2.3 Logo 采用 Craft 官方标识Logo: Crafts official mark, from thecraftdocsGitHub organization.插件的品牌图标取自 Craft 官方组织发布的标识存放于 third_party/craft/assets/logo.png用于在 Cursor 插件市场中展示。这在仓库的第三方插件中属于标准做法同类插件如third_party/github、third_party/gmail也各自维护了assets/目录。三、安装与首次连接完整操作路径结合 README.md 的 Install 与 Before you connect 两节完整的接入流程分为三步。3.1 前置条件先在 Craft 应用中创建 MCP 连接README 特别强调了一个容易被忽略的前提必须在 Craft 应用侧先建立 MCP 连接否则端点不会授权。操作位置是 Craft 侧边栏的Connections连接区域。只有在 Craft 内存在该连接后Cursor 侧发起的 OAuth 授权请求才会被接受。这一步是后续一切操作的先决条件属于典型的“应用侧预授权”设计。3.2 在 Cursor 中安装插件两种方式任选其一打开Cursor Settings → Plugins搜索Craft点击Install随后完成 Craft 的登录授权提示在聊天窗口直接执行/add-plugin craft。安装完成后Cursor 会为插件建立 MCP 连接并在授权界面要求用户选择要授予访问权限的 Craft 空间。3.3 手动配置等价物mcpServers JSON如果希望在 Cursor 之外的其他 MCP 客户端中复用该连接README 提供了与插件内部配置一致的mcpServers片段即上文 mcp.json 中的内容。由于鉴权完全依赖 OAuth该片段无需任何凭据字段即可填入任意支持 HTTP 类型 MCP 的客户端。四、Agent 能力矩阵连接后可执行的操作README 的 “What agents can do” 一节给出了连接建立后 Agent 可用的能力分类整理如下分类能力说明Search搜索跨文档搜索支持标签tag、日期date与正则regex过滤条件Documents文档文档的创建、读取、更新与删除Daily notes tasks日常笔记与任务操作日常笔记与任务项Collections集合管理集合包括对集合结构schema的编辑需要特别说明的是工具的具体名称与参数模式以 Craft 官方托管运行时为准插件本身不定义工具清单——这是远程托管型 MCP 的典型特征服务端随版本演进即可更新工具能力客户端无需升级插件。README 明确指出 “The hosted runtime is the source of truth for tool names and schemas.”五、作用域模型与多空间接入策略这是该插件最值得深入理解的设计细节README 的 Notes 一节给出了三条明确规则。5.1 工具调用被限定在授权时选择的空间内OAuth 授权时选择的 Craft 空间决定了 Agent 所有工具调用的数据边界即搜索、读写都只作用于该空间不会跨越空间。5.2 端点为全局共享 URL空间隔离发生在授权层https://mcp.craft.do/my/mcp对所有人都是同一个地址空间隔离不体现在 URL 中而是由 OAuth 授权流程中的空间选择决定。这意味着该 URL 无法被用来推测或访问任何特定空间。5.3 一个连接绑定一个空间跨空间需多服务器条目由于一个连接只绑定一个空间若 Agent 需要操作多个 Craft 空间就需要在mcpServers中为每个空间增加一条独立的服务器条目每条仍指向同一 URL但分别走各自的 OAuth 授权与空间选择流程。这是实际部署中需要为每个空间重复一次授权操作的原因。此外 README 还专门提醒Packagist 上的stimmt/craft-mcp是一个无关的 CraftCMS插件与本仓库中面向 craft.do 知识库的 Cursor 插件不是同一产品避免在检索时混淆。六、仓库层面的配置校验与结构印证该插件在仓库中的合规性可以通过 scripts/validate-plugins.mjs 的校验逻辑得到印证。脚本会遍历 .cursor-plugin/marketplace.json 中的每个条目检查source指向的插件目录必须存在对应third_party/craft目录内必须包含.cursor-plugin/plugin.json清单且清单字段必须通过 schemas/plugin.schema.json 的 JSON Schema 校验marketplace 中的name必须与 plugin.json 中的name一致。对于mcpServers字段plugin.schema.json 允许其值为路径字符串、内联配置对象或二者组成的数组。third_party/craft采用内联对象形式把 MCP 配置直接写在 mcp.json 中——这是远程 HTTP 类第三方插件的标准组织方式与third_party/github、third_party/gmail等保持一致。七、许可与使用边界插件本身以 MIT 许可发布见 third_party/craft/LICENSE与仓库整体许可一致。使用过程中需要留意鉴权与数据访问完全依赖 Craft 官方托管的 MCP 服务插件只承担配置与 OAuth 桥接职责工具能力随官方运行时的演进而变化文档表格描述的是连接后能力的概要具体以授权后实际暴露的工具为准若遇到 Craft 侧的连接问题应先回到 3.1 节确认 Craft 应用内已创建 MCP 连接再排查 Cursor 侧的授权状态。结语third_party/craft插件 1.0.0 展示了远程托管型 MCP 集成的一种简洁范式一个 HTTP URL 加一套 OAuth 流程即可让 Cursor Agent 获得完整的文档、笔记、任务与集合操作能力免去了本地进程管理与密钥配置的负担。其单空间绑定的作用域模型既保证了数据安全边界也通过“一空间一服务器条目”的方式支持了多空间场景。对希望把 Craft 知识库接入 Cursor 工作流的开发者而言遵循“先建连接、再装插件、后选空间”的顺序即可顺利上手。【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考