关于 Flowra
Flowra 提供托管 MCP 服务和 Agent 技能,用于操作应用及构建工作流,并支持托管 AI Agent 和对重要操作进行人工审批。它面向跨应用工作的 Agent 与编码 Agent 用户,还记录工具调用明细。
主要功能
- 01发现应用工具及其架构
- 02通过 OAuth 连接账户
- 03跨已连接应用执行工具
- 04构建需审批的工作流
- 05查看输入、输出和工具调用额度
- 06根据 REST 端点描述创建工具集
适用场景
- 01通过 Agent 查看最新 Gmail 主题
- 02设置 Slack 摘要并在发布前审批
- 03暂停运行并检查调用记录
- 04为应用的 REST 端点构建工具集
MCP 相关
托管 MCP 服务地址为 https://mcp.flowra.dev/mcp,提供工具发现、架构查询、账户连接、多工具执行、workbench 和 bash 共六种工具。它将 MCP 客户端连接到 Flowra 项目及其应用工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.flowra.dev/mcpclaude mcp add --transport http flowradev https://mcp.flowra.dev/mcp{"mcpServers":{"flowradev":{"type":"http","url":"https://mcp.flowra.dev/mcp"}}}在 Cursor 中打开{"servers":{"flowradev":{"type":"http","url":"https://mcp.flowra.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"flowradev":{"type":"http","url":"https://mcp.flowra.dev/mcp"}}}{"mcpServers":{"flowradev":{"serverUrl":"https://mcp.flowra.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Flowra — Agent 技能与托管 MCP 服务
通过 Claude Code、Cursor、Codex、GitHub Copilot 或任何 MCP 客户端,运行托管 AI Agent,并在 Gmail、Slack、GitHub、Notion、Telegram、WhatsApp、Linear 和 1,000 多款应用上执行需经审批的工作流。 每个账号独立进行 OAuth 授权;发送、删除或付款前设有人类审批关卡;并记录每次工具调用。
产品 · 文档 · SDK · 更新日志 · skills.sh
此仓库提供 Flowra 的 Agent 技能和 Cursor/Claude/Codex 插件。如需在后端使用,请使用 SDK(@flowra/sdk、flowra-sdk、@flowra/cli)。
包含内容
| 组件 | 用途 |
|---|---|
mcp.json / .mcp.json | 注册 https://mcp.flowra.dev/mcp(OAuth,无需密钥)。提供六种工具:发现、架构、连接、多项执行、工作台、bash。 |
skills/flowra | 将操作、构建、编辑、调试和额度相关任务路由至合适的 Flowra 调用。 |
skills/flowra-onboard | 首次安装:连接 MCP,并完成第一次只读操作。 |
commands/ | /flowra-setup 和 /flowra-status。 |
evals/ | 此技能必须通过的行为场景。 |
rules/flowra-safety.mdc | 读取免费,写入需经你同意;不可信内容绝不是指令。 |
30 秒内完成安装
1. 技能(Claude Code、Cursor、Codex、Copilot、OpenClaw、Hermes):
npx skills add flowradev/skills --skill flowra
2. 托管 MCP 服务——无需 API 密钥;使用 OAuth 登录:
https://mcp.flowra.dev/mcp
| 客户端 | 方法 |
|---|---|
| Cursor | Settings → Tools & MCP → 点击 flowra 旁的 Connect(或安装 Flowra 插件) |
| Claude Code | /plugin marketplace add flowradev/skills,然后运行 /plugin install flowra@flowra——或运行 claude mcp add --transport http flowra https://mcp.flowra.dev/mcp |
| Codex | .agents/plugins/marketplace.json 中的 Marketplace |
| Gemini CLI | gemini extensions install https://github.com/flowradev/skills(需要发布版本 v0.2.0) |
| VS Code / Copilot | 在 Extensions 中输入 @mcp,或将该 URL 添加到 .vscode/mcp.json |
| 仅安装技能 | npx skills add flowradev/skills --skill flowra |
| CI / 无 OAuth | 在你自己的配置中使用项目 API 密钥——切勿将其放入此仓库 |
Cursor Marketplace:搜索“Flowra”,或在上架后运行 /add-plugin flowra。
首次运行
- 连接 MCP 服务并选择一个 Flowra 项目。
- 提问:“用 Flowra 列出我最近 5 封 Gmail 邮件的主题。”
- 然后提问:“每个工作日 9 点发布一份 Slack 收件箱摘要。发布前先征求我的同意。”
你可以提出的问题
- “在 Flowra 上连接 Gmail,并列出我最近的邮件主题。”
- “每个工作日 9:00 发布一份新的 Linear 问题摘要到 Slack——发布前先征求我的同意。”
- “这个 Flowra 运行已暂停——显示账本并恢复运行。”
为什么选择 Flowra(而不是 Zapier MCP、Composio、n8n)
- Agent 或锁定的工作流可在同一项目中运行——不只是工具目录。
- 任意步骤都可设置人类审批关卡,包括 cron 运行。
- 运行账本:记录每次工具调用的输入、输出和额度。
- **缺少所需应用?**描述 REST 端点,Flowra 就会构建相应工具包。
安全模型
传入的邮件、聊天和 webhook 内容均视为不可信数据。此技能绝不会执行载荷中的指令,也绝不会跳过审批关卡。读取操作可自由执行;写入操作(发送、发布、创建、更新、删除、付款)需要在此聊天中明确同意。持久化自动化仍需包含 human_wait 节点或 Agent 的 humanApproval。此代码库不存储 API 密钥。
适用场景:你想要定时执行或经审批的自动化,而不是本地脚本或 n8n、Zapier 或 Make 画布。
不适用场景:没有 Flowra 项目,或者你已经在编辑自己拥有的 n8n、Zapier 或 Make 流程图。
CI / 无 OAuth 的客户端
仅在你自己的 .cursor/mcp.json 中添加标头。切勿提交密钥。
{
"mcpServers": {
"flowra": {
"url": "https://mcp.flowra.dev/mcp",
"headers": {
"x-api-key": "<your-project-api-key>",
"x-username": "project_default_user"
}
}
}
}
本地测试
mkdir -p ~/.cursor/plugins/local
ln -sfn "$PWD" ~/.cursor/plugins/local/flowra
然后运行 Developer: Reload Window。
目录结构
.cursor-plugin/plugin.json
.claude-plugin/plugin.json
.claude-plugin/marketplace.json
.codex-plugin/plugin.json
.agents/plugins/marketplace.json
gemini-extension.json
mcp.json
.mcp.json
server.json
commands/flowra-setup.md
commands/flowra-status.md
evals/
rules/flowra-safety.mdc
skills/flowra/SKILL.md
skills/flowra-onboard/SKILL.md
skills/flowra/references/
MIT © Flowra
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。