Twilio Segment über MCP mit Cursor verbinden

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

Twilio Segment + Cursor

Lass deine KI mit deinem Twilio-Segment-Workspace arbeiten: Sources, Destinations und Warehouses auflisten, Event-Volumen, Zustellung und Warehouse-Syncs prüfen, Tracking-Pläne, Functions, Nutzung und den Audit Trail lesen. Workspaces in den USA und der EU.

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:

SEGMENT_API_HOST, SEGMENT_API_TOKEN

Schritt 1 — Zugangsdaten holen

1. Öffne als Workspace Owner Settings → Workspace settings → Access Management → Tokens (https://app.segment.com/goto-my-workspace/settings/access-management/tokens) und klicke auf Create Token.
2. Wähle einen Public API-Token, keinen Config-API-Token. Gib ihm die kleinste Rolle, die abdeckt, was du brauchst: Workspace Member mit Read-only-Rollen (zum Beispiel Source Read-only und Tracking Plan Read-only) zum Lesen, Workspace Owner nur, wenn die schreibenden Tools aktiviert werden sollen.
3. Segment zeigt den Token nur einmal: Kopiere ihn sofort in SEGMENT_API_TOKEN. Er wird als Bearer-Token und nur an Segment gesendet.
4. Setze SEGMENT_API_HOST auf die Region des Workspace: https://api.segmentapis.com für einen US-Workspace, https://eu1.api.segmentapis.com für einen EU-Workspace. Ein Token funktioniert nur in seiner eigenen Region.
5. Installiere den Connector und führe segment_get_workspace aus, um die Verbindung zu prüfen. Ein Token gehört zu genau einem Workspace, installiere also pro Workspace einen Connector.

Was der Connector liest: Sources, Destinations mit ihren Actions-Mappings, Warehouses mit Verbindungsstatus und letzten Syncs, das Event-Volumen im Zeitverlauf, die Delivery Overview (wo Events verloren gehen, Schritt für Schritt, mit Gründen), Zustellmetriken pro Destination, Tracking-Pläne und ihre Regeln (Protocols), Functions mit ihrem Code, die tägliche Nutzung nach API-Aufrufen und MTU sowie den Audit Trail, der zeigt, wer was geändert hat. Tracking-Pläne brauchen Protocols, Functions das Functions-Feature und Mappings die Destination Subscriptions im Workspace.

Secrets: Einstellungsfelder, die üblicherweise Zugangsdaten von Destinations und Warehouses enthalten (API-Keys, Secrets, Tokens, Passwörter), werden weggelassen. segment_get_source liefert allerdings die Write Keys der Source, mit denen jeder Daten in diese Source senden kann.

Limits: Segment begrenzt Anfragen pro Token, IP-Adresse und Endpoint und antwortet mit 429 und einem Retry-After-Header. Manche Endpoints sind strenger: Warehouse-Syncs erlauben 2 Aufrufe pro Minute, das Event-Volumen 60 pro Minute, Tracking-Plan-Regeln und der Verbindungsstatus von Warehouses 200 pro Minute. Listen kommen in Seiten mit bis zu 1.000 Einträgen, und die KI folgt pagination.next, bis sie alles hat.

Bei der Installation deaktiviert: segment_update_source und segment_update_destination benennen eine Source oder Destination um oder schalten sie ein oder aus, und eine deaktivierte verwirft Daten, bis sie wieder aktiviert wird. segment_delete_source und segment_delete_destination lassen sich nicht rückgängig machen. Ein Administrator aktiviert diese Tools bewusst, und auch dann bestätigt die KI jede Änderung zuerst mit dir; ein Löschen wartet, bis du ID und Namen bestätigst.

Häufige Fehler: 403 "Not authorized to perform this operation": Der Token ist falsch oder widerrufen, gehört zu einem Workspace in der anderen Region, ist ein Config-API-Token, oder seine Rolle deckt diese Ressource nicht ab. 401: Es wurde kein Token gesendet. 404: In diesem Workspace gibt es keine Ressource mit dieser ID. 422: Ein Parameter fehlt oder ist ungültig, zum Beispiel ein Zeitraum für die Delivery Overview, der länger ist, als die Granularität erlaubt. Eine Meldung zu einem Feature bedeutet, dass der Workspace kein Protocols, keine Functions oder keine Destination Subscriptions hat. 429: Warte die Zeit aus Retry-After ab.

Der Connector sendet keine Events: Die Tracking API von Segment nutzt den Write Key einer Source auf einem anderen Host. Er legt auch keine Sources, Destinations oder Warehouses an und deckt weder Filter, Transformationen, Reverse ETL, Engage-Audiences und Computed Traits, die Zugriffsverwaltung, Lösch- und Unterdrückungsregeln noch den Katalog ab.

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 Cursor 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.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Twilio Segment-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche unserer Destinations sind deaktiviert, und aus welchen Sources lesen sie?“
• „Zeig mir die Delivery Overview unserer iOS-Source für die letzten 24 Stunden und wo Events verloren gegangen sind.“
• „Wie hat sich das Event-Volumen pro Source in den letzten 7 Tagen entwickelt, und wie viele MTU haben wir diesen Monat schon verbraucht?“
• „Wer hat laut Audit Trail in den letzten zwei Wochen Sources oder Destinations geändert?“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

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