Telnyx MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Telnyx-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden