Používajte ThunderPhone ako server MCP

Vytvárajte, testujte, overujte a prevádzkujte hlasových agentov ThunderPhone z Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code alebo iného klienta Streamable HTTP MCP.

ThunderPhone poskytuje server Streamable HTTP Model Context Protocol na adrese:

https://api.thunderphone.com/v1/mcp

Ide o opačný smer než pri pripojení vzdialeného servera MCP k hlasovému agentovi:

Overenie totožnosti#

Pre klientov z adresára predvolene použite OAuth: prihláste sa, vyberte organizáciu a schváľte požadované oprávnenia. Prístup odvolajte v časti Organizácia → Kľúče API → Autorizované aplikácie.

Pre klientov nakonfigurovaných pomocou kľúča API vytvorte kľúč sk_live_ v časti Organizácia → Kľúče a sprístupnite ho klientovi MCP ako THUNDERPHONE_API_KEY. Kľúč je viazaný na jednu organizáciu; identifikátor vlastnený inou organizáciou sa správa, akoby nebol nájdený.

Alternatívy CLI a stdio#

ThunderPhone CLI môže zapisovať konfiguráciu klienta pri zachovaní nesúvisiacich serverov:

npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope user

Po globálnej inštalácii @thunderphone/mcp použite thunderphone-mcp setup s rovnakými možnosťami. Nastavenie podporuje Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop a Windsurf. Uprednostňuje sa priame HTTP; Desktop používa stdio.

Pre ľubovoľného klienta podporujúceho stdio nakonfigurujte command: "npx" s args: ["-y", "@thunderphone/mcp"]. Obal najskôr používa THUNDERPHONE_API_KEY, potom poverenia z príkazu thunderphone login, pričom obnovuje tokeny po uplynutí platnosti, a následne OAuth prostredníctvom mcp-remote. Prihlásenie zariadenia a OAuth vyžadujú príslušné zavedenie OAuth v API. Cesta s kľúčom API ho nevyžaduje. Konfigurácie priameho HTTP nečítajú úložisko poverení CLI; na opätovné použitie prihlásenia zariadenia použite obal stdio.

Tieto možnosti sú alternatívou k manuálnym konfiguráciám klienta uvedeným nižšie.

Konfigurácia klienta#

Claude a ChatGPT používajú prihlásenie cez OAuth; nepoužíva sa žiadny kľúč API. Ak ešte nemáte účet ThunderPhone, na prihlasovacej stránke vyberte Vytvoriť účet. Po overení e-mailu sa vrátite na obrazovku schválenia.

Claude (web, počítač a mobil)#

1. Otvorte Nastavenia → Konektory. Ak sa ThunderPhone zobrazí v adresári konektorov, vyberte ho. V opačnom prípade vyberte Pridať vlastný konektor, pomenujte ho ThunderPhone a zadajte https://api.thunderphone.com/v1/mcp.
2. Vyberte Pripojiť, prihláste sa do ThunderPhone, vyberte organizáciu a schváľte oprávnenia.
3. V chate povoľte ThunderPhone v ponuke nástrojov a požiadajte o to, čo potrebujete, napríklad „Zobraziť zoznam mojich agentov“.

Vlastné konektory vyžadujú platený program Claude. V programoch Team a Enterprise vlastník najprv pridá konektor v nastaveniach konektorov organizácie a potom si každý člen pripojí vlastný účet ThunderPhone.

ChatGPT#

1. Ak sa ThunderPhone zobrazí v adresári aplikácií ChatGPT, vyberte ho a pripojte sa.
2. V opačnom prípade otvorte Nastavenia → Aplikácie a konektory → Rozšírené nastavenia, zapnite Režim vývojára a vytvorte konektor s adresou URL https://api.thunderphone.com/v1/mcp a overovaním OAuth.
3. Prihláste sa do ThunderPhone, vyberte organizáciu a schváľte oprávnenia. Pridajte ThunderPhone do chatu z ponuky nástrojov.

Odstránenie agenta alebo telefónneho čísla, zahodenie konceptu a spustenie kampane vyžadujú v oboch aplikáciách druhé potvrdenie; pozrite si Potvrdzovanie deštruktívnych akcií.

Claude Code#

claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
  --header "Authorization: Bearer $THUNDERPHONE_API_KEY"

Codex#

Pridajte toto do súboru ~/.codex/config.toml:

[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"

Cursor#

Vytvorte súbor .cursor/mcp.json:

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

Claude Desktop#

Pridajte most mcp-remote do konfigurácie Claude Desktop:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.thunderphone.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${THUNDERPHONE_API_KEY}"
      ],
      "env": {
        "THUNDERPHONE_API_KEY": "sk_live_YOUR_API_KEY"
      }
    }
  }
}

VS Code#

Vytvorte súbor .vscode/mcp.json a zadajte kľúč prostredníctvom výzvy na zadanie vo VS Code:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "thunderphone-api-key",
      "description": "ThunderPhone organization API key",
      "password": true
    }
  ],
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:thunderphone-api-key}"
      }
    }
  }
}

Nástroje#

Každý nástroj obsahuje anotácie MCP. V tabuľkách R znamená iba na čítanie, D deštruktívny, I idempotentný a O interakciu s otvoreným svetom alebo sieťou. Pomlčka znamená, že nie je nastavená žiadna nápoveda.

Agenti#

Telefónne čísla a operátori#

Hovory#

Testovanie a overovanie#

Znalosti#

Integrácie, webhooky a vzdialené servery MCP#

Kampane#

Hlasy, fakturácia, importy a dokumentácia#

Všetky produktové nástroje používajú rovnaké cesty kódu REST ako verejné API. Overovanie REST, rozsah organizácie, roly, schvaľovanie fakturácie, kvóty, potvrdenie TCPA, bezpečnosť poskytovateľov a správanie auditu preto platia bez zmeny.

Potvrdzovanie deštruktívnych akcií#

Nástroje označené D menia alebo odstraňujú niečo, čo nemožno obnoviť, alebo začínajú vytáčať skutočné osoby. Vyžadujú dve požiadavky. Prvá požiadavka nič nemení a vráti:

{
  "status": "confirmation_required",
  "action": "Delete agent",
  "target": { "id": 195, "name": "Front Desk Receptionist" },
  "confirmation_token": "…",
  "expires_in_seconds": 600,
  "next_step": "…"
}

Asistent používateľovi zobrazí, čo bude ovplyvnené, a požiada o potvrdenie. Potom zopakuje požiadavku s rovnakými argumentmi a s parametrom confirmation_token. Token je platný 10 minút a vzťahuje sa na jednu organizáciu, jeden nástroj a jednu presnú sadu argumentov, takže odstránenie troch agentov vyžaduje tri potvrdenia. campaign_action s hodnotou pause alebo stop tento krok preskočí, aby bolo možné prebiehajúcu kampaň vždy okamžite zastaviť.

Úvodné prompty#

prompts/list ponúka šesť opakovane použiteľných pracovných postupov:

• create_inbound_receptionist
• run_agent_tests
• import_vapi_assistants
• buy_and_attach_number
• review_low_grade_calls
• add_url_to_agent_knowledge

Použite prompts/get s uvedeným názvom promptu a jeho deklarovanými argumentmi, aby ste získali správu používateľa pripravenú na spustenie.

Zdroje#

resources/list sprístupňuje verejné referencie uložené vo vyrovnávacej pamäti:

Jeden zdroj načítajte pomocou resources/read. Verejné načítania používajú krátky časový limit, limit 2 MiB a desaťminútovú vyrovnávaciu pamäť v procese.

Protokol a chyby#

Server podporuje verzie protokolu 2025-06-18 a 2025-03-26; vráti podporovanú verziu klienta a inak vyberie 2025-06-18. Implementuje initialize, ping, nástroje, prompty, zdroje a oznámenia. Oznámenia vracajú 202 Accepted. Tento bezstavový server nesprístupňuje poslucháč SSE ani odstránenie relácie, takže GET a DELETE vracajú 405 Method Not Allowed s hodnotou Allow: POST.

Zlyhania nástrojov zostávajú úspešnými odpoveďami JSON-RPC s hodnotou isError: true. Ich text obsahuje krátku vetu, po ktorej nasleduje blok JSON:

{
  "code": "insufficient_balance",
  "detail": "There is not enough prepaid balance.",
  "next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}

Rozlišovací prefix outbound_tcpa_confirmation_required: zostáva zachovaný pre place_call. Neznáme metódy JSON-RPC vracajú -32601 v odpovedi HTTP 200. Dávky JSON-RPC nie sú podporované v MCP 2025-06-18 a vracajú čistú chybu neplatnej požiadavky -32600.