FlowZap - Not another Diagramming tool.

我刚刚在 https://flowzap.xyz/api/mcp 上线了一个公开、稳健的 MCP（Model Context Protocol）服务器。现在，任何 Agent——Claude、ChatGPT（自定义函数）、DeepSeek、Qwen、Grok 等等——都可以通过一个极简的 JSON‑RPC 2.0 HTTP 接口来生成、更新并交付业务流程图。它安全、快速、通用。

为什么要为 FlowZap 构建远程 MCP？

流程制图是协作的、迭代的，而且（实话说）经常很繁琐。FlowZap 已经提供现代化的 UI 和代码友好的 DSL 来创建、调整并协作编辑流程。但随着 LLM Agent 成为自动化的核心，集成摩擦成了瓶颈——不仅对我们，对所有想把 Agent 接到真实制图后端的团队都是如此。

我们希望为所有人解决这个问题，而不仅仅是我们的技术栈。没有专有锁定，不必“等我们发布插件”。只要你的 Agent 会通过 HTTP 说 JSON‑RPC，它就能说 FlowZap——就这么简单。

将 FlowZap 添加到 Claude

Claude 在 Pro、Max、Team、Enterprise 计划中支持通过远程 MCP 添加自定义连接器。注意：截至 2025 年 9 月，一些用户在 Claude Desktop 上会遇到 OAuth 连接问题。如果点击「Connect」后连接没有保持，这是 Claude Desktop 的已知问题。我们会持续关注 Anthropic 的更新。

打开 Claude → Settings → Connectors → Add custom connector，填入 FlowZap MCP 基础 URL：https://flowzap.xyz/api/mcp/sse（SSE 传输），然后点击 Add。
「OAuth Client ID / Secret」请留空，除非你在 Claude for Work 计划且已分配自定义客户端。
添加后，在会话中启用该连接器的工具；获得许可时，Claude 可在聊天和 Research 模式调用这些工具。
自定义连接器就是远程 MCP 服务器，无需本地安装；模型会通过 HTTPS 安全调用 FlowZap 的 JSON‑RPC 工具。
Anthropic 建议仅启用所需工具、审阅工具调用请求并使用可信服务器——这些都是 FlowZap MCP 天生遵循的最佳实践。
若后续要扩展连接器，Claude 也支持远程 MCP 的开发者工作流，团队可以迭代，而无需改变终端用户的设置。

提示： 将用户路径聚焦在“URL + FlowZap Code”。用户先获得优质预览，然后前往 FlowZap 注册并保存，契合本文描述的转化漏斗。

故障排除：Claude Desktop 连接

如果连接器在设置后显示「Disconnected」：

这是 Claude Desktop 在 OAuth 处理上的已知问题。
你的浏览器可能会短暂显示「success」，但连接并不会保持。
这不是 FlowZap MCP 服务器的问题。
备选方案：使用支持 JSON‑RPC 的其他 LLM 客户端，直接调用我们的 API。

Perplexity 现状（目前可用的）

Perplexity 明确表示：本地 MCP“连接器”目前在 Mac 应用可用；远程 MCP（云托管/自定义服务器）“即将上线”，会先向付费订阅者推出——因此更广泛的自定义连接器支持尚未在 Windows/Web 普遍开放。

在 Perplexity Mac 上，本地 MCP 需要安装 Perplexity 助手（PerplexityXPC），然后在 Connectors 中添加 MCP；该路径已有文档并已正式上线。
面向企业客户，Perplexity 已提供应用/文件连接器（如 Google Drive、OneDrive、Box）作为托管集成；这些是官方精选连接器，而非任意自定义服务器。
在远程 MCP 扩大到更多平台之前，Windows/Web 用户只会看到内置连接器列表——这与当前大多数用户在 UI 中的体验一致。

FlowZap MCP API 一览

发现（Discovery）： https://flowzap.xyz/api/mcp
SSE 端点： https://flowzap.xyz/api/mcp/sse
消息（JSON‑RPC）： POST https://flowzap.xyz/api/mcp/messages
健康检查： GET https://flowzap.xyz/api/mcp/health
OAuth 发现： https://flowzap.xyz/.well-known/oauth-authorization-server

示例：

curl -s https://flowzap.xyz/api/mcp/health | jq

OpenAPI + Postman：
- OpenAPI stub — 快速了解 schema，适用于 Swagger/Postman
- Postman collection — 上手调试的合集
会话体验（Session UX）：
返回的 Playground 链接始终是公开、干净的，并在5 分钟后（未保存图）过期——让你的流程保持新鲜、无状态且安全。

关键流程（可直接复制/粘贴）

1. 列出可用工具

curl -s -X POST https://flowzap.xyz/api/mcp/messages \
 -H "Content-Type: application/json" \
 --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | jq

2. 注册新 Agent（获取 API Token）

curl -s -X POST https://flowzap.xyz/api/mcp/messages \
 -H "Content-Type: application/json" \
 --data '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"flowzap.register_agent","arguments":{"name":"Partner Agent","email":"<partner@example.com>","termsAccepted":true}}}' | jq

你会拿到一个 API Token——请妥善保管。

3. 认证（用 Token 换 JWT）

curl -s -X POST https://flowzap.xyz/api/mcp/messages \
 -H "Content-Type: application/json" \
 --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"flowzap.authenticate_agent","arguments":{"apiToken":"<YOUR_API_TOKEN>"}}}' | jq

4. 创建 Playground 会话

这会返回一个 5 分钟“未保存”的公共链接 + FlowZap Code（用于代码生成或直接编辑）：

curl -s -X POST https://flowzap.xyz/api/mcp/messages \
 -H "Content-Type: application/json" \
 --data '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"flowzap.playground_create_session","arguments":{"code":"node A\nnode B\nA -> B"}}}' | jq

你会获得类似的结果：

{
  "success": true,
  "url": "https://flowzap.xyz/playground/xyz...",
  "code": "node A\nnode B\nA -> B"
}

注意： Playground 链接在 5 分钟后失效，除非用户注册并保存作品——这有助于合作伙伴推动转化。

可以构建什么

Claude（或任何 Anthropic Agent）： 作为远程 MCP 自定义连接器添加我们：Settings → Connectors → Add custom connector → 输入 https://flowzap.xyz/api/mcp/sse（SSE）。OAuth 字段留空（非 Work 计划）。
ChatGPT（API、插件、Actions）： 实现向 https://flowzap.xyz/api/mcp/messages（JSON‑RPC 2.0）发起的函数调用。使用 OpenAPI 或 Postman 把工具映射为函数。
DeepSeek、Qwen、Grok 等： 同理——如果你的编排器/Agent 框架支持外部工具调用（LangChain、HF Agents、自研代码等），只需用合法负载指向我们的端点。
CLI、浏览器 Agent、服务端 Bot： 服务器允许 CORS（Access-Control-Allow-Origin: *），因此可在浏览器侧做 Demo 或前端（但请勿泄露你的 Token）。

真实开发循环（开发者的迭代）

Agent（Claude、ChatGPT、DeepSeek、Grok 等）发送 JSON‑RPC 调用 → FlowZap MCP 为用户创建隔离的未保存 Playground 会话。
用户在 5 分钟内看到公共链接与可编辑的 FlowZap Code → 会话可交互（拖拽、编辑），但在注册之前“保存”被禁用。
用户提出更多调整 → 你再次调用 API，获取新的链接/代码。
用户想要保存 → 我们平滑引导其在 flowzap.xyz 注册/登录，解锁团队/协作能力。

无图像预览，无二进制骚操作。你得到的永远是干净的 URL + FlowZap Code——不添赘，只为流程。

认证

OAuth 2.0： MCP 服务器支持 OAuth 2.0，并支持动态客户端注册。
Claude Desktop： 当其工作正常时，OAuth 流程是自动的。
直接 API 访问： 先通过注册端点注册，然后进行认证。
测试： 提供用于测试的模拟（mock）认证方式。

为可控与增长而设计

对你： 引导用户走向你的应用，而不是无尽的沙盒。默认不保存意味着转化漏斗始终在运转。
对生态： 搭桥而非筑墙。我们拥抱开放的 Agent，而非把门人。

桌面端疑难排查（Desktop）

如果点击「Connect」后只打开了新对话，且从未请求你的 URL：

多半是 Desktop 客户端问题。请在 Claude Web 使用相同的 https://flowzap.xyz/mcp/api/sse，或在 Messages API 中通过 mcp_servers 使用该 URL。
使用 SSH/stdio 方式时，如果 3001 端口已被常驻服务占用，请在 stdio 启动命令里设置 MCP_HTTP_PORT=0 以避免 EADDRINUSE。

总结

FlowZap MCP 是你通往工作流图的快车道，让 LLM 与交互式 UI 无缝衔接，并最终走向付费与协作。接入、试用，告诉我们你造了什么。

基础 URL（SSE）： https://flowzap.xyz/api/mcp/sse
消息（JSON‑RPC）： POST https://flowzap.xyz/api/mcp/messages
Health： GET https://flowzap.xyz/api/mcp/health
OpenAPI Stub： GET https://flowzap.xyz/openapi.json
Postman： GET https://flowzap.xyz/postman.json
Support： feedback@flowzap.xyz
FlowZap Code GitHub： https://github.com/flowzap-xyz/code {{ ... }} 有问题？有反馈？如果你通过 /api/mcp 连接、测试或上线，记得告诉我！

FlowZap MCP： 面向真实业务流程图的开放、Agent 友好之桥。按你的方式，构建你想要的工作流。

介绍 FlowZap MCP 服务器：从 LLM Agent 到交互式流程图的最快路径