FlowCastle

用于 AI 机器人开发的 Telegram 机器人模板 + MCP 服务

开箱即用的 Telegram 机器人模板和 MCP 服务——通过 Claude Code、Codex、Cursor 或任何支持 MCP 的 AI Agent 构建、编辑和部署 Telegram 机器人。无需编写 SDK 样板代码：描述机器人需求，Agent 就会为你组装工作流。

FlowCastle 是一款面向 Telegram 机器人和 Web 聊天的可视化工作流构建器：工作流、触发器、条件、AI 步骤、支付（Stripe / YooKassa / Telegram Stars）、广播、滴灌序列和集成（Gmail、Google Sheets、Notion、OpenAI，等等）——并提供 REST API 和 MCP 服务，因此可直接通过 AI 编码 Agent 开发机器人。Agent 通过 MCP 创建的每个模块，都与你可以通过拖放、连线和可视化编辑的模块完全相同。

此仓库面向开发者，包含：

路径	内容
templates/	23 个生产级机器人模板，采用 JSON 格式——与模板库以及 MCP get_flow_example 工具使用的源文件相同
mcp/	MCP 服务参考资料：端点、身份验证、全部 16 个工具，以及 apply_actions 使用的流程操作架构快照

通过 AI Agent 构建机器人（MCP）

FlowCastle 通过 Streamable HTTP 提供 MCP 服务：

POST https://api.flowcastle.ai/api/mcp
Authorization: Bearer <your-application-api-key>   # starts with app_

获取密钥：注册 → 创建应用 → API 页面 → MCP 标签页。

Claude Code

export FLOWCASTLE_MCP_TOKEN='<your-application-api-key>'

claude mcp add --transport http flowcastle https://api.flowcastle.ai/api/mcp \
  --header "Authorization: Bearer $FLOWCASTLE_MCP_TOKEN"

Codex

codex mcp add flowcastle \
  --url https://api.flowcastle.ai/api/mcp \
  --bearer-token-env-var FLOWCASTLE_MCP_TOKEN

Cursor / 任意 MCP 客户端（JSON 配置）

{
  "mcpServers": {
    "flowcastle": {
      "type": "http",
      "url": "https://api.flowcastle.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-application-api-key>"
      }
    }
  }
}

然后只需向 Agent 提出这样的要求：

“查看我的 FlowCastle 工作区并添加一个线索资格筛选工作流：在 /start 时问候用户，提出三个按钮问题，将答案保存到联系人变量，并通知我。”

Agent 会通过 get_workspace_summary / get_flow_context 读取你的工作区，拟定一批流程构建操作，通过 validate_actions 检查，再用 apply_actions 应用。完整工具参考请参阅 mcp/README.md。

模板

templates/ 中的每个 JSON 文件都是一个完整的机器人：包含元数据（标题、摘要、适用场景、建议变量、必需模块）以及 schemaExample.actions 数组——其中是一批有序的 create_flow / create_block / create_link / create_variable 操作，格式与 apply_actions 接受的格式完全一致。

有三种使用方式：

1. 一键安装：从模板库安装：flowcastle.ai/templates
2. 通过 MCP——请 Agent 使用 search_flow_examples / get_flow_example 查找模板，并将其（可选自定义）应用到你的工作区
3. 作为参考——学习真实工作流如何连接触发器、条件、等待回复步骤、支付和 AI 模块

完整索引和格式说明：templates/README.md。

REST 公共 API

面向应用的 REST API，支持联系人、联系人变量、目标事件、流程发送和广播：

• 基础 URL：https://api.flowcastle.ai/api/public/v1
• 交互式文档（Swagger）：https://api.flowcastle.ai/api/public/docs
• OpenAPI 规范：https://api.flowcastle.ai/api/public/openapi.json

身份验证使用相同的 app_… 应用密钥（Authorization: Bearer 或 X-API-Key）。

指南

请参阅 FlowCastle 博客上的分步构建指南：

• 在 10 分钟内构建 Telegram 线索机器人
• 构建 Telegram AI 支持机器人
• 我用一个 Telegram 机器人替代了早间应用

链接

• 产品：https://flowcastle.ai
• 控制面板：https://dashboard.flowcastle.ai
• 模板库：https://flowcastle.ai/templates
• API 文档：https://api.flowcastle.ai/api/public/docs

贡献

发现模板中的错误，或构建了值得分享的流程？欢迎提交 issue 或 PR——模板是纯 JSON，validate_actions（通过 MCP）会告诉你一批操作的格式是否正确。

许可证

本仓库的内容采用 MIT License 许可。