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.
{your-workspace-url} hostitelem vaší pracovní oblasti (např. mycompany.twenty.com):
- Získá metadata OAuth služby Twenty pomocí
/.well-known/oauth-protected-resourcea/.well-known/oauth-authorization-server - Zaregistruje se jako klient OAuth prostřednictvím dynamické registrace klienta (RFC 7591)
- Otevře váš prohlížeč k autorizaci přístupu
- Převezme tokeny a připojí se k serveru MCP
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čceAuthorization:
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:learn_tools— získat vstupní schéma pro konkrétní nástrojeexecute_tool— spustit nástroj
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.
Ř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.
- Ujistěte se, že váš klient MCP podporuje autorizaci MCP. Pokud ne, použijte metodu s klíčem API.
- 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_URLnastaven správně.