Twilio über MCP mit Microsoft Copilot verbinden

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

Twilio + Microsoft Copilot

Lass deine KI mit Twilio arbeiten: SMS- und WhatsApp-Nachrichten senden und nachschlagen, Anrufe und Telefonnummern prüfen, Nummern mit Lookup überprüfen, Einmalcodes mit Verify senden und prüfen und Nutzung, Kosten und Guthaben im Blick behalten.

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:

TWILIO_ACCOUNT_SID, TWILIO_API_KEY_SID, TWILIO_API_KEY_SECRET

Schritt 1 — Zugangsdaten holen

1. Melde dich unter console.twilio.com an. Das Panel Account Info auf der Startseite zeigt die Account SID (beginnt mit AC) und das Auth Token.
2. Empfohlen: Erstelle einen API-Key, statt das Auth Token zu verwenden. Öffne in der Console Settings → Account settings → API keys & auth tokens (in der alten Console Admin → Account management → API keys & tokens), klicke auf Create API key, wähle den Typ Standard und kopiere die SID (beginnt mit SK) und das Secret: Twilio zeigt das Secret nur einmal an. Einen Key kannst du einzeln widerrufen, ohne das Auth Token zu ändern.
3. Trage die Account SID in TWILIO_ACCOUNT_SID ein. Dann entweder die Key-SID (SK...) in TWILIO_API_KEY_SID und ihr Secret in TWILIO_API_KEY_SECRET, oder noch einmal die Account SID (AC...) in TWILIO_API_KEY_SID und das Auth Token in TWILIO_API_KEY_SECRET.
4. Installiere den Connector und beginne mit twilio_list_phone_numbers: Das Tool listet deine Nummern auf, also die Absender, die die KI verwenden kann. Ein Standard-API-Key darf den Kontodatensatz selbst nicht lesen, daher kann twilio_get_account damit 401 oder 403 antworten; alle anderen Tools funktionieren.

Senden kostet Geld und erreicht echte Menschen: twilio_send_message und twilio_send_verification schicken eine echte Nachricht oder einen Code an eine echte Person, und Twilio berechnet jede einzelne. Die KI nennt vorher Empfänger, Absender, Kanal und Text und wartet auf dein Ja. Dasselbe gilt für twilio_cancel_scheduled_message.

Bei der Installation ausgeschaltet: twilio_delete_message, das einen Nachrichteneintrag samt Text endgültig löscht. Schalte das Tool nur ein, wenn die KI Nachrichten löschen soll.

Trial-Konten: Ein Trial-Konto sendet nur an bis zu fünf verifizierte Nummern (sonst Fehler 21608) und nur innerhalb des Landes, in dem du dich registriert hast. Eine SMS über die API darf im Trial als Text nur eine von Twilios Beispielvorlagen verwenden (etwa sms_2fa oder sms_appointment_reminders); freier Text braucht ein Konto mit Upgrade.

WhatsApp: Setze whatsapp: vor beide Nummern (whatsapp:+4915112345678). Für einen ersten Test nimm die WhatsApp Sandbox in der alten Console: Die Person schickt join <code> an die Sandbox-Nummer, danach kannst du ihr drei Tage lang von whatsapp:+14155238886 aus schreiben. Mehr als 24 Stunden nach ihrer letzten Nachricht stellt WhatsApp nur freigegebene Vorlagen zu, gesendet mit content_sid (HX...) und content_variables (sonst Fehler 63016).

Nummern: immer im Format E.164, also +, Ländervorwahl und Nummer ohne Leerzeichen (+4915112345678). twilio_list_phone_numbers zeigt die Nummern, von denen du senden kannst; twilio_list_messaging_services listet deine Messaging Services, die du für geplante Nachrichten brauchst (schedule_type fixed mit send_at).

Zustellstatus: Eine neue Nachricht startet als queued. Lass die KI sie später mit twilio_get_message prüfen: failed oder undelivered kommen mit einem error_code, den du in Twilios Fehlerliste nachschlagen kannst. twilio_list_messages und twilio_list_calls zeigen den Verlauf, die neuesten zuerst.

Lookup: twilio_lookup_phone_number ohne fields ist kostenlos und prüft Format und Land. Jedes Datenpaket in fields (etwa line_type_intelligence, sms_pumping_risk oder caller_name) wird pro Abfrage berechnet, deshalb fragt die KI vorher nach.

Verify: Lege einmal in der Console einen Verify-Service an (Verify → Services → Create new); twilio_list_verify_services zeigt seine VA...-SID. twilio_send_verification schickt den Code per SMS, Anruf, WhatsApp oder E-Mail, und twilio_check_verification prüft, was die Person eingegeben hat (Status approved, wenn er stimmt). Jede erfolgreiche Verifizierung kostet etwa 0,05 USD plus die Gebühr des Kanals.

Nutzung und Kosten: twilio_list_usage_records deckt einen Zeitraum ab, twilio_list_usage_records_by_period teilt nach Tag, Monat oder Jahr auf oder nimmt ein Fenster wie ThisMonth. Die Kategorie totalprice sind deine Gesamtausgaben; twilio_get_balance zeigt das verbleibende Guthaben.

Seitenweise Abfrage: Listen liefern next_page_uri (null auf der letzten Seite); für die nächste Seite übergibt die KI die darin enthaltenen Werte page und page_token.

Häufige Fehler: 401 oder 20003 heißt, dass SID oder Secret falsch sind oder ein API-Key mit einer Account SID verwendet wird, zu der er nicht gehört. 404 oder 20404 heißt, dass es diese Nachricht, diesen Anruf, diese Nummer oder diesen Service in diesem Konto nicht gibt. 21211 ist eine ungültige to-Nummer, 21606 eine from-Nummer, die keine Twilio-Nummer dieses Kontos ist oder keine SMS senden kann, 21610 ein Empfänger, der mit STOP geantwortet hat. 429 oder 20429 heißt zu viele Anfragen: Warte und versuche es erneut.

Der Connector tätigt keine Anrufe, kauft oder konfiguriert keine Nummern und unterstützt weder Conversations, Studio, Flex noch Voice TwiML und 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 Twilio-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

• „Zeig mir die SMS- und WhatsApp-Nachrichten, die wir heute gesendet haben, und markiere alle, die fehlgeschlagen oder nicht zugestellt sind, mit dem Fehlercode.“
• „Wie viel haben wir diesen Monat bei Twilio ausgegeben, aufgeteilt nach Kategorie, und wie hoch ist unser restliches Guthaben?“
• „Prüf, ob +4915112345678 eine gültige Nummer ist und zu welchem Land sie gehört.“
• „Schick eine SMS von unserer Twilio-Nummer an +4915112345678 und teil dem Kunden mit, dass Bestellung 1042 versendet ist und morgen ankommt.“

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