Plivo über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Plivo klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Plivo + Gemini

Lass deine KI mit Plivo arbeiten: Guthaben und Preise prüfen, SMS und MMS senden, Anrufe tätigen und Anrufdatensätze lesen, laufende Anrufe beenden, Aufzeichnungen und Transkriptionen auflisten, Rufnummern finden und nachschlagen und Einmalcodes mit Verify senden und prüfen.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN

Schritt 1 — Zugangsdaten holen

1. Melde dich in der Plivo-Konsole unter https://cx.plivo.com an.
2. Kopiere auf der Übersichtsseite die Auth ID (sie beginnt mit MA, bei einem Unterkonto mit SA) und das Auth Token. Ein Unterkonto (Account → Subaccounts) begrenzt, was der Connector erreicht.
3. Füge sie in PLIVO_AUTH_ID und PLIVO_AUTH_TOKEN ein und installiere den Connector.
4. Prüfe die Einrichtung mit plivo_get_account: Es zeigt das Konto, die Abrechnungsart und das verbleibende Guthaben.

Ein Testkonto reicht zum Lesen; Senden und Anrufen brauchen Guthaben und im Testkonto verifizierte Nummern.

Wer was sieht: Das Auth Token handelt für das ganze Plivo-Konto und kann dessen Guthaben ausgeben. Teile den MCP-Server nur mit Personen, die darüber Geld ausgeben dürfen. Nachrichtenprotokolle, Anrufdatensätze, Telefonnummern, Aufzeichnungen und Transkriptionen sind personenbezogene Daten, und Aufzeichnungslinks kann jeder abspielen, der sie hat.

Kostet Geld und erreicht echte Menschen, deshalb fragt die KI vorher: Plivo berechnet plivo_send_message (SMS und MMS, pro Nachrichtenteil und Empfänger), plivo_make_call (pro Minute) und plivo_send_verification (pro Verifizierung plus SMS oder Anruf). Vor jedem dieser Aufrufe zeigt dir die KI Absender, Empfänger und Inhalt, auf Wunsch mit dem Preis aus plivo_get_pricing, und wartet auf dein Ja. plivo_lookup_number kostet pro Abfrage, deshalb nennt dir die KI Anzahl und Kosten, bevor sie mehr als ein paar Nummern nachschlägt.

Bei der Installation deaktiviert: plivo_buy_number, das eine Nummer gegen eine Einrichtungsgebühr und eine Monatsmiete mietet, bis sie freigegeben wird; die Suche mit plivo_search_available_numbers ist kostenlos. Auch plivo_hangup_call ist aus: Es beendet einen laufenden Anruf, und Plivo beendet jeden laufenden Anruf des Kontos, wenn die Anruf-ID fehlt. Ein Administrator schaltet sie bewusst ein; die KI zeigt dir dann die Nummer mit ihren Kosten oder den Anruf mit Nummern und Startzeit und handelt erst nach deiner Bestätigung.

SMS: plivo_send_message liefert eine message_uuid; plivo_get_message zeigt Zustellstatus, abgerechnete Teile und Preis, und plivo_list_messages gibt einen Überblick über deinen Verkehr (ohne Nachrichtentext). Ein Absender in den USA oder Kanada muss für 10DLC oder Toll-free-Texting registriert sein, sonst scheitern die Nachrichten.

Anrufe brauchen eine Answer URL: plivo_make_call ruft die Nummer an und holt beim Annehmen deine answer_url ab, die Plivo XML von deinem Server liefern muss (zum Beispiel <Response><Speak>Hallo</Speak></Response>). Ein time_limit deckelt die Kosten. Laufende Anrufe: plivo_list_live_calls und plivo_get_live_call. Beendete Anrufe: plivo_list_calls und plivo_get_call, mit Dauer, abgerechneter Dauer, Preis und Grund für das Auflegen. Aufzeichnungen: plivo_list_recordings, plivo_get_recording und plivo_get_transcription, wenn für die Aufzeichnung eine Transkription (eine kostenpflichtige Plivo-Option) bestellt wurde.

Verify: plivo_send_verification sendet einen Einmalcode per SMS oder Sprachanruf, plivo_validate_verification prüft den Code, den die Person eingegeben hat (jeder Versuch zählt zum Versuchslimit), und plivo_get_verification zeigt Status und Kosten.

Nummern und Zeiten: Sende Nummern im Format E.164 (+4915112345678); Plivo listet sie ohne Plus. Zeitfilter sind in UTC als YYYY-MM-DD HH:MM:SS. Suchen nach Anrufen und Aufzeichnungen umfassen die letzten 7 Tage, wenn du keinen Zeitraum angibst, höchstens 30 Tage pro Suche.

Ratenlimit: 300 Anfragen pro 5 Sekunden und Konto; für abgehende Anrufe gelten außerdem ein Limit für Anrufe pro Sekunde und eines für gleichzeitige Anrufe (403 Concurrency Limit Breached). Ein 429 heißt: kurz warten und erneut versuchen.

Häufige Fehler: 401: Auth ID oder Auth Token sind falsch, oder das Token wurde neu erzeugt. 403: ein Unterkonto ohne Zugriff oder eine IP-Beschränkung unter API access control. 404: Diese Nachricht, diesen Anruf, diese Aufzeichnung oder diese Nummer gibt es in diesem Konto nicht. 400: Ein Parameter fehlt oder ist falsch, etwa das Nummernformat oder ein Absender, der nicht zum Konto gehört. Senden oder Anrufen scheitert an zu wenig Guthaben: Prüfe das Guthaben mit plivo_get_account und lade es in der Konsole auf.

Nicht abgedeckt sind WhatsApp-Vorlagen, Konferenzen und Anrufe mit mehreren Teilnehmern, das Weiterleiten von Anrufen und die Steuerung von Aufzeichnungen, Applications und Endpoints, Unterkonten, Compliance-Dokumente sowie die Freigabe von Nummern.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Plivo-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie hoch ist unser Plivo-Guthaben, und was kostet eine ausgehende SMS nach Deutschland?“
• „Schick eine SMS von unserer Plivo-Nummer an +4915112345678, dass der Termin am Freitag um 10 Uhr bestätigt ist. Zeig mir vorher Absender, Empfänger, Text und Preis.“
• „Welche Nachrichten von gestern wurden nicht zugestellt oder sind fehlgeschlagen? Zeig mir die Fehlercodes und was sie gekostet haben.“
• „Liste die Anrufe der letzten 7 Tage auf, die länger als fünf Minuten gedauert haben, mit abgerechneter Dauer, Preis und Grund für das Auflegen.“
• „Schick einen Verifizierungscode per SMS an +4915112345678 und frag mich vorher. Prüf danach den Code, den mir der Kunde vorliest.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden