跳到正文
cccskills
免费在 GitHub 公开

use-twenty-mcp

Connect an agent to an existing Twenty workspace through MCP, a tool connection protocol, to inspect CRM records and field definitions. Present results as readable Markdown with formatted dates, values, and links to the original records.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Use when the user wants the agent to connect to an existing Twenty workspace through MCP, retrieve or inspect workspace records and metadata, or present Twenty CRM data as readable Markdown with formatted dates, values, record links, and compact tables instead of raw API output.

查看安装方法

适用场景

  • List companies, people, and opportunities
  • Review records created this week
  • Inspect company fields and workspace structure
  • Set up or troubleshoot a Twenty MCP connection

包含的文件(2)

  • SKILL.md3.0 KB
  • agents/openai.yaml221 B

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

When To Use

Pick this skill when the user wants to read from or inspect a running Twenty workspace — not change app code. Representative triggers:

  • "list all my companies / people / opportunities in Twenty"
  • "show me the records I created this week"
  • "what's in my Twenty workspace"
  • "connect my agent to my Twenty workspace"
  • "set up Twenty MCP for myworkspace.twenty.com"
  • "query the CRM for X"
  • "summarize my pipeline from Twenty"
  • "show me the fields on the company object"

Do not use this skill to scaffold an app (use create-app), to add or modify app entities (use develop-app), to operate an app (use manage-app), or to prepare marketplace assets (use publish-app).

What It Is

Twenty MCP connects the agent to an existing Twenty workspace so it can inspect workspace data and metadata: records, objects, fields, schema, configuration, and related CRM context.

This is different from a Twenty app. Use $create-app when the user wants to scaffold a new app codebase, and $develop-app when the user wants to add app-defined features such as objects, fields, logic, layouts, or components.

Use $use-twenty-mcp when the user wants to connect the agent to an already running workspace, retrieve or inspect workspace data, inspect metadata, or troubleshoot MCP access.

Do not use MCP as the default way to customize a workspace. For example, prefer creating a new object through a Twenty app rather than directly through MCP. Use MCP for workspace customization only when the user explicitly asks to do it through MCP.

Setup

Use ../../references/use-twenty-mcp/setup.md for workspace URL normalization, MCP server configuration, OAuth guardrails, and setup troubleshooting.

Retrieval

Before retrieving, listing, searching, summarizing, or presenting workspace records, read ../../references/use-twenty-mcp/result-formatting.md.

Apply that reference when selecting the right Twenty MCP workspace, querying records, building record links, formatting dates and values, and presenting readable Markdown instead of raw API output.

Output Contract

Before the final answer for retrieved workspace records:

  • If the tool output includes recordReferences, the first record-name column or record heading MUST link each display name back to Twenty.
  • Build links as {workspaceOrigin}/object/{objectNameSingular}/{recordId} using the selected workspace origin and the returned recordReferences.
  • If the workspace origin is not known, resolve it from the selected MCP server URL when possible. If it still cannot be resolved, state that direct record links need the workspace URL instead of inventing a host.
  • Never show unlinked record names in a record table when recordReferences and the workspace origin are available.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Create a new app that extends a running Twenty instance. Guide project naming and instance selection, then use the scaffolder to install dependencies, authenticate, initialize Git, and complete the initial sync and installation.

中文简介正在准备中。当前显示英语简介。

  • Start a new Twenty app project
  • Scaffold a CRM extension or integration
  • Create an app connected to an existing Twenty instance
twentyhq/twenty6万2026年10月22日 更新

Extend an existing Twenty app with data fields, layouts, custom screens, automated logic, workflows, and permissions. The skill guides code organization, entity creation, type checking, linting, and syncing definitions to the active remote.

中文简介正在准备中。当前显示英语简介。

  • Add custom fields and objects to an existing Twenty app
  • Build custom screens and standalone pages
  • Run logic when records are created
twentyhq/twenty6万2026年10月22日 更新

Operate an existing Twenty app by syncing changes, managing server connections, building and deploying releases, and inspecting function logs. It also guides troubleshooting and CI/CD, the workflows used to automate testing and deployment.

中文简介正在准备中。当前显示英语简介。

  • Sync app changes to a Twenty server
  • Prepare and deploy an app update
  • Investigate failed builds or deployments
twentyhq/twenty6万2026年10月22日 更新

Prepare an existing Twenty app for npm or marketplace publication by reviewing its README, listing details, package metadata, logos, and screenshots. The workflow includes checking publication settings, validating the build, and running the publishing command.

中文简介正在准备中。当前显示英语简介。

  • Prepare a Twenty app marketplace listing
  • Write or review README and About text
  • Check logos, screenshots, and public assets
twentyhq/twenty6万2026年10月22日 更新

qa-scout

免费

Check a Twenty pull request through real browser scenarios derived from its changes. Verify database effects and server logs alongside visible results, then produce screenshots, a structured verdict, and a report of any failures or uncertainty.

中文简介正在准备中。当前显示英语简介。

  • Validate user flows before or after merging a Twenty pull request
  • Check database writes and timeline activity after saving records
  • Investigate backend errors hidden behind a successful screen
twentyhq/twenty6万2026年10月22日 更新

Implement validation and migration action builders for syncable entities, data types handled by Twenty's synchronization system. This skill covers required fields, uniqueness, reference checks, and orchestration wiring, with validators that return errors without throwing exceptions or changing data.

中文简介正在准备中。当前显示英语简介。

  • Add required-field and duplicate checks
  • Validate references to parent entities
  • Build create, update, and delete migration actions
twentyhq/twenty6万2026年10月22日 更新

查看 twentyhq 的全部技能

报告此技能的问题