FlowyTeam OKR MCP Server

OKR MCP 服务 — FlowyTeam

将 Claude、ChatGPT 或任何 MCP 客户端连接到您的 OKR、KPI 和任务。

FlowyTeam 是原生的 Model Context Protocol 服务。连接后，AI Agent 可以读取工作区中的所有目标和关键结果、发布进展更新、更新关键结果进度、跟踪 KPI 并生成报告——只需使用自然语言，无需打开仪表板。

不同于只提供单一功能的 OKR MCP 服务，同一连接还可访问任务、项目、员工、考勤、休假、工单、客户、潜在客户和开票功能。33 个工具，一个连接。

• 📘 设置指南：https://flowyteam.com/get/mcp-server
• 📗 完整 API 参考：https://flowyteam.com/get/mcp-docs
• 🔌 OAuth 连接器文档：https://flowyteam.com/mcp-docs

关于本仓库。 FlowyTeam 的 MCP 服务托管在平台上，作为 FlowyTeam 平台的一部分运行，因此无需安装或自行托管。本仓库包含连接配置、工具参考和示例。如果您要找的是类似 npm install 的本地服务，那么这不是它的运行方式：只需让客户端连接到一个 URL 并完成授权。

---

快速开始

选择与您的客户端对应的方式。

Claude Desktop、Claude 网页版、Claude 移动版或 ChatGPT — OAuth

无需复制 API 令牌。每个应用授权一次即可。

https://flowyteam.com/api/mcp/cloud/rpc

Claude： Settings → Connectors → Add custom connector → 粘贴 URL → Log in → Authorize。授权页面会准确显示连接器可以访问的内容；只有您批准后才会共享数据。

ChatGPT： Settings → Connectors → 添加相同的 URL 并授权。

使用带 PKCE 的 OAuth 2.0。工具遵循您现有的 FlowyTeam 角色和权限。

Claude Code（CLI）— Bearer 令牌

Claude Code 使用不同的端点，并使用令牌而非 OAuth。

claude mcp add --transport http flowyteam \
  https://flowyteam.com/api/v2/mcp/rpc \
  -H "Authorization: Bearer YOUR_API_TOKEN"

从 FlowyTeam → Settings → MCP & AI Integration 获取 YOUR_API_TOKEN。

或者将 mcp.json.example 复制到项目中的 .mcp.json，这样整个团队都能使用：

{
  "mcpServers": {
    "flowyteam": {
      "transport": "http",
      "url": "https://flowyteam.com/api/v2/mcp/rpc",
      "headers": { "Authorization": "Bearer YOUR_API_TOKEN" }
    }
  }
}

⚠️ CLI 端点（/api/v2/mcp/rpc）不能与 OAuth 连接器端点（/api/mcp/cloud/rpc）互换使用。Claude Desktop 和 ChatGPT 无法使用令牌端点；Claude Code 无法使用 OAuth 端点。请根据您的客户端选择对应端点。

还没有账户？

公共网关提供三个无需令牌的入门工具，因此 Agent 可以通过对话创建并激活账户：

claude mcp add --transport http flowyteam https://flowyteam.com/api/mcp/gateway

然后让您的 Agent “帮我注册一个 FlowyTeam 账户”。它会调用 auth_register，您提供验证邮件中的 6 位验证码，它会调用 auth_verify_email，随后您会获得一个 api_token——使用该令牌重新配置后，即可使用全部工具。

FlowyTeam 为最多 10 位用户提供免费套餐；付费套餐起价为每位用户每月 3.33 美元。所有套餐均包含 MCP 访问权限，无需额外购买 API 附加服务。

---

示例提示词

OKR 和 KPI 工具就是为处理以下请求而构建的：

Show me all Q3 objectives below 50% progress.
Check in on my key results and update this week's numbers.
Create an objective for the sales team with three key results.
Which KPIs are off target this month, and who owns them?
Summarise our OKR progress for the leadership review.
Align my objectives to the company goal for this cycle.
What's the current value of every indicator in the Revenue category?
Close out the Q3 performance cycle and open Q4.

同一连接也能访问工作区的其他部分，因此您还可以在单个请求中跨领域操作：

Which team members own a key result that's off track and also have overdue tasks?
Draft a status update covering our OKR progress and open support tickets.
Log 2 hours against the Onboarding project and update the related key result.

---

工具

OKR 和 KPI

工具	方法	功能
objectives	GET POST PUT DELETE	OKR 目标——列出、创建、更新、删除。可按周期、类型（公司/团队/个人）和状态筛选。
key-result	GET POST PUT DELETE	OKR 关键结果——列出、创建、更新、删除、更新进度。可关联到目标。
indicators	GET POST PUT DELETE	KPI 指标——列出、创建、更新、删除。可按类别和员工筛选。
indicator-category	GET POST PUT DELETE	KPI 指标类别/类型。
indicator-record	GET POST DELETE	每个周期的 KPI 实际值。可通过 indicator_id + period_key 查询。
performance-cycle	GET POST PUT DELETE	OKR 绩效周期——列出、创建、更新、删除。

任务与项目

工具	方法	功能
tasks	GET POST PUT DELETE	列出、创建、更新、删除任务，以及标记为已完成。可按状态、优先级、项目、负责人和截止日期筛选。
projects	GET POST PUT DELETE	项目及其里程碑、成员、类别和文件。所有查询均按名称进行。
task-category	GET POST PUT DELETE	任务类别。
timelogs	GET POST PUT DELETE	时间日志——启动计时器、停止／编辑、删除。可按项目、员工和日期筛选。

人员与人力资源

工具	方法	功能
employees	GET POST PUT DELETE	列出、显示完整个人资料、创建、更新、停用员工。按姓名或电子邮件查询。
department	GET POST PUT DELETE	部门／团队，包括添加／移除成员。
designation	GET POST PUT DELETE	职务／职位及成员数量。
attendance	GET POST PUT	上班打卡、下班打卡、列出记录。可按员工、日期、月份和年份筛选。
leave	GET POST PUT DELETE	休假申请——列出、创建、批准、拒绝、取消。
leave-type	GET POST PUT DELETE	休假类型（年假、病假等）。写入操作仅限管理员。
holiday	GET POST PUT DELETE	公司假日。可按年份、即将到来／已过去筛选。
events	GET POST PUT DELETE	公司活动／日历。
notices	GET POST PUT DELETE	公告栏。可按日期范围或受众筛选。

支持

工具	方法	功能
tickets	GET POST PUT DELETE	工单及回复、统计信息、关闭／重新打开工单。按名称查询。
ticket-type	GET POST PUT DELETE	工单类型／分类。
ticket-channel	GET POST PUT DELETE	工单渠道（电子邮件、电话、聊天等）。
ticket-agent	GET	列出工单客服及其分组。

CRM 与财务

工具	方法	功能
clients	GET POST PUT DELETE	客户——列出、创建、更新、删除。
leads	GET POST PUT DELETE	销售线索。可按状态、客服和日期范围筛选。
contracts	GET POST PUT DELETE	客户合同。
invoices	GET POST PUT DELETE	客户发票——列出、创建、更新状态、删除。
estimates	GET POST PUT DELETE	客户估价／报价。
expenses	GET POST PUT DELETE	费用和报销申请，包括批准／拒绝。
expense-category	GET POST PUT DELETE	费用类别。写入操作仅限管理员。

账户（公开网关——无需令牌）

工具	方法	功能
auth_register	POST	创建新的 FlowyTeam 公司账户。发送 6 位验证码。
auth_verify_email	POST	使用验证码激活账户并返回 api_token。
auth_login	POST	获取现有账户的 api_token。

每项操作的完整参数、请求示例和错误代码： https://flowyteam.com/get/mcp-docs

---

端点

端点	身份验证	用途
https://flowyteam.com/api/mcp/cloud/rpc	OAuth 2.0 + PKCE	Claude Desktop／网页／移动端、ChatGPT
https://flowyteam.com/api/v2/mcp/rpc	Authorization: Bearer <api_token>	Claude Code（CLI）、n8n、其他 HTTP MCP 客户端
https://flowyteam.com/api/mcp/gateway	无	仅用于 auth_register、auth_verify_email、auth_login

权限

工具以你的身份运行。每次调用都仅限于你的工作区和你在 FlowyTeam 中已有的角色权限——Agent 无法读取或更改任何你无法在界面中读取或更改的内容。管理员拥有完整权限；成员可访问自己的记录，以及其角色授予的其他权限。

错误代码

代码	含义
200	成功
401	未通过身份验证——缺少或无效的 Bearer 令牌
403	禁止访问——已通过身份验证，但权限不足
404	未找到资源
422	验证失败
429	请求频率受限

故障排除

Claude Code 未显示 FlowyTeam 工具。 添加服务后，请启动新会话 — 工具会在会话开始时被发现。检查 claude mcp list。

401 Unauthenticated。 令牌缺失、已过期，或粘贴时重复添加了 Bearer 前缀。请从 Settings → MCP & AI Integration 重新复制令牌。

Claude Desktop 无法连接到 CLI 端点。 这是预期行为 — 请改用 OAuth 连接器 URL （/api/mcp/cloud/rpc）。请参阅快速入门中的警告。

工具本应可用，却返回 403 Forbidden。 您的 FlowyTeam 角色缺少相应权限，或者您的套餐未启用该模块。请咨询工作区管理员。

链接

• 设置指南 — https://flowyteam.com/get/mcp-server
• API 参考 — https://flowyteam.com/get/mcp-docs
• OAuth 连接器 — https://flowyteam.com/mcp-docs
• 帮助中心 — https://resource.flowyteam.com/help-center/
• FlowyTeam — https://flowyteam.com

许可证

此代码库中的文档和示例采用 MIT License 发布。 FlowyTeam 平台本身是商业软件。