用途:当用户希望智能体连接到一个正在运行的 Twenty 工作区,读取或查看其中的数据与元数据时使用本技能。典型触发包括列出公司、人员、商机,查看本周创建的记录,了解工作区内容,将智能体连接到 Twenty 工作区,为某工作区配置 Twenty MCP,查询 CRM,汇总销售管道,或查看公司对象的字段。
主要能力:Twenty MCP 让智能体连接已有 Twenty 工作区,检查工作区数据与元数据,包括记录、对象、字段、架构、配置及相关 CRM 上下文。
使用方式:配置部分参考 setup.md,涉及工作区 URL 规范化、MCP 服务器配置、OAuth 防护与设置排障。检索、列出、搜索、汇总或呈现工作区记录前,需先阅读 result-formatting.md,用于选择正确的 Twenty MCP 工作区、查询记录、构建记录链接、格式化日期与值,并以可读 Markdown 而非原始 API 输出呈现。
输出约定:若工具输出包含 recordReferences,记录名称列或标题必须将每个显示名称链接回 Twenty,链接格式为 {workspaceOrigin}/object/{objectNameSingular}/{recordId}。若工作区来源未知,尽量从所选 MCP 服务器 URL 解析;仍无法解析时,应说明直接记录链接需要工作区 URL,不得虚构主机。在 recordReferences 与工作区来源可用时,不得在记录表格中显示未链接的记录名称。
适用场景:读取或查看运行中的 Twenty 工作区、检索或检查工作区数据、检查元数据、排查 MCP 访问问题。
限制:不要用本技能搭建应用(用 create-app)、添加或修改应用实体(用 develop-app)、操作应用(用 manage-app)或准备市场资源(用 publish-app)。不要将 MCP 作为自定义工作区的默认方式,例如优先通过 Twenty 应用创建新对象,而非直接通过 MCP;仅当用户明确要求通过 MCP 时才用于工作区自定义。