ThunderPhone 2.0 jest już dostępny.Uruchom samodzielnie — od 2 centów/min.Przeczytaj komunikat
Zacznij korzystać

Connect tools & data

Używaj ThunderPhone jako serwera MCP

Połącz dowolnego klienta Streamable HTTP MCP z ThunderPhone, aby wyświetlać listę agentów, analizować połączenia i transkrypcje oraz wykonywać połączenia wychodzące za pomocą klucza API organizacji.

ThunderPhone udostępnia serwer Model Context Protocol pod adresem:

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

Skieruj klienta MCP na ten punkt końcowy Streamable HTTP, aby udostępnić agentów i połączenia swojej organizacji jako narzędzia. Jest to kierunek przeciwny do łączenia zdalnego serwera MCP z agentem głosowym:

KierunekRezultat
Zdalny serwer MCP → agent ThunderPhoneTwój agent głosowy może wywoływać narzędzia zdalnego serwera.
ThunderPhone → Twój klient MCPTwój klient MCP może wywoływać narzędzia ThunderPhone dla agentów i połączeń.

Uwierzytelnianie

Utwórz klucz sk_live_ w sekcji Organizacja → Klucze i wyślij go jako token Bearer. Punkt końcowy MCP akceptuje klucze API organizacji, a nie pliki cookie sesji panelu ani publikowalne klucze widżetu.

Generic client configuration
{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

Dostępne narzędzia

NarzędzieArgumentyDziałanie
list_agentsbrakWyświetla agentów organizacji wraz z identyfikatorem, nazwą, produktem i głosem.
get_agentagent_idPobiera jednego agenta.
place_callagent_id, from_number, to_numberWykonuje połączenie wychodzące z takimi samymi zasadami walidacji i rozliczeń jak punkt końcowy REST dla połączeń.
get_callcall_idPobiera status połączenia, podsumowanie i ocenę.
list_callsopcjonalny limit (1–100), opcjonalny statusWyświetla ostatnie połączenia.
get_call_transcriptcall_idPobiera pełną transkrypcję połączenia.

Wszystkie narzędzia są ograniczone do organizacji powiązanej z kluczem API. Identyfikator z innej organizacji zachowuje się jak niedostępny.

Metody protokołu

Punkt końcowy implementuje metody MCP JSON-RPC wymagane przez klientów Streamable HTTP:

  • initialize
  • notifications/initialized
  • tools/list
  • tools/call

Możesz bezpośrednio sprawdzić katalog narzędzi:

curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Wywołaj narzędzie, podając jego nazwę i argumenty:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}

Wyniki narzędzi są elementami treści tekstowej MCP. Błędy narzędzi są zwracane w wyniku z isError: true; nieznane metody JSON-RPC zwracają błąd protokołu.

Bezpieczne wykonywanie połączeń

place_call stosuje te same zasady co POST /v1/call: agent i numer muszą należeć do organizacji powiązanej z kluczem, numer musi kwalifikować się do połączeń wychodzących, organizacja musi mieć wystarczające saldo, a wszelkie wymagane potwierdzenia połączeń wychodzących muszą być ukończone.

Traktuj klienta z dostępem do place_call jak narzędzie do wykonywania połączeń produkcyjnych. Ogranicz, kto może korzystać z klienta, jasno określ w jego własnym poleceniu docelowego agenta i numer, a następnie sprawdzaj połączenia w Historii połączeń.

Pełna dokumentacja komunikacji

Przykłady odpowiedzi, błędy JSON-RPC i API do zarządzania zdalnymi serwerami znajdziesz w API serwerów MCP.