--- title: "Servidor MCP" description: "Conecta agentes de IA a Twexapi mediante el Model Context Protocol." --- # Conecta agentes de IA mediante MCP Twexapi ejecuta un servidor de [Model Context Protocol](https://modelcontextprotocol.io) que permite a agentes de IA y herramientas de desarrollo interactuar con tu cuenta de Twexapi de forma programática. Esta página cubre el servidor MCP de la API en `https://api.twexapi.io/mcp` para acciones autenticadas. Para búsqueda de documentación de solo lectura, usa el [servidor Docs MCP](/mcp/docs-mcp) en `https://docs.twexapi.io/mcp`. ## Conexión ### Protocolo HTTP con transporte Streamable HTTP para clientes MCP. ### Endpoint Conecta los clientes a: ```txt https://api.twexapi.io/mcp ``` El servidor de la API acepta tanto `https://api.twexapi.io/mcp` como `https://api.twexapi.io/mcp/`. Usa la URL sin barra final en la configuración del cliente, a menos que el cliente la normalice explícitamente. ### Autenticación Usa una API key de Twexapi en `x-api-key` o un token Bearer OAuth 2.1 cuando OAuth esté habilitado para tu workspace. Los metadatos de descubrimiento del servidor MCP están disponibles en: ```txt https://api.twexapi.io/.well-known/mcp.json ``` `GET /.well-known/mcp.json` devuelve directamente el JSON de la tarjeta del servidor del registro MCP. `GET /.well-known/mcp/server-card.json` devuelve la misma tarjeta para clientes que leen la ruta anidada server-card. Los clientes que usan la tarjeta del registro reciben un remoto `streamable-http` para `https://api.twexapi.io/mcp` con autenticación por API key. Los ejemplos de cliente directo abajo pueden enviar la misma key con `x-api-key` cuando el cliente admite headers personalizados. :::note Los clientes con API key deben enviar `x-api-key` en la primera solicitud. Las solicitudes no autenticadas a `https://api.twexapi.io/mcp` devuelven `401`. ::: ## Autenticación El servidor MCP admite estos métodos de autenticación: - API key (header `x-api-key`): usada por Claude Code, Cursor, VS Code, Windsurf, Codex CLI, OpenCode y Claude Desktop mediante puentes remotos. Pasa tu key durante el handshake MCP. - Token Bearer (`Authorization: Bearer `): usado por clientes que prefieren headers Authorization. Puede ser una API key de Twexapi o un token OAuth cuando OAuth está habilitado. Crea tu API key desde el [dashboard de Twexapi](https://twexapi.io/dashboard). ## Cómo funciona El servidor MCP expone 2 herramientas: ### `explore` Busca en el catálogo de la API de Twexapi. Es una herramienta de descubrimiento: devuelve nombres de endpoints, métodos, rutas, categorías, esquemas de parámetros, ejemplos y flags de seguridad. ### `twexapi_request` Ejecuta llamadas autenticadas a la API de Twexapi. El costo sigue el endpoint subyacente. El agente primero busca con `explore` y luego llama a `twexapi_request` con el método y la ruta relativa devueltos. La autenticación se inyecta automáticamente desde la solicitud MCP. ### Herramienta `explore` Busca en el catálogo de endpoints de la API en memoria. La llamada aún requiere autenticación MCP mediante API key o token Bearer. ```ts interface EndpointInfo { name: string; method: string; path: string; category: string; // trending, search, users, tweets, followers, engagement, communities, lists, dm, articles, timeline, accounts, write description: string; read_only: boolean; parameters_schema?: Record; example?: Record; } ``` ### Herramienta `twexapi_request` Ejecuta llamadas a la API contra endpoints REST de Twexapi en la allowlist. ```ts declare const twexapi_request: { method: string; path: string; query?: Record; body?: unknown; }; ``` Ejemplo de llamada: ```json { "method": "GET", "path": "/twitter/global-trending/countries" } ``` ## MCP vs API REST ### Servidor MCP Ideal para agentes de IA, integraciones en el IDE y flujos en lenguaje natural. Conéctate a `https://api.twexapi.io/mcp` con `x-api-key` o auth Bearer. Los agentes usan `explore` para buscar endpoints y `twexapi_request` para llamadas autenticadas. ### API REST Ideal para servicios backend, scripts de automatización y acceso programático directo. Llama a `https://api.twexapi.io/*` con `Authorization: Bearer `. Usa la referencia de la API cuando necesites control detallado sobre endpoints, paginación, manejo de respuestas o código SDK directo. Usa MCP cuando quieras que un agente interactúe con datos de X/Twitter mediante lenguaje natural. Usa REST cuando estés construyendo un backend de producción, un job programado o una integración directa. ## Configuración ### Clientes web y de terminal - [Claude.ai](#claude-ai) - [Claude Desktop](#claude-desktop) - [Claude Code](#claude-code) - [Codex CLI](#codex-cli) #### Claude.ai Claude.ai puede conectarse a servidores MCP remotos cuando los conectores MCP están habilitados para tu workspace. Usa `https://api.twexapi.io/mcp` como URL del servidor. Los workspaces con OAuth pueden completar la autenticación en el navegador; los clientes con API key deben usar `x-api-key`. #### Claude Desktop Claude Desktop solo admite transporte stdio. Usa el paquete npm `mcp-remote` como puente: ```json { "mcpServers": { "twexapi": { "command": "npx", "args": [ "mcp-remote@latest", "https://api.twexapi.io/mcp", "--header", "x-api-key:twexapi_YOUR_KEY_HERE" ] } } } ``` #### Claude Code Agrega esto a tu `.mcp.json`: ```json { "mcpServers": { "twexapi": { "type": "http", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### Codex CLI Agrega esto a `~/.codex/config.toml`: ```toml [mcp_servers.twexapi] url = "https://api.twexapi.io/mcp" http_headers = { "x-api-key" = "twexapi_YOUR_KEY_HERE" } ``` ### Clientes de editor - [Cursor](#cursor) - [VS Code](#vs-code) - [Windsurf](#windsurf) - [OpenCode](#opencode) #### Cursor Agrega esto a `~/.cursor/mcp.json` (global) o `.cursor/mcp.json` (proyecto): ```json { "mcpServers": { "twexapi": { "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### VS Code Agrega esto a `.vscode/mcp.json` (proyecto) o usa **MCP: Open User Configuration** (global): ```json { "servers": { "twexapi": { "type": "http", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### Windsurf Agrega esto a `~/.codeium/windsurf/mcp_config.json`: ```json { "mcpServers": { "twexapi": { "serverUrl": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### OpenCode Agrega esto a `opencode.json`: ```json { "mcp": { "twexapi": { "type": "remote", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` ### ChatGPT Hay 3 formas de conectar ChatGPT a Twexapi: **Opción 1: Custom GPT** Crea un Custom GPT y agrega Twexapi como Action usando el esquema OpenAPI de tu despliegue de la API. Configura la autenticación como header de API key o token Bearer según tu setup. **Opción 2: Agents SDK** Usa Streamable HTTP MCP desde un runtime de agente: ```python from agents.mcp import MCPServerStreamableHttp async with MCPServerStreamableHttp( url="https://api.twexapi.io/mcp", headers={"x-api-key": "twexapi_YOUR_KEY_HERE"}, params={}, ) as twexapi: # use Twexapi as a tool provider pass ``` **Opción 3: Developer Mode** Cuando tu entorno de ChatGPT admite conectores MCP, agrega Twexapi con `https://api.twexapi.io/mcp` como endpoint. Los workspaces con OAuth pueden completar la autenticación en el navegador. ## Prompts de ejemplo Una vez conectado, puedes pedirle a tu agente de IA cosas como: ### Búsqueda y consulta - Busca publicaciones recientes en X sobre `AI agents` de las últimas 24 horas. Devuelve los 20 tweets principales con tweet ID, autor, hora de creación, likes, reposts y un resumen de una línea. - Encuentra tweets recientes de `@elonmusk` que mencionen `Grok` o `AI`. Agrupa los resultados por tema e incluye enlaces directos a X. - Lee este tweet: `https://x.com/elonmusk/status/1803006263529541838`. Resume la publicación, luego obtén las respuestas más relevantes y muestra los reply IDs. - Obtén tweets similares para el tweet ID `1803006263529541838` y explica por qué cada resultado está relacionado. ### Perfiles de usuario y follows - Lee la bio del perfil de `@openai` y devuelve username, display name, user ID, ubicación, cantidad de seguidores y URL del perfil. - Busca usuarios en X para `AI infrastructure`. Devuelve 25 cuentas con username, bio, cantidad de seguidores y por qué coinciden. - Obtén los seguidores más recientes de `@elonmusk`, luego identifica qué cuentas mencionan AI, startups o crypto en sus bios. - Obtén una página de seguidores con paginación por cursor para `@sama`, devuelve los primeros 20 usuarios y conserva el `next_cursor` para la siguiente ejecución. - Verifica si las cuentas `44196397`, `elonmusk` y `openai` están verificadas o afiliadas a una organización. ### Tendencias - Muestra todos los países con tendencias globales admitidos, luego obtén los temas en tendencia principales para `united-states`. - Obtén tweets en tendencia para `united-states` con el tema `technology` y la etiqueta de contenido `AI`. Devuelve tweet IDs, autores y métricas de engagement. - Verifica si `AI`, `Bitcoin` o `Grok` están en tendencia hoy en Estados Unidos. Explica la evidencia de los tweets devueltos. - Compara temas en tendencia para `united-states`, `japan` y `united-kingdom` y resume qué difiere por región. ### Extracciones - Obtén respuestas a `https://x.com/elonmusk/status/1803006263529541838`, ordénalas por relevancia y devuelve reply ID, autor, texto y cantidad de likes. - Lista 50 usuarios que retweetearon el tweet ID `1803006263529541838`. Devuelve user ID, username, display name y cantidad de seguidores si está disponible. - Obtén quote tweets para el tweet ID `1803006263529541838`, luego clasifica los quotes como de apoyo, críticos o neutrales. - Extrae el hilo completo del tweet ID `1803006263529541838` y conviértelo en un esquema Markdown. - Obtén todos los tweets y respuestas de `@elonmusk` con un count de `20`, luego separa publicaciones originales de respuestas. ### Artículos - Obtén el artículo de X `1803006263529541838` como Markdown y conviértelo en un brief ejecutivo de 5 viñetas. - Obtén en lote artículos de X con los IDs `1803006263529541838` y `1803006263529541839`; devuelve título, autor, hora de publicación y resumen. - Lee este artículo de X como Markdown, extrae todos los enlaces y produce un resumen limpio estilo newsletter. ### Comunidades y listas - Busca comunidades en X para `AI builders`. Devuelve community ID, nombre, cantidad de miembros y descripción. - Obtén los tweets más recientes de la comunidad ID `1234567890123456789` con tweet type `Latest` y target count `20`. - Busca listas para `AI founders`. Devuelve las 10 listas principales con list ID, nombre, descripción y cantidad de miembros. - Obtén miembros de la lista ID `987654321098765432`, incluye el siguiente cursor y formatea el resultado como una tabla de prospección. ### Acciones de escritura en X - Publica un tweet que diga: `Just shipped v2.0 of our Twexapi integration. MCP setup now takes less than 2 minutes.` - Responde al tweet ID `1803006263529541838` con: `This is a useful example. I tested it through Twexapi MCP.` - Crea un tweet con la URL de imagen `https://example.com/launch.png` y el texto: `New launch: Twexapi MCP now supports agent workflows.` - Redacta, pero no envíes, una respuesta a `https://x.com/elonmusk/status/1803006263529541838` en un estilo técnico conciso. :::warning Las acciones de escritura están marcadas como `read_only: false`. Requiere confirmación explícita del usuario antes de publicar, responder, seguir, bloquear o realizar cualquier otra acción con efectos secundarios. ::: ### Cuenta y uso - Explica por qué mi solicitud MCP a `/twitter/global-trending/tweets` devolvió `401` y lista los headers que debo verificar. - Explica por qué mi solicitud MCP devolvió `403 No available credits!` y qué debo hacer antes de reintentar. - Explica por qué una extracción de seguidores de alto volumen devolvió `429`, luego propone un plan de reintento y paginación. - Decide si esta tarea debe usar MCP o REST directo: `pull 10,000 followers for @openai every morning and store them in my database`. ## Guías de frameworks Construye agentes con las herramientas MCP de Twexapi en tu framework preferido: Conecta herramientas MCP de Twexapi a agentes LangChain y LangGraph. Construye crews de investigación que compartan una conexión MCP de Twexapi. Usa agentes type-safe con herramientas MCP Streamable HTTP. Agrega herramientas de Twexapi a agentes ADK con Gemini. Conecta agentes TypeScript a herramientas MCP remotas de Twexapi. Entrega salidas de agentes a n8n, Zapier, Make y Pipedream. ## Skill para agentes de IA El skill de Twexapi da a los agentes de código profundo conocimiento de la API de Twexapi sin requerir una conexión MCP. Instálalo para que tu agente escriba integraciones de API, configure conexiones MCP y use las mejores prácticas de Twexapi. ```bash npx skills add twexapi-dev/x-api-scraper-cli ```