FrameOn — Agentic Project Management

FrameOn MCP

用于 Agent 式项目管理的 MCP 服务。 任务、文档、决策和工时汇集于一个共享的团队上下文中，AI Agent 可通过 Model Context Protocol 访问。

此仓库包含该服务的公开部分：协议类型、服务提供给已连接客户端的指南、技能操作手册，以及已发布的清单。服务本身托管在远程端——你无需运行它。

端点	https://api.frameonlab.com/api/v1/mcp
传输方式	streamable-http
身份验证	OAuth 2.1 — 必须使用 Dynamic Client Registration 和 PKCE (S256)
工具	20 个（13 个只读，7 个写入）——参见 docs/tools.md
注册表	com.frameonlab/frameon
文档	https://app.frameonlab.com/mcp

为什么要构建它

当 AI 助手被要求协助项目时，通常只能依据粘贴到聊天中的内容开展工作。它看不到三周前做出的决定、有人在会议中提出的约束，也不知道谁已经负责这项任务。于是它信心满满地猜测，而人类则要花一个下午来纠正它。

FrameOn 展示项目本身：任务树、存放决策的 wiki、单独保存约定和陷阱的项目记忆、团队、提醒和工时记录。Agent 读取真实状态，并将自己的操作结果写回；下一位 Agent——即使在另一台设备、另一个客户端上——也能在那里找到这些信息。

连接

Claude Code

claude mcp add --transport http frameon https://api.frameonlab.com/api/v1/mcp

Claude Desktop、Cursor 和其他 mcpServers 客户端

{
  "mcpServers": {
    "frameon": {
      "type": "http",
      "url": "https://api.frameonlab.com/api/v1/mcp"
    }
  }
}

ChatGPT

添加一个指向同一 URL 的连接器。OAuth 流程会在浏览器中运行；无需在任何地方粘贴密钥。

这些连接方式都不需要 API 密钥。首次调用会打开授权页面，由人类批准工作区，之后客户端会保存令牌并自动轮换。在没有浏览器的脚本场景中，也可以使用个人访问令牌，通过 Authorization: Bearer … 传递。

更多信息（包括各客户端的分步指南）：https://app.frameonlab.com/mcp

Agent 可获取的内容

连接后调用 frameon://guide。服务会返回一份书面简报——介绍 FrameOn 是什么、哪些工具能回答哪些问题、哪些陷阱会导致来回沟通，以及同样重要的：FrameOn 有哪些 Agent 无法获取的功能：甘特图、工时表审批步骤、财务报告。一个不说明自身能力边界的工具，会被人以糟糕的方式自行发挥。

此仓库的范围

路径	内容
src/mcp.types.ts	JSON-RPC 2.0 信封类型，以及服务会回显的协议版本
src/mcp-guide.ts	在 frameon://guide 提供的文本，以及提示词规范
src/mcp-skills.ts	list_skills / get_skill 背后的技能操作手册
.mcp.json	仓库根目录中可直接使用的客户端配置——Open Plugins 的入口
server.json	发布到 MCP 注册表的清单
docs/tools.md	20 个工具及服务公布的描述
examples/	可直接粘贴使用的客户端配置

服务实现、数据库和租户层不在此仓库中，也不是开源的。此处提供的是客户端交互的内容和 Agent 读取的内容——足以让你在连接前准确了解将要连接的服务。

安全

此端点采用多租户架构，且每条查询都会按租户进行筛选。凭证只能访问其角色所允许的项目；tenant_id 绝不会出现在工具响应中。写入工具会针对每次调用，根据凭证携带的范围和角色进行限制——绝不会依据请求正文中发送的任何内容。

发现了可疑问题？请联系 [email protected]。如果怀疑存在漏洞，请勿创建公开议题。

许可证

MIT — 参见 LICENSE。