Skip to main content
Twenty zpřístupňuje server MCP, aby AI asistenti — Claude Desktop, Claude Code, Cursor, ChatGPT a další — mohli číst a zapisovat data vašeho CRM pomocí přirozeného jazyka. Použijte svou adresu URL pracovní oblasti (adresu URL, kterou používáte k přístupu k Twenty) jako koncový bod MCP. V Twenty Cloud může vaše adresa URL pracovní oblasti být https://{mycompany}.twenty.com nebo vlastní doména. Server je dostupný na:

Metody ověření

Máte dva způsoby, jak ověřit svého klienta MCP: OAuth (doporučeno) nebo klíč API.

Možnost A — OAuth (doporučeno)

S OAuth váš klient MCP otevře okno prohlížeče, abyste se mohli přihlásit. V konfiguračních souborech se neukládají žádné tajné údaje a tokeny se automaticky obnovují.
OAuth vyžaduje klienta MCP, který podporuje specifikaci autorizace MCP. Podporují ji Claude Desktop, Claude Code, Cursor a ChatGPT.
Přidejte toto do konfigurace svého klienta MCP a nahraďte {your-workspace-url} hostitelem vaší pracovní oblasti (např. mycompany.twenty.com):
To je vše — není potřeba žádný klíč API. Když se klient připojí poprvé, provede:
  1. Získá metadata OAuth služby Twenty pomocí /.well-known/oauth-protected-resource a /.well-known/oauth-authorization-server
  2. Zaregistruje se jako klient OAuth prostřednictvím dynamické registrace klienta (RFC 7591)
  3. Otevře váš prohlížeč k autorizaci přístupu
  4. Převezme tokeny a připojí se k serveru MCP
Následující připojení znovu použijí uložené tokeny a automaticky je obnoví.

Možnost B — klíč API

Pokud váš klient MCP nepodporuje OAuth, nebo dáváte přednost statickým přihlašovacím údajům, předejte klíč API v hlavičce Authorization:
Váš klíč API poskytuje přístup k datům pracovní oblasti. Nenechávejte jej ve verzovacím systému ani ve sdílených dotfiles.
Chcete-li vytvořit klíč API, přejděte do Settings → MCP & APIs → API → + Create key. Podrobnosti viz Rozhraní API.

Rychlý start

1. Zkopírujte konfiguraci

V Twenty přejděte do Settings → MCP & APIs → MCP. Vyberte metodu ověření (OAuth nebo klíč API), zkopírujte úryvek JSON (už bude používat adresu URL vaší pracovní oblasti) a vložte jej do konfiguračního souboru klienta MCP.

2. Připojení

Restartujte svého klienta MCP (nebo znovu načtěte konfiguraci). Pokud používáte OAuth, budete přesměrováni do Twenty k autorizaci přístupu. Pokud používáte klíč API, připojení je okamžité.

3. Začněte jej používat

Požádejte svého AI asistenta, aby pracoval s vaším CRM:
  • “Ukaž mi 5 nejnověji vytvořených společností”
  • “Vytvoř novou osobu jménem Jane Doe ve společnosti Acme Corp”
  • “Najdi všechny otevřené příležitosti s hodnotou vyšší než 10 000 $“

Dostupné nástroje

Po připojení server MCP zpřístupní nástroje, které odpovídají rozhraní Twenty API. Doporučený pracovní postup je:
  1. learn_tools — získat vstupní schéma pro konkrétní nástroje
  2. execute_tool — spustit nástroj
Není potřeba si pamatovat názvy nástrojů. Zeptejte se svého AI asistenta, co umí, a automaticky zavolá learn_tools.

Oprávnění

Připojení MCP dědí oprávnění ověřeného uživatele (OAuth) nebo roli přiřazenou ke klíči API. Chcete-li omezit, co může server MCP provádět:
  • OAuth: Platí role uživatele v pracovní oblasti.
  • Klíč API: Přiřaďte klíči API roli v Settings → Members → Roles. Viz Oprávnění.

Konfigurace pro self-hosting

U samostatně hostovaných instancí nahraďte {your-workspace-url} adresou URL svého serveru. Ujistěte se, že SERVER_URL ve vašem prostředí odpovídá veřejné adrese URL vaší instance Twenty — tato hodnota se používá k vygenerování metadat pro zjišťování OAuth.
Koncový bod MCP, koncové body OAuth a metadata pro zjišťování se z této hodnoty odvozují.

Řešení potíží

Chyby “Unauthorized” nebo 401
  • OAuth: Proveďte znovu autorizaci vymazáním uložených tokenů ve vašem klientovi MCP a znovu se připojte.
  • Klíč API: Ověřte, že je klíč platný a nevypršela mu platnost. V případě potřeby jej znovu vygenerujte.
Tok OAuth neotevírá prohlížeč
  • Ujistěte se, že váš klient MCP podporuje autorizaci MCP. Pokud ne, použijte metodu s klíčem API.
Časový limit připojení
  • Ověřte, že je adresa URL koncového bodu MCP dosažitelná z vašeho počítače. U samostatně hostovaných instancí zkontrolujte, že server běží a že je SERVER_URL nastaven správně.