我们为SaaS构建了一个MCP服务器（约150个工具）——现在Claude运行我们的项目管理。经验教训。

我们在构建TRCR——为自由职业者、机构和小型团队提供时间追踪、任务、客户和开票服务。核心理念：你只需跟踪一次时间，后续所有操作自动完成。每个团队成员有两种费率——客户支付的费用以及该员工对你的成本——因此每个项目/客户的收入、利润率和盈利能力都能实时计算，发票直接从跟踪的时间记录中生成。无需将时间表导出到电子表格来弄清楚项目是否盈利。几个月前，我们下了第二个赌注：除了发布功能外，我们几乎将整个产品暴露为MCP服务器，以便AI代理可以直接使用它。如今它涵盖了21个领域（任务、CRM、发票、时间、报告、聊天等）的约150个工具，支持OAuth 2.1和个人访问令牌。我们大力内部试用：我们自己的任务管理和CRM通过Claude与我们的API对话来运行。我们甚至通过任务ID将工作交给编码代理——它会从任务本身拉取完整规范。我们学到的教训： **1. 代理是你最严苛的API审查者。** 当AI开始每天使用我们的API时，每一个不一致的地方都浮出水面——令人困惑的参数名称、返回信息不足的端点、缺少批量操作。为代理修复API也让人类用户受益。 **2. 工具描述现在就是产品文案。** 代理根据描述字符串选择工具。模糊的描述 = 工具永远不会被调用。我们像写微文案一样重写了它们，而不是文档。 **3. 自包含上下文胜过巧妙的集成。** 当我们将任务委托给代理时，所有内容都必须存在于任务本身——完整规格在描述中，源文件作为附件。任何“它可以在别处查找”的假设都会失败。 **4. 为MCP实现OAuth 2.1很痛苦但值得。** PAT（个人访问令牌）让我们快速起步；而OAuth让它感觉像真正的集成，而不是黑客手段。 **5. 代理+账单数据=杀手组合。** 最神奇的时刻不是任务管理——而是问“上个月哪个客户最赚钱，并为他们起草六月份的发票”，然后看着它拉取时间记录、应用正确的费率并生成发票。这时，暴露整个领域（费率、时间、发票、报告）而不是仅仅任务，就得到了回报。 **6. 通过代理进行内部试用改变了你的路线图。** 我们近期的积压任务中，有一半来自观察代理在何处卡住。意想不到的结果是：“与AI代理配合良好”正在成为我们的主要差异化优势，而不是附属功能。 乐于回答关于为SaaS构建MCP服务器的问题——模式设计、认证、我会做哪些不同的事。