Falcon Builder

Falcon Builder MCP 服务

通过 Claude、Cursor、ChatGPT、VS Code 或任何 MCP 客户端构建、编辑并发布可用于生产环境的 AI Agent。Falcon Builder MCP 服务可让助手检查执行记录、编辑和复制工作流、运行工作流，并在 Falcon Builder 工作区中发布工作流。

所有套餐均可使用，包括免费套餐。

• 端点： https://www.falconbuilder.dev/api/mcp（Streamable HTTP）
• 文档： https://www.falconbuilder.dev/docs/mcp
• 注册表名称： dev.falconbuilder/falcon-builder

这是托管服务。无需安装或在本地运行。

连接

OAuth 客户端：claude.ai、Claude Desktop、ChatGPT

无需令牌。客户端会自动注册。

claude.ai / Claude Desktop

1. 设置 → 连接器 → 添加自定义连接器
2. 服务 URL：https://www.falconbuilder.dev/api/mcp
3. 将 OAuth Client ID 和 Client Secret 留空
4. 选择工作区和要授予的权限，然后批准

ChatGPT 设置 → 连接器 → 创建（如有提示，请开启开发者模式）。URL 相同，OAuth 字段留空。

令牌客户端：Claude Code、Cursor、VS Code、Gemini CLI

先创建令牌：Falcon Builder → 设置 → 开发者，为令牌命名、选择权限并复制。令牌只会显示一次。每个工作区最多可有 10 个有效令牌。

Claude Code

claude mcp add --transport http falcon-builder \
  https://www.falconbuilder.dev/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "falcon-builder": {
      "url": "https://www.falconbuilder.dev/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code（.vscode/mcp.json）。VS Code 会提示输入令牌并安全存储。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "falcon-token",
      "description": "Falcon Builder API token (Settings > Developer)",
      "password": true
    }
  ],
  "servers": {
    "falcon-builder": {
      "type": "http",
      "url": "https://www.falconbuilder.dev/api/mcp",
      "headers": { "Authorization": "Bearer ${input:falcon-token}" }
    }
  }
}

Gemini CLI（~/.gemini/settings.json）。使用 httpUrl；在 Gemini CLI 中，url 表示 SSE。

{
  "mcpServers": {
    "falcon-builder": {
      "httpUrl": "https://www.falconbuilder.dev/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

权限

通过 OAuth 连接或创建令牌时，可选择以下权限。始终包含读取权限。

权限	允许的操作
读取	检查工作流、执行记录、日志、版本历史和界面
编辑草稿	更改工作流草稿并配置界面，而不影响生产环境
运行工作流	使用测试输入执行工作流。执行次数计入套餐限制
发布与回滚	将草稿部署到生产环境并恢复到较早版本

工具

读取 whoami、switch_workspace、list_agents、list_workflows、get_workflow、get_workflow_definition、get_workflow_node、validate_workflow、list_executions、get_execution、get_execution_logs、list_workflow_versions、list_interfaces、get_interface

编辑草稿 create_workflow、edit_workflow、duplicate_workflow、duplicate_agent、create_interface、update_interface、add_interface_access_rule、remove_interface_access_rule、delete_interface

运行工作流 run_workflow、rerun_executions

发布与回滚 publish_workflow、rollback_workflow、publish_interface

每个工具都会声明 MCP 注释（只读、破坏性、幂等、开放世界），因此支持这些注释的客户端可在任何更改发生前征求确认。run_workflow 和 rollback_workflow 还要求明确设置 confirm: true。

可以向助手提出的问题

• “我最近一次运行 intake 工作流为什么失败？请指出出错的节点。”
• “复制我的支持 Agent，并将其升级步骤改为向值班地址发送电子邮件。”
• “验证我的潜在客户路由工作流草稿，然后发布。”
• “将我的入职工作流回滚到上一版本。”

关于

Falcon Builder 由 NeoSky AI 构建。