본문으로 건너뛰기
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(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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 / 1,000자

이 양식은 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월 23일 업데이트

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월 23일 업데이트

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월 23일 업데이트

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월 23일 업데이트

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월 23일 업데이트

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월 23일 업데이트

twentyhq의 스킬 모두 보기

이 스킬의 문제 신고