主流IDE接入墨刀MCP实战：配置教程与常见问题排查

用AI编程工具的时候，IDE写代码很厉害，但对设计稿、原型和产品需求却没那么专业。光靠截图或者文字描述让模型生成页面，后面免不了来回改。现在很多人都开始把专业的产品设计能力接到支持 MCP 的 IDE 里，这样开发工具里就能直接生成原型、React 应用或者 PRD 文档了。
下面就拿** Cursor、Codex、WorkBuddy、QoderWork **这几个支持 MCP 的工具来说，讲一下我们在用的墨刀 MCP 怎么接入、怎么调用，以及可能会碰到哪些问题。
（本文配置参数参考墨刀官方教程）

一、墨刀 MCP 可以做什么

墨刀 MCP 接到 IDE 之后，能调用的能力主要有这几类：

能力	适用场景
通用生成	不确定应该生成原型、应用还是文档时使用
HTML 原型生成	生成活动页、后台页面、移动端页面等可预览原型
React 应用生成	生成可以继续查看、复制和二次开发的 React 应用
PRD 文档生成	根据产品想法生成结构化需求文档

生成的内容会自动存到你的墨刀个人空间，AI 工具这边也能拿到任务信息、预览链接或者生成的内容。有一说一，MCP 本身并不会改变模型的能力。它的作用就是让模型能去调用墨刀 AI，拿到生成结果。至于效果怎么样，还是得看需求描述、模型本身的能力，以及后面怎么调整。

二、连接前需要准备什么

配置之前，这几样东西得先备好：

一个能正常登录的墨刀账号；
一个支持 MCP 的 IDE 或 AI 编程工具；
客户端得支持 Streamable HTTP；
最好先确认一下你的客户端支不支持 OAuth MCP 授权。
墨刀 MCP 的服务地址是：https://modao.cc/agent-py/ai/mcp
推荐的服务名称是：modao
连接方式目前有两种：

OAuth 授权连接；
使用个人空间墨刀令牌手动连接。
优先推荐 OAuth，省事，不用把令牌往客户端配置里复制。

三、方式一：使用 OAuth 连接

如果你的 IDE 支持 OAuth MCP，配置步骤大概是这样：

1. 在 IDE 中添加 MCP 服务

在客户端的 MCP 设置中新增服务，填写：

服务名称：modao
类型：Streamable HTTP
服务器地址：https://modao.cc/agent-py/ai/mcp
鉴权方式：OAuth

不同 IDE 的入口位置可能不一样，不过配置项就这几个。

2. 完成授权

保存配置之后，客户端通常会打开墨刀的授权页面。登录正确的墨刀账号，确认授权，然后回到 IDE 查看连接状态。连接成功后，应该能看到 modao 服务以及它提供的工具。

3. 验证连接

可以先发个简单请求试试：“请检查墨刀 MCP 是否连接成功，并列出当前可调用的工具。”
客户端要是能返回工具列表，就说明 MCP 连接基本没问题了。

四、方式二：使用个人空间墨刀令牌

要是客户端不支持 OAuth，但支持自定义 Header，那就用令牌的方式。

1. 获取令牌

打开墨刀 AI，然后点击右上角头像-进入“令牌设置”-创建或查看个人空间墨刀令牌-保存令牌内容。
令牌别贴在截图、公开文章、代码仓库或者共享文档里。

2. 手动填写 MCP 配置

配置参数如下：

服务名称：modao
类型：Streamable HTTP
服务器地址：https://modao.cc/agent-py/ai/mcp
Header 名称：modao-token
Header 内容：你的个人空间墨刀令牌

如果客户端用 JSON 配置，可以参考下面的结构：

{
  "mcpServers": {
    "modao": {
      "url": "https://modao.cc/agent-py/ai/mcp",
      "headers": {
        "modao-token": "你的个人空间墨刀令牌"
      }
    }
  }
}

真实令牌最好放在本地环境变量或者客户端的安全配置里，别直接提交到 Git。配好之后，按客户端提示重启或者刷新一下 MCP 服务就行了。

五、也可以让 AI 帮忙配置

要是找不到当前 IDE 的 MCP 配置入口，试试把下面这段发给 IDE 里的 AI 助手：
text

请帮我在当前客户端中配置墨刀 MCP。

MCP 类型：Streamable HTTP
服务名称：modao
服务器地址：https://modao.cc/agent-py/ai/mcp
优先鉴权方式：OAuth 登录授权

如果当前客户端不支持 OAuth，请改用手动 Header：
Header 名称：modao-token
Header 内容：个人空间墨刀令牌

要求：
1. 先判断当前客户端是否支持 Streamable HTTP MCP 和 OAuth。
2. 如果支持 OAuth，优先使用 OAuth。
3. 如果不支持 OAuth，但支持自定义 Header，则使用 modao-token。
4. 不要修改已有的其他 MCP Server。
5. 如果需要修改配置文件，请告诉我文件路径和最终配置内容。
6. 配置完成后，告诉我是否需要重启客户端，以及如何验证连接。
7. 不要要求我把真实令牌发送到对话中。

有个细节：如果需要手动配置，让 AI 先用“个人空间墨刀令牌”当占位符，配完了自己在本地换成真实令牌。

六、连接成功后怎么调用

配置好了之后，直接在 IDE 对话框里提需求就行。
比如：

“用墨刀 AI 帮我生成一个 CRM 客户管理后台，包含客户列表、客户详情、筛选、分页和新增客户弹窗。”或者：“用墨刀 AI 生成一个移动端健身打卡 App 原型，包含首页、训练计划、打卡记录和个人中心。”
生成 PRD 的例子：
“请根据“面向团队的内部知识库”这个想法，使用墨刀 AI 生成一份结构化 PRD，包含用户角色、核心流程、功能列表、页面说明和验收标准。”
如果不太确定该用哪种能力，直接描述你想达到的效果：
“我想把这个需求做成一个可以预览的网页原型，请使用合适的墨刀 AI 能力完成。”

七、建议采用分阶段提示词

别一上来就指望 AI 给你搞定一个完整系统。更稳的做法是分阶段来。

第一步：先敲定产物类型

请先判断这个需求适合生成 HTML 原型、React 应用还是 PRD 文档，并说明判断理由。暂时不要开始生成。

第二步：补充页面和功能要求

请基于上面的需求，整理页面清单、用户流程、主要组件和交互状态。如果有无法确定的信息，请单独列出，不要自行假设。

第三步：开始生成

根据已经确认的页面和功能，使用墨刀 AI 生成一个可预览的 HTML 原型。要求包含正常状态、空状态、加载状态和错误状态。

第四步：继续修改

请在现有结果基础上修改：

增加顶部筛选栏；

将列表改为响应式布局；

增加新增客户弹窗；

保留现有页面结构和已有交互。
这么一步步来，比扔一句完整需求让 AI 生成更好控制，出了问题也更容易找到原因。

八、不同 IDE 的配置差异

墨刀 MCP 走的是标准 MCP 连接方式，不过不同客户端的配置界面差别还挺大的。像 Cursor、Codex、WorkBuddy、CodeBuddy、QoderWork、Windsurf，还有 VS Code 配上支持 MCP 的扩展，以及 Cline、Continue、Claude Code 这些，都在这个范围里。
这里有两个概念要区分清楚：

客户端是否支持 MCP；
客户端是否支持 Streamable HTTP 和 OAuth。
有的工具虽然支持 MCP，但只认本地命令启动的 Server；还有的支持远程 MCP，但不支持 OAuth，只能靠自定义 Header 传令牌。
所以碰到配置问题的时候，别只看“支不支持 MCP”，得确认下面三个能力：
MCP
Streamable HTTP
OAuth 或自定义 Header

九、常见问题

1. 显示已连接，但 AI 不调用墨刀工具

可以排查一下这几个方面：当前模型支持工具调用吗？MCP 服务确实把工具暴露出来了吗？是不是只连上了但没刷新工具列表？提示词里有没有明确说要用墨刀 AI？可以直接测试一下：“请使用 modao MCP 生成一个简单的登录页 HTML 原型。”

2. OAuth 授权失败

重点看看这几项：登录的墨刀账号对不对？客户端到底支不支持 OAuth MCP？服务地址填对了没有？授权窗口是不是被浏览器拦了？需不需要重启客户端重新连一下？如果客户端本身不支持 OAuth，就改用手动令牌方式。

3. 提示 Token 无效

检查一遍：令牌完整复制了吗？Header 名称写的是 modao-token 吗？Header 内容有没有忘了改成真实令牌？令牌是不是被删掉或者重新生成过了？配置改完有没有重启或刷新 MCP 服务？

4. 生成失败或没有结果

按顺序排查吧：

墨刀账号能不能正常登录；
个人空间还有没有可用积分或权益；
MCP 配置有没有保存；
客户端有没有重启；
服务地址填得对不对；
看看客户端日志里有没有具体的报错信息。
墨刀 MCP 通过个人空间令牌识别账号，生成能力和权益跟墨刀 AI 页面里的账号是一致的。

十、安全注意事项

MCP 配置里面，最需要注意的就是令牌安全。
这几条尽量注意一下：

别把真实令牌发给不可信的网页 AI；
别把令牌提交到 Git 仓库；
别把带令牌的配置文件发到群聊；
别把令牌放到前端代码里；
如果觉得令牌可能泄露了，赶紧删掉重新生成；
企业项目接入前，先确认设计稿和需求内容是否允许发给第三方模型服务。
用 OAuth 更稳妥一些，或者在本地配置文件里存令牌，让 AI 只管生成配置结构就行。

十一、总结

IDE 接入墨刀 MCP 之后，开发者可以直接在代码编辑器里调用墨刀 AI，生成 HTML 原型、React 应用和 PRD 文档。比较适合这么几种情况：

根据产品想法快速生成页面原型；
开发前先验证页面结构；
生成 React 页面作为二次开发的起点；
根据需求草稿整理 PRD；
在 IDE 里连续修改和迭代生成结果。
但这不是说产品、设计、开发这些环节就能省了。复杂业务还是得人工去确认页面结构、交互逻辑、权限规则和具体实现方式。
墨刀 MCP 的价值就是让支持 MCP 的 IDE 能直接调用墨刀 AI，把原型生成、应用生成、文档生成这些能力接到现有的开发流程里。想要用得顺手，还是得在提示词、分阶段生成、权限控制和代码审查这几个方面多下点功夫。

注：文中部分文字配图由AI生成

posted @ 2026-08-25 10:34 PMEcho 阅读(9) 评论(0) 收藏举报

刷新页面返回顶部

PMEcho