Cómo conectar Twilio Segment a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Twilio Segment, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Twilio Segment + Cursor

Deja que tu IA trabaje con tu workspace de Twilio Segment: lista fuentes, destinos y warehouses, revisa el volumen de eventos, la entrega y las sincronizaciones de los warehouses, y lee tracking plans, Functions, el uso y el audit trail. Workspaces en EE. UU. y la UE.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

SEGMENT_API_HOST, SEGMENT_API_TOKEN

Paso 1 — Obtener credenciales

1. Como Workspace Owner, abre Settings → Workspace settings → Access Management → Tokens (https://app.segment.com/goto-my-workspace/settings/access-management/tokens) y haz clic en Create Token.
2. Elige un token de Public API, no un token de Config API. Dale el rol más pequeño que cubra lo que necesitas: Workspace Member con roles de solo lectura (por ejemplo Source Read-only y Tracking Plan Read-only) para leer, Workspace Owner solo si vas a activar las herramientas de escritura.
3. Segment muestra el token una sola vez: cópialo enseguida en SEGMENT_API_TOKEN. Se envía como token Bearer y solo a Segment.
4. Ajusta SEGMENT_API_HOST a la región del workspace: https://api.segmentapis.com para un workspace de EE. UU., https://eu1.api.segmentapis.com para un workspace de la UE. Un token solo funciona en su propia región.
5. Instala el conector y ejecuta segment_get_workspace para comprobar la conexión. Un token pertenece a un solo workspace, así que instala un conector por workspace.

Qué lee: fuentes, destinos con sus mappings de Actions, warehouses con su estado de conexión y sus últimas sincronizaciones, el volumen de eventos en el tiempo, Delivery Overview (dónde se pierden los eventos, paso a paso, con los motivos), métricas de entrega por destino, tracking plans y sus reglas (Protocols), Functions con su código, el uso diario de llamadas a la API y de MTU, y el Audit Trail con quién cambió qué. Los tracking plans necesitan Protocols, las Functions la función Functions y los mappings las Destination Subscriptions en el workspace.

Secretos: los campos de configuración que suelen contener las credenciales de destinos y warehouses (claves API, secretos, tokens, contraseñas) se omiten. Eso sí, segment_get_source devuelve las write keys de la fuente, con las que cualquiera puede enviar datos a esa fuente.

Límites: Segment limita las peticiones por token, dirección IP y endpoint, y responde 429 con una cabecera Retry-After. Algunos endpoints son más estrictos: las sincronizaciones de warehouses permiten 2 llamadas por minuto, el volumen de eventos 60 por minuto, las reglas de tracking plans y el estado de conexión de warehouses 200 por minuto. Las listas llegan en páginas de hasta 1.000 elementos, y la IA sigue pagination.next hasta tenerlo todo.

Desactivadas al instalar: segment_update_source y segment_update_destination renombran una fuente o un destino o lo activan y desactivan, y uno desactivado descarta los datos hasta que se vuelve a activar. segment_delete_source y segment_delete_destination no se pueden deshacer. Un administrador activa estas herramientas a propósito, e incluso entonces la IA confirma contigo cada cambio; un borrado espera a que confirmes el id y el nombre.

Errores comunes: 403 "Not authorized to perform this operation": el token es incorrecto o está revocado, pertenece a un workspace de la otra región, es un token de Config API o su rol no cubre este recurso. 401: no se envió ningún token. 404: no hay ningún recurso con ese id en este workspace. 422: falta un parámetro o no es válido, por ejemplo un periodo de Delivery Overview más largo de lo que permite la granularidad. Un mensaje sobre una función significa que el workspace no tiene Protocols, Functions o Destination Subscriptions. 429: espera el tiempo indicado en Retry-After.

El conector no envía eventos: la Tracking API de Segment usa la write key de una fuente en otro host. Tampoco crea fuentes, destinos ni warehouses, y no cubre filtros, transformaciones, Reverse ETL, audiencias y computed traits de Engage, la gestión de accesos, las reglas de eliminación y supresión ni el catálogo.

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Twilio Segment.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuáles de nuestros destinos están desactivados y de qué fuentes leen?"
• "Muéstrame el Delivery Overview de nuestra fuente de iOS en las últimas 24 horas y dónde se descartaron eventos."
• "¿Cómo evolucionó el volumen de eventos por fuente en los últimos 7 días, y cuántos MTU llevamos este mes?"
• "Según el audit trail, ¿quién cambió fuentes o destinos en las últimas dos semanas?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT