墨刀AI活动横幅 墨刀活动入口箭头
服务在线 · Streamable HTTP

墨刀 AI MCP

把墨刀 AI 的原型、React 应用和 PRD 生成等能力接入 Codex、Claude Code、WorkBuddy、Qoder 与 TRAE 等常用软件。在当前对话里说清需求，就能获得可预览、可分享、可继续推进的结果。

  • 个人空间统一管理
  • 支持 OAuth 与个人令牌
  • 生成状态随时可查
选择工具接入 查看可用能力
复制这句话，发给您的 AGENT 即可自动化安装 安装与验证会消耗您所使用 AGENT 工具自身的 Token 用量

参考 https://modao.cc/feature/ai-mcp.html 帮我安装墨刀AI MCP。

modao 已连接
你的需求

生成一个移动端用户访谈预约原型，包含场次选择、信息填写和预约确认，并导入墨刀继续编辑。

  1. 1 调用 generate_html 生成三页原型 已创建
  2. 2 调用 get_task_result 查询产物 已完成
  3. 3 调用 import_to_proto 导入墨刀 可编辑
在线预览 任务链接 可编辑原型
接入指南

选一个你正在用的工具，按对应方式接入

五个客户端使用同一个 Streamable HTTP 地址，区别只在配置入口。下面以兼容范围更广的个人空间令牌为例。

准备工作

先获取个人空间令牌

登录墨刀 AI，从头像菜单进入“令牌设置”，创建并复制令牌。支持 OAuth 的客户端也可以按界面提示完成登录授权；下方 Token 配置可覆盖所有列出的工具。

获取个人空间令牌
令牌设置入口 墨刀 AI · 个人空间
从墨刀 AI 头像菜单进入令牌设置
推荐 · 用户级 配置文件

在 Codex 中接入

Codex CLI、IDE 扩展和桌面端共享同一套 MCP 配置。

  1. 1
    在启动 Codex 的环境中设置 MODAO_TOKEN。
  2. 2
    打开 ~/.codex/config.toml，粘贴右侧配置。
  3. 3
    重启 Codex，并检查 MCP 服务状态。
查看 Codex 官方 MCP 文档
~/.codex/config.toml 
[mcp_servers.modao]
url = "https://modao.cc/agent-py/ai/mcp"
env_http_headers = { "modao-token" = "MODAO_TOKEN" }
验证：运行 codex mcp list，或在会话中输入 /mcp。
请把 Token 当作账号凭证保管。优先使用用户级、本机配置，不要把真实 Token 发到对话、截图或提交到 Git；不再使用时可在墨刀“令牌设置”中删除。
工作方式

把墨刀AI带进你的AI工作流

墨刀 AI MCP 负责连接、生成和结果回收。你只需要在熟悉的 AI 工具里描述目标，不必在多个产品之间反复复制上下文。

01

留在当前工具中发起生成

无需切换到新的工作台。在正在使用的 Codex、Claude Code 或其他 MCP 客户端里，直接说明页面、流程和交付目标。

02

从需求得到明确产物

按任务选择 HTML 原型、React 应用或 PRD 文档。返回内容包含任务状态、预览入口和对应产物，不止是一段建议。

03

结果自动沉淀到墨刀

任务归属于令牌绑定的个人空间，历史结果和权益状态沿用墨刀账号体系，方便后续查看、分享与继续协作。

核心能力

从PRD、原型到应用，按目标调用合适的工具

可以明确指定产物类型，也可以让墨刀 AI 根据需求选择生成方式。

HTML 原型

generate_html

生成可直接预览的 HTML 产品原型，适合快速确认信息架构、页面布局和关键交互。

React 应用

generate_react

生成带交互的 React 应用或高保真原型，便于查看实现效果并继续推进代码。

PRD 文档

generate_prd

把产品想法整理为结构化 PRD，返回 Markdown 内容、文件信息和任务入口。

自动选择

generate

不确定该选哪种产物时，直接描述目标，由墨刀 AI 选择合适的生成方式。

任务辅助能力 get_account_status 校验账号与权益 get_task_result 查询生成状态与结果 import_to_proto 导入墨刀继续编辑
开始使用

连接成功后，直接用自然语言交付任务

说清产品类型、目标用户、核心页面和期望产物，墨刀 AI 会选择对应工具。

生成 HTML 原型
“使用墨刀 AI，生成一个 CRM 客户管理后台原型，包含客户列表、详情、跟进记录和新建客户流程。”
在线预览·任务链接·HTML
生成 React 应用
“用墨刀 AI 做一个移动端健身打卡应用，包含训练计划、打卡日历、数据统计和个人中心。”
交互预览·任务链接·React
生成 PRD
“用墨刀 AI 写一份会员积分系统 PRD，覆盖积分获取、消耗、过期、等级权益和异常处理规则。”
结构化文档·文件列表·Markdown
常见问题

接入前后常见的问题

为什么现在使用远程 HTTP，而不是旧教程里的 npx？

当前推荐地址是 https://modao.cc/agent-py/ai/mcp，使用 Streamable HTTP 直连墨刀线上服务，不需要在本机安装或维护旧版 stdio 包。旧教程中的 @modao-mcp/modao-proto-mcp 不应再作为新用户的主接入方式。

个人空间令牌应该怎样保管？

Token 等同于账号访问凭证，只保存在可信的本机用户级配置中。不要提交到代码仓库、共享文档或截图；怀疑泄露时，立即在墨刀“令牌设置”中删除并重新创建。

连接后看不到工具，应该检查什么？

依次确认服务地址完整、传输类型为 HTTP/Streamable HTTP、Header 名称严格为 modao-token、Token 仍然有效。然后刷新 MCP 列表或重启客户端，并查看客户端给出的连接日志。

生成结果会保存在哪里？

调用归属于 Token 绑定的墨刀个人空间。生成完成后会返回任务信息、预览入口和对应产物，方便在客户端查看，也可以回到墨刀继续管理和分享。

MCP 调用会消耗墨刀 AI 权益吗？

会。MCP 复用墨刀线上生成链路，任务消耗遵循当前墨刀账号的权益和计费规则。可以先通过账号状态工具确认可用权益。

其他 MCP 客户端也能接入吗？

可以。只要客户端支持 Streamable HTTP，并能添加自定义请求 Header，就可以使用同一服务地址和 modao-token 接入。具体配置字段以客户端官方文档为准。

获取个人空间令牌，选择一个客户端完成配置，就可以直接调用墨刀 AI。

获取个人空间令牌 查看接入方式
可用能力 使用示例 常见问题 完整配置教程
已复制