Bruk ThunderPhone som en MCP-server

Bygg, test, valider og drift ThunderPhone-stemmeagenter fra Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code eller en annen Streamable HTTP MCP-klient.

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

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

Dette er motsatt retning av å koble en ekstern MCP-server til en stemmeagent:

Autentiser#

Bruk OAuth som standard for katalogklienter: logg inn, velg en organisasjon og godkjenn de forespurte tillatelsene. Tilbakekall tilgang under Organisasjon → API-nøkler → Autoriserte apper.

For klienter som er konfigurert med en API-nøkkel, opprett en sk_live_-nøkkel under Organisasjon → Nøkler og eksponer den for MCP-klienten din som THUNDERPHONE_API_KEY. Nøkkelen er knyttet til én organisasjon; en ID som eies av en annen organisasjon, oppfører seg som om den ikke finnes.

CLI- og stdio-alternativer#

ThunderPhone CLI kan skrive klientkonfigurasjon samtidig som uavhengige servere bevares:

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

Etter en global installasjon av @thunderphone/mcp bruker du thunderphone-mcp setup med de samme alternativene. Oppsett støtter Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop og Windsurf. Direkte HTTP foretrekkes; Desktop bruker stdio.

For enhver klient som støtter stdio, konfigurer command: "npx" med args: ["-y", "@thunderphone/mcp"]. Wrapperen bruker først THUNDERPHONE_API_KEY, deretter legitimasjon fra thunderphone login, og oppdaterer utløpte tokener, deretter OAuth gjennom mcp-remote. Enhetsinnlogging og OAuth krever at den tilsvarende API- OAuth-funksjonen er rullet ut. API-nøkkelbanen gjør ikke det. Direkte HTTP-konfigurasjoner leser ikke CLI-legitimasjonslageret; bruk stdio-wrapperen for å gjenbruke enhetsinnlogging.

Dette er alternativer til de manuelle klientkonfigurasjonene nedenfor.

Klientkonfigurasjon#

Claude og ChatGPT logger inn med OAuth; ingen API-nøkkel er involvert. Hvis du ikke har en ThunderPhone-konto ennå, velger du Opprett konto på innloggingssiden og kommer tilbake til godkjenningsskjermen etter at du har bekreftet e-postadressen din.

Claude (nett, skrivebord og mobil)#

1. Åpne Tilpass → Koblinger (Innstillinger → Koblinger i eldre versjoner). Hvis ThunderPhone vises i koblingskatalogen, velger du det. Ellers velger du Legg til egendefinert kobling, gir den navnet ThunderPhone og angir https://api.thunderphone.com/v1/mcp.
2. Velg Koble til, logg inn på ThunderPhone, velg organisasjonen og godkjenn tillatelsene.
3. I en chat aktiverer du ThunderPhone fra verktøymenyen og ber om det du trenger, for eksempel «Vis agentene mine».

Claude spør før det bruker hvert verktøy for første gang. For å hoppe over de fleste av disse spørsmålene åpner du Tilpass → Koblinger → ThunderPhone og angir Skrivebeskyttede verktøy til alltid å tillate. Disse verktøyene slår bare opp informasjon: agenter, samtaler, transkripsjoner, saldoer og dokumentasjon. La Verktøy for skriving/sletting kreve godkjenning hvis du vil se hver endring før den skjer.

Egendefinerte koblinger krever et betalt Claude-abonnement. I Team- og Enterprise-abonnementer legger en eier først til koblingen under organisasjonens koblingsinnstillinger, og deretter kobler hvert medlem til sin egen ThunderPhone-konto.

ChatGPT#

1. Hvis ThunderPhone vises i ChatGPTs appkatalog, velger du det og kobler til.
2. Ellers åpner du Innstillinger → Apper og koblinger → Avanserte innstillinger, slår på Utviklermodus og oppretter en kobling med URL-en https://api.thunderphone.com/v1/mcp og OAuth-autentisering.
3. Logg inn på ThunderPhone, velg organisasjonen og godkjenn tillatelsene. Legg til ThunderPhone i en chat fra verktøymenyen.

Sletting av en agent eller et telefonnummer, forkasting av et utkast, lansering av en kampanje og sending av en testforespørsel som kan skrive til et eksternt system krever en ekstra bekreftelse i begge appene. Se Bekrefte destruktive handlinger.

Claude Code#

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

Codex#

Legg dette til i ~/.codex/config.toml:

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

Cursor#

Opprett .cursor/mcp.json:

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

Claude Desktop#

Legg til en mcp-remote-bro i Claude Desktop-konfigurasjonen:

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

Opprett .vscode/mcp.json og angi nøkkelen via VS Codes inndatadialog:

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

Verktøy#

Alle verktøy har MCP-merknader. I tabellene betyr R skrivebeskyttet, D destruktivt, I idempotent og O samhandling med åpen verden/nettverk. En bindestrek betyr at ingen merknad er angitt.

Tilkobling#

Agenter#

Telefonnummer og operatører#

SMS#

Samtaler#

Testing og validering#

Kunnskap#

Integrasjoner, webhooks og eksterne MCP-servere#

Kampanjer#

Stemmer, fakturering og dokumentasjon#

Alle produktverktøy bruker de samme REST-kodebanene som det offentlige API-et. REST-validering, organisasjonsavgrensning, roller, faktureringsgodkjenning, kvoter, TCPA-bekreftelse, leverandørsikkerhet og revisjonsatferd gjelder derfor uendret.

Bekreftelse av destruktive handlinger#

Verktøy merket med D endrer eller fjerner noe, eller begynner å ringe ekte personer. De som ikke kan angres, krever to forespørsler. Den første forespørselen endrer ingenting 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 brukeren hva som påvirkes, og ber om et ja. Deretter gjentar den forespørselen med de samme argumentene pluss confirmation_token. En token er gyldig i 10 minutter og gjelder for én organisasjon, ett verktøy og ett eksakt sett med argumenter, så sletting av tre stemmeagenter krever tre bekreftelser. campaign_action med pause eller stop hopper over dette trinnet, slik at en aktiv kampanje alltid kan stanses umiddelbart, og det samme gjør test_integration med GET. Enkelte D-verktøy kjøres med én forespørsel fordi D-en angir effekten deres, ikke en bekreftelse på serversiden: update_agent erstatter det utkastet hadde (discard_agent_draft tilbakestiller det), deploy_agent erstatter den aktive konfigurasjonen, update_phone_number ruter aktive samtaler på nytt, sync_mcp_server_tools erstatter verktøykatalogen til en ekstern server, import_voip_numbers peker numre på nytt til operatøren din, run_agent_tests kan bruke kreditt, send_sms og place_call når en ekte person (place_call beholder sin egen samtykkebekreftelse), og provision_phone_number kjøper et nummer. MCP-klienten din kan fortsatt be deg om å godkjenne dem.

Startmeldinger#

prompts/list viser fem gjenbrukbare arbeidsflyter:

• create_inbound_receptionist
• run_agent_tests
• buy_and_attach_number
• review_low_grade_calls
• add_url_to_agent_knowledge

Bruk prompts/get med det oppførte promptnavnet og de deklarerte argumentene for å motta en klar brukerforespørsel.

Ressurser#

resources/list eksponerer offentlige, hurtigbufrede referanser:

Les en ressurs med resources/read. Offentlige hentinger bruker en kort tidsavbruddsgrense, en grense på 2 MiB og en ti minutters hurtigbuffer i prosessen.

Protokoll og feil#

Serveren støtter protokollversjonene 2025-06-18 og 2025-03-26; den gjentar en støttet klientversjon og velger ellers 2025-06-18. Den implementerer initialize, ping, verktøy, prompter, ressurser og varsler. Varsler returnerer 202 Accepted. Denne tilstandsløse serveren eksponerer ikke en SSE-lytter eller sletting av økter, så GET og DELETE returnerer 405 Method Not Allowed med Allow: POST.

Verktøyfeil forblir vellykkede JSON-RPC-svar med isError: true. Teksten inneholder en kort setning etterfulgt av en JSON-blokk:

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

Det distinkte prefikset outbound_tcpa_confirmation_required: beholdes for place_call. Ukjente JSON-RPC-metoder returnerer -32601 i et HTTP-200-svar. JSON-RPC-batcher støttes ikke av MCP 2025-06-18 og returnerer en ren -32600-feil for ugyldig forespørsel.