Propojte Ringhum s Claude a dalšími AI nástroji (MCP)

Ringhum má MCP server. MCP (Model Context Protocol) je standardní způsob, jak AI aplikace využívají vnější nástroje. Jakmile Ringhum propojíte s AI aplikací, jako je Claude nebo ChatGPT, můžete se jí ptát na váš pracovní prostor v běžném jazyce. Například: „Shrň včerejší zmeškané hovory“, „Kteří volající tento týden požádali o zavolání zpět?“ nebo „Přidej naši novou otevírací dobu do častých dotazů“. AI aplikace pracuje podle stejných pravidel a oprávnění jako API Ringhum.

Co potřebujete

• URL serveru: https://ringhum.com/mcp. Zobrazuje se také na kartě MCP server na stránce Vývojáři, s tlačítkem Kopírovat.
• AI aplikaci, která podporuje vzdálené MCP servery, například Claude, ChatGPT, Claude Code, Cursor, Windsurf nebo VS Code.
• Roli Vlastník nebo Správce v pracovním prostoru. Aplikaci propojit nebo API klíč vytvořit mohou jen vlastníci a správci.

Existují dva způsoby propojení. Přihlášení je nejjednodušší a hodí se pro chatovací aplikace jako Claude a ChatGPT. API klíč se hodí pro vývojářské nástroje, které přijímají URL a hlavičku.

Přístup jen pro čtení, nebo pro čtení a změny

Vy volíte, kolik toho AI aplikace smí dělat.

S přístupem jen pro čtení nejsou aplikaci vůbec nabízeny nástroje, které cokoli mění.

Důležité: S přístupem pro změny může AI aplikace vašim zákazníkům posílat skutečné zprávy a uskutečňovat skutečné hovory. Ringhum tyto nástroje označuje jako přesahující mimo váš pracovní prostor a mazání jako destruktivní, takže se vás většina AI aplikací před jejich spuštěním zeptá. Než schválíte, přečtěte si, co aplikace chystá udělat.

Propojení Claude přihlášením

1. V Claude (na webu, v desktopové nebo mobilní aplikaci) otevřete Nastavení → Konektory a zvolte Přidat vlastní konektor.
2. Vložte jako URL https://ringhum.com/mcp a uložte.
3. Klikněte na Připojit. Otevře se stránka Ringhum. Pokud budete vyzváni, přihlaste se.
4. Na stránce Připojit zvolte Workspace, který aplikace smí používat.
5. V sekci Co smí dělat zvolte Vyhledávat, nebo Vyhledávat a provádět změny.
6. Klikněte na Povolit. Vrátíte se zpět do Claude.

Aplikace nikdy nevidí vaše heslo. Přesné názvy nabídek v Claude se mohou postupem času měnit; hledejte konektory nebo integrace v jejím nastavení.

ChatGPT: přidejte URL jako vlastní konektor (MCP server) v Nastavení → Aplikace a konektory, poté klikněte na Připojit a postupujte podle kroků 3 až 6.

Claude Code: spusťte níže uvedený příkaz, poté spusťte /mcp a zvolte Authenticate.

claude mcp add --transport http ringhum https://ringhum.com/mcp

Jakmile přístup povolíte, propojení se samo obnovuje, dokud jej používáte. Pokud aplikaci 90 dní nepoužijete, budete ji muset propojit znovu.

Propojení pomocí API klíče

Použijte to pro nástroje, které umožňují nastavit hlavičku požadavku, nebo když se nechcete přihlašovat.

1. Ve Vývojáři vytvořte API klíč. Zaškrtněte jen read pro propojení jen pro čtení, nebo read a write, chcete-li povolit změny. Viz API klíče a rozsahy.
2. Přidejte server do své aplikace s klíčem v hlavičce Authorization.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf a Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Aplikace, která umí spouštět jen lokální servery, se může propojit přes npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Co nástroje pokrývají

Jako nástroj je dostupná každá operace v API Ringhum: váš účet a využití, asistenti, telefonní čísla, hovory a přepisy, kontakty, termíny a dostupnost, objednávky a produkty, rezervace pokojů, doručená pošta, textové zprávy a WhatsApp, kampaně, webhooky, profil firmy, služby, časté dotazy a znalostní báze, nezodpovězené otázky, platební odkazy, žádosti o recenzi, příjmy a ochrana proti spamu. Jedinou výjimkou jsou nahrávky hovorů: jako nástroj dostupné nejsou.

Každý nástroj spouští odpovídající požadavek API, takže platí stejné limity tarifu, ověřování i limity počtu požadavků. Volání nástrojů se počítají do limitu API 120 požadavků za minutu. Úplný seznam nástrojů je v sekci MCP dokumentace API na /docs.

Zobrazení a odpojení propojených aplikací

Aplikace, které jste propojili přihlášením, jsou uvedené ve Vývojáři v sekci Připojené AI aplikace, s tím, kdo je propojil, jejich Přístup (Pouze čtení nebo Čtení a úpravy) a kdy byly naposledy použity.

Chcete-li aplikaci odebrat, klikněte na Odpojit a potvrďte. Okamžitě ztratí přístup a musí být znovu schválena. Chcete-li změnit přístup aplikace, odpojte ji a propojte znovu s druhou volbou.

U propojení vytvořeného pomocí API klíče klíč odvolejte v API klíče.

Řešení potíží

„Only owners and admins of a workspace can connect apps.“ Požádejte vlastníka pracovního prostoru, aby aplikaci propojil, nebo aby vás udělal Správcem. Viz Pozvěte svůj tým.

„The sign-in request expired. Start connecting again from your AI app.“ Stránka schválení byla otevřená příliš dlouho. Začněte znovu z AI aplikace.

Aplikace tvrdí, že není autorizovaná, nebo vás žádá o opětovné přihlášení. Aplikace byla odpojena, klíč byl odvolán, nebo už nejste členem pracovního prostoru. Propojte ji znovu.

Aplikace nemůže provádět změny. Byla propojena s přístupem jen pro čtení, nebo jejímu API klíči chybí oprávnění write.

Aplikace se dívá na špatný pracovní prostor. Požádejte ji, ať zavolá who_am_i a ověří to. Každé propojení používá jeden pracovní prostor. Odpojte ji a propojte znovu, abyste zvolili jiný.