Brug ThunderPhone som en MCP-server

Byg, test, valider og administrer ThunderPhone-stemmeagenter fra Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code eller en anden Streamable HTTP MCP-klient.

ThunderPhone eksponerer en Streamable HTTP Model Context Protocol-server på:

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

Dette er den modsatte retning af at forbinde en ekstern MCP-server til en stemmeagent:

Godkendelse#

Brug som standard OAuth til katalogklienter: Log ind, vælg en organisation, og godkend de anmodede tilladelser. Tilbagekald adgang under Organisation → API-nøgler → Autoriserede apps.

For klienter, der er konfigureret med en API-nøgle, skal du oprette en sk_live_-nøgle under Organisation → Nøgler og eksponere den for din MCP-klient som THUNDERPHONE_API_KEY. Nøglen er knyttet til én organisation; et id, der ejes af en anden organisation, opfører sig som om, det ikke findes.

CLI- og stdio-alternativer#

ThunderPhone CLI kan skrive klientkonfiguration, mens ikke-relaterede servere bevares:

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

Efter en global installation af @thunderphone/mcp skal du bruge thunderphone-mcp setup med de samme indstillinger. Opsætning understøtter Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop og Windsurf. Direkte HTTP foretrækkes; Desktop bruger stdio.

For enhver klient, der understøtter stdio, skal du konfigurere command: "npx" med args: ["-y", "@thunderphone/mcp"]. Wrapperen bruger først THUNDERPHONE_API_KEY, derefter legitimationsoplysninger fra thunderphone login, opdaterer udløbne tokens og derefter OAuth via mcp-remote. Enhedslogin og OAuth kræver den tilsvarende API- OAuth-udrulning. API-nøglestien gør ikke. Direkte HTTP-konfigurationer læser ikke CLI-legitimationslageret; brug stdio-wrapperen for at genbruge enhedslogin.

Dette er alternativer til de manuelle klientkonfigurationer nedenfor.

Klientkonfiguration#

Claude og ChatGPT logger ind med OAuth; der bruges ingen API-nøgle. Hvis du endnu ikke har en ThunderPhone-konto, skal du vælge Opret konto på login-siden. Efter du har bekræftet din e-mail, vender du tilbage til godkendelsesskærmen.

Claude (web, desktop og mobil)#

1. Åbn Tilpas → Forbindelser (Indstillinger → Forbindelser i ældre versioner). Hvis ThunderPhone vises i oversigten over forbindelser, skal du vælge den. Ellers skal du vælge Tilføj brugerdefineret forbindelse, navngive den ThunderPhone og angive https://api.thunderphone.com/v1/mcp.
2. Vælg Forbind, log ind på ThunderPhone, vælg organisationen, og godkend tilladelserne.
3. Aktivér ThunderPhone fra værktøjsmenuen i en chat, og bed om det, du har brug for, f.eks. "Vis mine agenter".

Claude spørger, før den bruger hvert værktøj første gang. For at springe de fleste af disse forespørgsler over skal du åbne Tilpas → Forbindelser → ThunderPhone og indstille Skrivebeskyttede værktøjer til altid at være tilladt. Disse værktøjer slår kun ting op: agenter, opkald, transskriptioner, saldi og dokumentation. Lad Værktøjer til skrivning/sletning kræve godkendelse, hvis du vil se hver ændring, før den sker.

Brugerdefinerede forbindelser kræver et betalt Claude-abonnement. På Team- og Enterprise-abonnementer tilføjer en ejer først forbindelsen under organisationens forbindelsesindstillinger, hvorefter hvert medlem forbinder sin egen ThunderPhone-konto.

ChatGPT#

1. Hvis ThunderPhone vises i ChatGPTs appoversigt, skal du vælge den og oprette forbindelse.
2. Ellers skal du åbne Indstillinger → Apps og forbindelser → Avancerede indstillinger, slå Udviklertilstand til og oprette en forbindelse med URL-adressen https://api.thunderphone.com/v1/mcp og OAuth-godkendelse.
3. Log ind på ThunderPhone, vælg organisationen, og godkend tilladelserne. Føj ThunderPhone til en chat fra værktøjsmenuen.

Sletning af en agent eller et telefonnummer, kassering af et udkast, lancering af en kampagne og afsendelse af en testanmodning, der kan skrive til et eksternt system, kræver en ekstra bekræftelse i begge apps. Se Bekræftelse af destruktive handlinger.

Claude Code#

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

Codex#

Føj dette til ~/.codex/config.toml:

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

Cursor#

Opret .cursor/mcp.json:

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

Claude Desktop#

Føj en mcp-remote-bro til Claude Desktop-konfigurationen:

{
  "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#

Opret .vscode/mcp.json, og indtast nøglen via VS Codes inputprompt:

{
  "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}"
      }
    }
  }
}

Værktøjer#

Alle værktøjer har MCP-annoteringer. I tabellerne betyder R skrivebeskyttet, D destruktiv, I idempotent og O interaktion med omverdenen/netværket. En tankestreg betyder, at der ikke er angivet noget hint.

Forbindelse#

Agenter#

Telefonnumre og operatører#

SMS#

Opkald#

Test og validering#

Viden#

Integrationer, webhooks og eksterne MCP-servere#

Kampagner#

Stemmer, fakturering og dokumentation#

Alle produktværktøjer bruger de samme REST-kodestier som det offentlige API. REST-validering, organisationsafgrænsning, roller, faktureringsadgang, kvoter, TCPA-bekræftelse, udbydersikkerhed og revisionsadfærd gælder derfor uændret.

Bekræftelse af destruktive handlinger#

Værktøjer markeret med D ændrer eller fjerner noget eller begynder at ringe til rigtige personer. De, der ikke kan fortrydes, kræver to anmodninger. Den første anmodning ændrer ikke noget og returnerer:

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

Assistenten viser brugeren, hvad der påvirkes, og beder om et ja. Derefter gentager den anmodningen med de samme argumenter plus confirmation_token. En token er gyldig i 10 minutter og dækker én organisation, ét værktøj og ét præcist sæt argumenter, så sletning af tre agenter kræver tre bekræftelser. campaign_action med pause eller stop springer dette trin over, så en kørende kampagne altid kan stoppes med det samme, og det samme gælder test_integration med GET. Nogle D-værktøjer kører i én anmodning, fordi D angiver deres effekt, ikke en bekræftelse på serversiden: update_agent erstatter det, kladden indeholdt (discard_agent_draft gendanner det), deploy_agent erstatter den aktive konfiguration, update_phone_number omdirigerer aktive opkald, sync_mcp_server_tools erstatter et fjernservers værktøjskatalog, import_voip_numbers omdirigerer numre til din operatør, run_agent_tests kan bruge kredit, send_sms og place_call kontakter en rigtig person (place_call beholder sin egen samtykkebekræftelse), og provision_phone_number køber et nummer. Din MCP-klient kan stadig bede dig om at godkende dem.

Startprompter#

prompts/list tilbyder fem genanvendelige arbejdsgange:

• create_inbound_receptionist
• run_agent_tests
• buy_and_attach_number
• review_low_grade_calls
• add_url_to_agent_knowledge

Brug prompts/get med det angivne promptnavn og dets deklarerede argumenter for at modtage en klar-til-kørsel-brugermeddelelse.

Ressourcer#

resources/list eksponerer offentlige, cachelagrede referencer:

Læs en ressource med resources/read. Offentlige hentninger bruger en kort timeout, en grænse på 2 MiB og en ti minutters cache i processen.

Protokol og fejl#

Serveren understøtter protokolversionerne 2025-06-18 og 2025-03-26; den gengiver en understøttet klientversion og vælger ellers 2025-06-18. Den implementerer initialize, ping, værktøjer, prompter, ressourcer og notifikationer. Notifikationer returnerer 202 Accepted. Denne tilstandsløse server eksponerer ikke en SSE-lytter eller sletning af sessioner, så GET og DELETE returnerer 405 Method Not Allowed med Allow: POST.

Værktøjsfejl forbliver vellykkede JSON-RPC-svar med isError: true. Deres tekst indeholder en kort sætning efterfulgt af en JSON-blok:

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

Det særskilte præfiks outbound_tcpa_confirmation_required: bevares for place_call. Ukendte JSON-RPC-metoder returnerer -32601 i et HTTP-200-svar. JSON-RPC-batches understøttes ikke af MCP 2025-06-18 og returnerer en ren -32600-fejl for ugyldig anmodning.