Twenty 在 10 月又涨了一波：GitHub 上 59,905 星，9,790 次 fork，最后推送时间 2026-10-27。
它给自己的定位是"为 AI 设计的开源 CRM"，代码里也确实按这个思路长：仓库里同时存在三套技能家族、一个 MCP 服务端、一套 app SDK。
但真实团队卡住的地方通常在最后一步。CRM 装好了，模型也接好了，问 AI"上周新进来的公司有哪几家"，它答得头头是道，只是数字是编的。
原因往往很朴素：AI 没有真的读到 CRM，它在凭上下文猜。
一、先把三套技能分清楚
Twenty 仓库根目录有一份 SKILLS.md，开头就写了这件事：三族技能面向三种人，装错了就没有用。
技能家族：应用开发技能；位置：packages/twenty-agent-skills/skills；数量：5；给谁用：在 Twenty 上开发 app 的人
技能家族：工作区使用技能；位置：packages/twenty-claude-skills/skills；数量：1；给谁用：用 CRM 本身、不做开发的人
技能家族：仓库贡献技能；位置：.claude/skills；数量：7；给谁用：改 Twenty 源码的贡献者
全仓库共 13 个 SKILL.md。这个数字很容易被跨大，因为 npx skills add twentyhq/twenty --list 直接把贡献技能也列了出来，其中 6 个是 syncable-entity-* 系列，只对改源码的人有意义。
对普通团队有用的只有两处：应用开发那 5 个，和工作区使用那 1 个。
这个口径差异值得记下来。开源项目的能力清单，要按"给谁用"再分一次，否则评估会虚高。
【二、MCP 才是把 AI 接进 CRM 的正路】
Twenty 的 MCP 服务端用 streamable HTTP 传输，OAuth 授权，端点是工作区域名下的 /mcp。
它的官方技能里写得很清楚：MCP 用来读工作区数据和元数据，包括记录、对象、字段、schema 和配置。改工作区结构要走 app，MCP 只在你明确要求时用。
这条边界设计得合理。让模型直接改数据库结构，后果通常比省下的时间贵。
接入本身的步骤不多，但每一步都有具体规则：
- 确认工作区地址。云端、自建、本地 localhost:3001 都支持，自建是一等公民。
- 规范化成 MCP 地址。有协议头的保留，没有协议头且是 localhost 类主机用 /mcp 结尾。
- 在客户端注册服务端并完成 OAuth 登录。
- 连上之后先做一次只读查询，确认字段名和记录数对得上。
第 2 步是最容易出错的地方。文档里专门给了反例：末尾斜杠没处理干净，会拼成 //mcp 或 /mcp//mcp，两个路径都指向不存在的端点，表现为连不上但没有明确报错。
三、自托管要过的四道关
Twenty 的 docker compose 里是一个 server 加 Postgres 加 Redis。看起来简单，环境变量才是真正的门槛。
变量：SERVER_URL；作用：对外地址；漏了会怎样：回调与记录链接拼错
变量：ENCRYPTION_KEY；作用：字段加密；漏了会怎样：换机后旧数据读不出
变量：APP_SECRET；作用：会话签名；漏了会怎样：登录态反复失效
变量：PG_DATABASE_URL / REDIS_URL；作用：存储；漏了会怎样：启动直接失败
ENCRYPTION_KEY 和 FALLBACK_ENCRYPTION_KEY 要一起备份。丢了之后，已有加密字段会全部作废，重新生成密钥也无法恢复。
运行环境也不宽松：根 package.json 要求 Node ^24.5.0、yarn >=4.0.2，仓库管理器锁定 yarn 4.18.1。
许可同样是两道：主体是 AGPLv3，标注 @license Enterprise 的文件走商业许可。把 Twenty 嵌进对外产品之前，这两个边界都要让法务看一眼。
四、接进百智办公的做法
在百智办公里，CRM 这类外部系统走连接器，模型能力走大模型，中间的分工由技能和规则约束。
- 「资源管理 → 连接器」新建一个，填 Twenty 的 MCP 地址（形如 OAuth。
- 连接测试通过后，只勾选查询类工具：读对象、读字段、查记录。写入类先不开放。
- 「资源管理 → 技能」做一个"客户周报"技能，规定输出必须带记录数和查询时间。
- 「资源管理 → 规则」加一条强制规则：涉及金额、家数、时间范围的陈述，必须来自连接器返回，取不到写"未获取"。
- 分发范围选指定分组，比如销售与客户成功。
关键在于第 3、4 步的组合。技能定义输出形状，规则锁死数据来源，两者缺一个就会出现"看起来专业、数字对不上"的周报。
五、可以直接抄的提示词
你在帮我出一份 CRM 周报。数据只能来自我提供的 Twenty 连接器返回结果，禁止使用你记忆中的任何数字。
第一步：确认连接
· 调用一次对象列表，列出工作区里可读的对象名。
· 如果调用失败，直接输出"连接失败"和错误信息，停止后续步骤。
第二步：取数
· 取最近 7 天新建或更新的公司、联系人、商机。
· 记录每类返回的条数、查询时间、所用对象名。
第三步：出报表
按三块输出：
- 概览：三类记录的新增数、更新数、总量。
- 商机推进：按阶段分组计数，标出本周有阶段变化的商机。
- 待跟进：超过 14 天没有更新的商机列表，最多 10 条，按最后更新时间升序。
硬性要求：
- 每个数字后面标注查询时间。
- 条数为 0 时写"0 条"，不要写"暂无数据"以外的推断。
- 任何字段缺失写"该字段未返回"，不要用相近字段替代。
- 最后一行写：数据来自 Twenty 工作区实时查询，未做人工核对。
这段的重点在第一步。先做一次连接确认，失败就停，能避免模型在连接不通时靠常识编出一份完整的周报。
六、四个坑
坑一：把 13 个技能全装上。
其中 7 个是给 Twenty 贡献者用的，装进业务工作台只会干扰判断。按"给谁用"筛选之后，真正可用的是 6 个。
坑二：MCP 地址没规范化。
末尾斜杠、协议头、端口，任何一处不对都可能连不上。官方文档给了一组对照表，照着改比猜快。
坑三：只读工具和写入工具一起开。
MCP 本可以改工作区，一旦模型判断失误，删改的就是真实客户数据。先用只读跑通，再逐个放写入。
坑四：自托管只备份数据库。
加密字段依赖 ENCRYPTION_KEY，只备库不备密钥，等于备份了一份读不出来的数据。
七、边界
· 59,905 星、9,790 次 fork、AGPLv3 主体加商业许可：GitHub REST API 与仓库 LICENSE 文件，2026-10-27 读取。
· 13 个 SKILL.md、三族分别 5 / 1 / 7 个：本地解包统计，2026-10-27。
· 仓库 499MB、34,592 个 TS/TSX 文件、服务端 24 个业务模块与 89 个核心模块：本地统计，2026-10-27。
· MCP 传输方式、/mcp 规范化规则、只读边界：仓库 packages/twenty-agent-skills 内 use-twenty-mcp 技能与 references/use-twenty-mcp/setup.md，2026-10-27 读取。
· 环境变量清单、Node 与 yarn 版本：packages/twenty-docker/docker-compose.yml 与根 package.json，2026-10-27。
· 我没有部署 Twenty 实例做端到端实测，OAuth 流程、查询延迟、并发表现均未验证。
八、事实来源
· 星数、fork、许可、最后推送：GitHub REST API /repos/twentyhq/twenty，2026-10-27 读取
· 三族技能的划分与用途、13 个 SKILL.md 的分布、npx skills add 的列出口径：仓库 SKILLS.md，2026-10-27
· MCP 传输方式、OAuth、/mcp 端点、URL 规范化规则与反例、MCP 与 app 的职责边界：packages/twenty-agent-skills/skills/use-twenty-mcp/SKILL.md 与 references/use-twenty-mcp/setup.md，2026-10-27
· 环境变量、镜像 twentycrm/twenty、Postgres 与 Redis 依赖：packages/twenty-docker/docker-compose.yml，2026-10-27
· Node ^24.5.0、yarn >=4.0.2、packageManager: yarn@4.18.1：根 package.json，2026-10-27
· 连接器授权模式与连接测试、技能包规则、强制规则的约束力、三档分发范围：官方文档《团队资源配置与分发》《规则配置与使用》，2026-10-27 核对
