Używaj ThunderPhone jako serwera MCP

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:

Kierunek	Rezultat
Zdalny serwer MCP → agent ThunderPhone	Twój agent głosowy może wywoływać narzędzia zdalnego serwera.
ThunderPhone → Twój klient MCP	Twó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"
      }
    }
  }
}

Klucz sk_live_ może uzyskiwać dostęp do danych organizacji i wykonywać połączenia. Nie umieszczaj go w kodzie przeglądarkowym, repozytoriach, zrzutach ekranu ani dziennikach czatu. Użyj magazynu sekretów obsługiwanego przez klienta MCP i natychmiast unieważnij klucz, jeśli zostanie ujawniony.

Dostępne narzędzia

Narzędzie	Argumenty	Działanie
`list_agents`	brak	Wyświetla agentów organizacji wraz z identyfikatorem, nazwą, produktem i głosem.
`get_agent`	`agent_id`	Pobiera jednego agenta.
`place_call`	`agent_id`, `from_number`, `to_number`	Wykonuje połączenie wychodzące z takimi samymi zasadami walidacji i rozliczeń jak punkt końcowy REST dla połączeń.
`get_call`	`call_id`	Pobiera status połączenia, podsumowanie i ocenę.
`list_calls`	opcjonalny `limit` (1–100), opcjonalny `status`	Wyświetla ostatnie połączenia.
`get_call_transcript`	`call_id`	Pobiera 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.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

Używaj ThunderPhone jako serwera MCP

Uwierzytelnianie

Dostępne narzędzia

Metody protokołu

Bezpieczne wykonywanie połączeń

Pełna dokumentacja komunikacji

​Uwierzytelnianie

​Dostępne narzędzia

​Metody protokołu

​Bezpieczne wykonywanie połączeń

​Pełna dokumentacja komunikacji

Uwierzytelnianie

Dostępne narzędzia

Metody protokołu

Bezpieczne wykonywanie połączeń

Pełna dokumentacja komunikacji