Använd ThunderPhone som en MCP-server

Bygg, testa, validera och hantera ThunderPhone-röstagenter från Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code eller en annan Streamable HTTP MCP-klient.

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

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

Detta är motsatt riktning jämfört med att ansluta en fjärransluten MCP-server till en röstagent:

Autentisera#

Använd OAuth som standard för katalogklienter: logga in, välj en organisation och godkänn de begärda behörigheterna. Återkalla åtkomst under Organisation → API-nycklar → Auktoriserade appar.

För klienter som konfigurerats med en API-nyckel skapar du en sk_live_-nyckel under Organisation → Nycklar och exponerar den för din MCP-klient som THUNDERPHONE_API_KEY. Nyckeln är bunden till en organisation; ett ID som ägs av en annan organisation behandlas som om det inte hittades.

CLI- och stdio-alternativ#

ThunderPhone CLI kan skriva klientkonfiguration samtidigt som andra servrar bevaras:

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 av @thunderphone/mcp använder du thunderphone-mcp setup med samma alternativ. Konfigurationen stöder Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop och Windsurf. Direkt HTTP rekommenderas; Desktop använder stdio.

För alla klienter som stöder stdio konfigurerar du command: "npx" med args: ["-y", "@thunderphone/mcp"]. Wrappen använder först THUNDERPHONE_API_KEY, sedan autentiseringsuppgifter från thunderphone login, uppdaterar utgångna token och därefter OAuth via mcp-remote. Enhetsinloggning och OAuth kräver motsvarande API- OAuth-utrullning. API-nyckelsökvägen gör inte det. Direkta HTTP-konfigurationer läser inte CLI:ts autentiseringslagring; använd stdio-wrappen för att återanvända enhetsinloggning.

Dessa är alternativ till de manuella klientkonfigurationerna nedan.

Klientkonfiguration#

Claude och ChatGPT loggar in med OAuth; ingen API-nyckel används. Om du ännu inte har ett ThunderPhone-konto väljer du Skapa konto på inloggningssidan och återvänder till godkännandeskärmen efter att du har verifierat din e-postadress.

Claude (webb, dator och mobil)#

1. Öppna Anpassa → Anslutningar (Inställningar → Anslutningar i äldre versioner). Om ThunderPhone visas i anslutningskatalogen väljer du det. Annars väljer du Lägg till egen anslutning, namnger den ThunderPhone och anger https://api.thunderphone.com/v1/mcp.
2. Välj Anslut, logga in på ThunderPhone, välj organisation och godkänn behörigheterna.
3. Aktivera ThunderPhone i verktygsmenyn i en chatt och be om det du behöver, till exempel ”Lista mina agenter”.

Claude frågar innan det använder varje verktyg för första gången. För att hoppa över de flesta av dessa uppmaningar öppnar du Anpassa → Anslutningar → ThunderPhone och ställer in Skrivskyddade verktyg på alltid tillåtna. Dessa verktyg hämtar bara information: agenter, samtal, transkriptioner, saldon och dokumentation. Låt Verktyg för att skriva/ta bort kräva godkännande om du vill se varje ändring innan den sker.

Egna anslutningar kräver en betald Claude-plan. I Team- och Enterprise-planer lägger en ägare först till anslutningen i organisationens anslutningsinställningar, och sedan ansluter varje medlem sitt eget ThunderPhone-konto.

ChatGPT#

1. Om ThunderPhone visas i ChatGPT:s appkatalog väljer du det och ansluter.
2. Annars öppnar du Inställningar → Appar och anslutningar → Avancerade inställningar, aktiverar Utvecklarläge och skapar en anslutning med URL:en https://api.thunderphone.com/v1/mcp och OAuth-autentisering.
3. Logga in på ThunderPhone, välj organisation och godkänn behörigheterna. Lägg till ThunderPhone i en chatt från verktygsmenyn.

Om du raderar en agent eller ett telefonnummer, kasserar ett utkast, startar en kampanj eller skickar en testbegäran som kan skriva till ett externt system krävs en andra bekräftelse i båda apparna. Se Bekräfta destruktiva åtgärder.

Claude Code#

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

Codex#

Lägg till detta i ~/.codex/config.toml:

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

Cursor#

Skapa .cursor/mcp.json:

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

Claude Desktop#

Lägg till en mcp-remote-brygga i Claude Desktops konfiguration:

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

Skapa .vscode/mcp.json och ange nyckeln via VS Codes inmatningsdialog:

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

Verktyg#

Varje verktyg har MCP-annoteringar. I tabellerna betyder R skrivskyddad, D destruktiv, I idempotent och O interaktion med omvärlden/nätverket. Ett streck betyder att ingen indikator är angiven.

Anslutning#

Agenter#

Telefonnummer och operatörer#

SMS#

Samtal#

Testning och validering#

Kunskap#

Integrationer, webhooks och fjärranslutna MCP-servrar#

Kampanjer#

Röster, fakturering och dokumentation#

Alla produktverktyg använder samma REST-kodvägar som det offentliga API:et. REST-validering, organisationsavgränsning, roller, behörighetskontroll för fakturering, kvoter, TCPA-bekräftelse, leverantörssäkerhet och granskningsbeteende gäller därför utan förändringar.

Bekräfta destruktiva åtgärder#

Verktyg märkta med D ändrar eller tar bort något, eller börjar ringa riktiga personer. De som inte kan ångras kräver två förfrågningar. Den första förfrågan ändrar ingenting och returnerar:

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

Assistenten visar användaren vad som påverkas och ber om ett ja. Därefter upprepar den förfrågan med samma argument plus confirmation_token. En token är giltig i 10 minuter och gäller för en organisation, ett verktyg och en exakt uppsättning argument, så att ta bort tre agenter kräver tre bekräftelser. campaign_action med pause eller stop hoppar över det här steget så att en pågående kampanj alltid kan stoppas direkt, och detsamma gäller test_integration med GET. Vissa D-verktyg körs med en förfrågan eftersom D markerar deras effekt, inte en bekräftelse på serversidan: update_agent ersätter det som utkastet innehöll (discard_agent_draft återställer det), deploy_agent ersätter den aktiva konfigurationen, update_phone_number dirigerar om aktiva samtal, sync_mcp_server_tools ersätter en fjärrservers verktygskatalog, import_voip_numbers pekar om nummer till din operatör, run_agent_tests kan använda kredit, send_sms och place_call når en riktig person (place_call behåller sin egen samtyckesbekräftelse) och provision_phone_number köper ett nummer. Din MCP-klient kan fortfarande be dig att godkänna dem.

Startprompter#

prompts/list visar fem återanvändbara arbetsflöden:

• create_inbound_receptionist
• run_agent_tests
• buy_and_attach_number
• review_low_grade_calls
• add_url_to_agent_knowledge

Använd prompts/get med det angivna promptnamnet och dess deklarerade argument för att få ett körklart användarmeddelande.

Resurser#

resources/list exponerar offentliga, cachade referenser:

Läs en resurs med resources/read. Offentliga hämtningar använder en kort tidsgräns, en gräns på 2 MiB och en tiominuterscache i processen.

Protokoll och fel#

Servern stöder protokollversionerna 2025-06-18 och 2025-03-26; den ekar en klientversion som stöds och väljer annars 2025-06-18. Den implementerar initialize, ping, verktyg, prompter, resurser och notifieringar. Notifieringar returnerar 202 Accepted. Denna tillståndslösa server exponerar ingen SSE-lyssnare eller sessionsradering, så GET och DELETE returnerar 405 Method Not Allowed med Allow: POST.

Verktygsfel är fortfarande lyckade JSON-RPC-svar med isError: true. Deras text innehåller en kort mening följd av ett JSON-block:

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

Det distinkta prefixet outbound_tcpa_confirmation_required: behålls för place_call. Okända JSON-RPC-metoder returnerar -32601 i ett HTTP-200-svar. JSON-RPC-batchar stöds inte av MCP 2025-06-18 och returnerar ett tydligt -32600-fel för ogiltig förfrågan.