2026年1月更新: 我们简化了 MCP 集成!新的 npm 包
flowzap-mcp取代了旧的复杂 MCP 服务器。一条命令安装,无需认证。
🚀 推荐的新方法:npm 包
Claude Desktop
在 claude_desktop_config.json 中添加:
{
"mcpServers": {
"flowzap": {
"command": "npx",
"args": ["-y", "flowzap-mcp"]
}
}
}
配置文件位置:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Cursor
在 Cursor MCP 设置中添加相同配置。
Windsurf IDE
添加到 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"flowzap": {
"command": "npx",
"args": ["-y", "flowzap-mcp"]
}
}
}
Windows 用户: 如果工具未在 Cascade 中显示,请使用绝对路径:
{ "mcpServers": { "flowzap": { "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": ["-y", "flowzap-mcp"] } } }使用以下命令查找 npx 路径:
where.exe npx
Comet 浏览器 / 其他 AI 助手
Comet 和类似的 AI 浏览器不直接支持自定义 MCP 服务器。它们可以:
- 生成 FlowZap Code 使用 flowzap.xyz/flowzap-code 上的语法文档
- 创建 playground URL 通过公共 API:
curl -X POST https://flowzap.xyz/api/playground/create \ -H "Content-Type: application/json" \ -d '{"code": "sales { n1: circle label:\"Start\" }"}'
可用工具
| 工具 | 描述 |
|------|------|
| flowzap_validate | 验证 FlowZap Code 语法 |
| flowzap_create_playground | 创建可分享的图表 URL |
| flowzap_get_syntax | 获取语法文档 |
使用示例
向你的 AI 助手提问:
- "为订单处理系统创建一个工作流图"
- "制作一个显示用户注册流程的流程图"
- "画一个包含构建、测试和部署阶段的 CI/CD 流水线图"
助手会:
- 根据你的描述生成 FlowZap Code
- 验证代码
- 创建一个你可以查看和分享的 playground URL
安全性
- 无需认证 — 仅使用 FlowZap 公共 API
- 无用户数据访问 — 无法读取你的图表或账户
- 本地运行 — MCP 服务器在你的机器上运行
- SSRF 防护 — 仅连接到 flowzap.xyz
公共 API 端点
这些端点可供外部集成使用(无需认证):
| 端点 | 方法 | 限制 | 描述 |
|------|------|------|------|
| /api/validate | POST | 30次/分钟 | 验证 FlowZap Code 语法 |
| /api/playground/create | POST | 5次/分钟,50次/天 | 创建临时 playground URL(15分钟有效期) |
注意: AI 代码生成(
/api/ai-generate)需要认证,仅对已登录的 FlowZap 用户开放。
链接
- npm:https://www.npmjs.com/package/flowzap-mcp
- FlowZap:https://flowzap.xyz
- 文档:https://flowzap.xyz/flowzap-code
- 支持:support@flowzap.xyz
旧方法(已弃用)
⚠️ 以下远程 MCP 端点已弃用。请使用上面的 npm 包。
- SSE:
https://flowzap.xyz/mcp/api/sse - JSON-RPC:
POST https://flowzap.xyz/mcp/api/rpc - Health:
GET https://flowzap.xyz/mcp/api/health
FlowZap MCP: 面向真实业务流程图的开放、Agent 友好之桥。
