Telnyx über MCP mit Gemini verbinden

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

Telnyx + Gemini

Lass deine KI mit Telnyx arbeiten: Guthaben und Nutzung prüfen, Rufnummern auflisten und suchen, SMS und MMS senden, Anrufe tätigen, die eine Nachricht vorlesen, Anrufaufzeichnungen und Detaildatensätze lesen, Nummern nachschlagen, Einmalcodes mit Verify senden und prüfen und deine KI-Assistenten ansehen.

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:

TELNYX_API_KEY

Schritt 1 — Zugangsdaten holen

1. Melde dich im Mission Control Portal unter https://portal.telnyx.com an.
2. Öffne Account settings → Keys & Credentials → API Keys und klicke auf Create API Key. Der Schlüssel beginnt mit KEY, und Telnyx zeigt ihn nur einmal an.
3. Füge ihn so in TELNYX_API_KEY ein, wie Telnyx ihn anzeigt, ohne das Wort Bearer, und installiere den Connector. Der Schlüssel geht nur an api.telnyx.com.
4. Prüfe die Einrichtung mit telnyx_get_balance: Das ist kostenlos und zeigt Guthaben, Kreditlimit und Währung.

Wer was sieht: Der Schlüssel handelt für das ganze Telnyx-Konto, samt Guthaben. Teile den MCP-Server nur mit Personen, die darüber Geld ausgeben dürfen.

Kostet Geld und erreicht echte Menschen, deshalb fragt die KI vorher: Telnyx berechnet telnyx_send_message (SMS und MMS), telnyx_dial_call (pro Minute), telnyx_speak_text (Sprachausgabe) und telnyx_send_verification (pro Verifizierung). Vor jedem dieser Aufrufe zeigt dir die KI Empfänger, Absender und Inhalt und wartet auf dein Ja. telnyx_lookup_number kostet pro Abfrage, deshalb sagt dir die KI Bescheid, bevor sie viele Nummern nachschlägt. Senden, Anrufen und Kaufen setzen ein Konto mit Guthaben voraus.

Bei der Installation deaktiviert: telnyx_order_phone_numbers, das Rufnummern zu einem einmaligen Preis und einer Monatsgebühr pro Nummer kauft. Ein Administrator schaltet es bewusst ein; die KI zeigt dann jede Nummer mit ihren Kosten und kauft erst nach deiner Bestätigung. Die Suche nach Nummern mit telnyx_search_available_numbers ist kostenlos.

SMS: Eine Nummer sendet nur dann SMS, wenn sie einem Messaging-Profil zugeordnet ist (telnyx_list_messaging_profiles zeigt die Profile und die Länder, in die jedes senden darf). Eine neue Nachricht startet als queued; telnyx_get_message zeigt später den Zustellstatus pro Empfänger. Mit Medienlinks wird aus der Nachricht eine MMS (USA und Kanada).

Anrufe brauchen eine Call Control Application: Richte im Mission Control Portal eine ein und weise ihr die Nummer zu, von der du anrufst. telnyx_list_call_control_applications liefert die connection_id, die telnyx_dial_call braucht. Die KI wählt, prüft mit telnyx_get_call_status, bis der Anruf angenommen ist, spricht deine Nachricht mit telnyx_speak_text und beendet den Anruf mit telnyx_hangup_call. Ein Zeitlimit beim Wählen deckelt die Kosten. Anruf-Events gehen an die Webhook-URL der Application, die dieser Connector nicht empfängt. Aufzeichnungen: telnyx_list_recordings und telnyx_get_recording (die Download-Links laufen nach wenigen Minuten ab).

Verify: Lege einmalig im Portal unter Verify ein Verify-Profil an; telnyx_list_verify_profiles listet es auf. telnyx_send_verification sendet einen Code per SMS, Sprachanruf oder WhatsApp, und telnyx_check_verification_code prüft, was die Person eingegeben hat.

Nutzung und Kosten: telnyx_search_detail_records listet einzelne Nachrichten und Anrufe mit ihren Kosten; telnyx_get_usage_report_options und telnyx_get_usage_report liefern Summen pro Produkt für bis zu 31 Tage. KI-Assistenten kann die KI nur lesen: telnyx_list_ai_assistants und telnyx_get_ai_assistant.

Nummern: immer im Format E.164, also +, Ländervorwahl und Nummer ohne Leerzeichen (+4915112345678).

Häufige Fehler: 401 (10009): Der Schlüssel ist falsch, gelöscht oder wurde mit Präfix eingefügt; lege im Portal einen neuen an. 403: Das Konto darf diese Funktion noch nicht nutzen (zum Beispiel in ein bestimmtes Land senden oder vor der Kontoverifizierung Nummern kaufen), oder dem Schlüssel fehlt die Berechtigung. 404 (10005): Diese Ressource gibt es in diesem Konto nicht. 422: Ein Parameter ist ungültig, zum Beispiel hat der Absender kein Messaging-Profil, der Anruf ist noch nicht angenommen oder eine Nummer steht nicht im Format E.164. 429: zu viele Anfragen; warte kurz und versuche es erneut.

Nicht abgedeckt sind Rufnummernportierung, Konfiguration und Freigabe von Nummern, SIP-Trunking, TeXML, Konferenzen, Fax, WhatsApp-Vorlagen, die 10DLC-Registrierung von Marken und Kampagnen, das Anlegen oder Ändern von KI-Assistenten sowie Webhooks.

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 Telnyx-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie hoch ist unser Telnyx-Guthaben, und wie viel haben wir diesen Monat für Messaging ausgegeben, aufgeschlüsselt nach Land?“
• „Schick eine SMS von unserer Berliner Nummer an +4915112345678, dass die Bestellung abholbereit ist. Zeig mir vorher Absender, Empfänger und Text.“
• „Ruf +4915112345678 von unserer Support-Nummer aus an, sag, dass der Techniker um 15 Uhr kommt, und leg dann auf. Der Anruf soll unter einer Minute bleiben.“
• „Finde drei Mobilnummern in Deutschland, die SMS senden können, und zeig mir für jede die einmaligen und die monatlichen Kosten.“
• „Welche Nachrichten von gestern wurden nicht zugestellt? Sieh in den Detaildatensätzen nach und zeig mir Status und Kosten.“

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