Un asistente de IA no puede ver X por su cuenta. Pregúntale a Claude o ChatGPT qué publicó una cuenta esta mañana y o se lo inventa o te dice que no tiene acceso. Un servidor MCP lo resuelve: le da al asistente un conjunto de herramientas como "obtener los tweets de un usuario" o "buscar tweets", y el asistente las llama cuando tu pregunta necesita datos en vivo.

Esta guía conecta un asistente a datos públicos de X con el servidor MCP de Twitter alojado de TwittrAPI, que operamos nosotros. No hay que instalar nada ni tener cuenta de desarrollador de X. Los pasos siguen la misma idea en cualquier cliente MCP; solo cambia dónde pegas la URL.

Qué obtienes

El servidor ofrece 30 herramientas para datos públicos:

ÁreaHerramientas
Perfilesget_user_by_username, get_user_by_id, users_by_ids, username_to_id, get_user_about_batch
Tweetsget_tweet, tweets_by_ids, get_tweet_replies, get_tweet_thread, get_user_tweets, get_user_tweets_and_replies, get_user_media, search_tweets
Reaccionesget_tweet_quotes, get_tweet_retweets
Relacionesget_followers, get_following, get_verified_followers, get_user_affiliates, get_friendships_batch
Listas y comunidadesget_list_details, get_list_members, get_list_tweets, get_community, get_community_about, get_community_tweets, search_communities
Tendencias y Spacesget_trends, get_trend_locations, get_space

Con tu sesión de X también puede publicar, dar like, seguir y enviar DMs en tu propia cuenta. Esa parte tiene su propia guía: Publica en X desde Claude y ChatGPT.

Por defecto, los resultados llegan en el formato simple (en inglés), que es compacto y mantiene el texto corto para que quepa en el contexto del asistente.

Paso 1: Consigue una API key o una cuenta

Crea una cuenta en /start. Las cuentas nuevas reciben US$0.50 de crédito de prueba durante 7 días. La mayoría de las apps te hacen iniciar sesión con OAuth y nunca ven tu clave. En Cursor y en scripts envías la clave en una cabecera, así que guárdala en una variable de entorno:

export TWITTRAPI_API_KEY="your-key"

Paso 2: Añade el servidor a tu app

La dirección es siempre la misma y debe terminar en /mcp:

https://mcp.twittrapi.com/mcp

Claude.ai y Claude Desktop. Abre Settings > Connectors, elige Add custom connector, ponle de nombre TwittrAPI, pega la URL y haz clic en Connect. Inicia sesión y haz clic en Allow access.

ChatGPT. Activa Developer mode en Settings > Apps & Connectors > Advanced settings, elige Create, escribe la URL y selecciona OAuth como autenticación.

Claude Code.

claude mcp add --transport http twittrapi https://mcp.twittrapi.com/mcp \
  --header "Authorization: Bearer $TWITTRAPI_API_KEY"

Cursor. Añade esto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "twittrapi": {
      "url": "https://mcp.twittrapi.com/mcp",
      "headers": { "X-API-KEY": "${env:TWITTRAPI_API_KEY}" }
    }
  }
}

VS Code (modo agente de Copilot). Añade .vscode/mcp.json con "type": "http" y la misma URL; VS Code te pide iniciar sesión cuando arranca el servidor. La página del MCP alojado (en inglés) tiene este archivo y los pasos para otros clientes.

Paso 3: Haz una pregunta que necesite datos en vivo

Abre un chat nuevo y pregunta algo que solo X puede responder. El asistente elige la herramienta por sí mismo y, en la mayoría de las apps, te muestra la llamada antes de ejecutarla:

  • "¿Qué publicó @nasa en las últimas 24 horas? Resúmelo en tres puntos."
  • "Busca tweets de los últimos dos días que mencionen el nombre de mi producto y tengan al menos 20 likes. Agrúpalos por tema."
  • "Compara el número de seguidores y las biografías de @openai, @AnthropicAI y @GoogleDeepMind."
  • "¿Qué temas son tendencia en Alemania ahora mismo?"

Para tareas más largas, dale al asistente un límite desde el principio, por ejemplo "mira los últimos 40 tweets, no más". Así deja de paginar cuando ya tiene suficiente.

Paso 4: Vigila el costo

Cada llamada a una herramienta es una llamada a la API que se cobra de tu saldo, a tu precio normal: US$0.10 por 1,000 llamadas en Standard y menos con más volumen. Una página de búsqueda devuelve unos 20 tweets, así que una pregunta que genera cinco llamadas cuesta una fracción de centavo. El riesgo no es una pregunta, sino un asistente que recorre página tras página de una cuenta grande sin motivo.

Dos hábitos lo mantienen barato:

  • Pide una cantidad: "los últimos 50 tweets" o "las dos primeras páginas de seguidores".
  • Para agentes que trabajan sin supervisión, crea una clave de agente (en inglés) aparte con su propio presupuesto, para que no pueda gastar más de lo que permites.

El servidor también limita cada clave a 8 peticiones simultáneas, y un error 402 significa que se acabó el saldo. El asistente muestra ambos casos como un mensaje legible.

Paso 5: Desconecta cuando termines

Las apps conectadas aparecen en el panel, en Connected apps, con la hora del último uso. Disconnect corta el acceso de una app en menos de un minuto. Regenerar tu API key desconecta todas las apps.

Cuándo es mejor un script

Un servidor MCP encaja con preguntas e investigaciones puntuales. Para una tarea que se ejecuta cada hora, llama a la API desde código, así el resultado es el mismo cada vez y no interviene ningún modelo: consulta Get an account's tweets with Python y Search Twitter/X without a developer account (en inglés). Para recibir avisos de posts nuevos, usa el monitoreo de cuentas (en inglés) en lugar de pedirle a un asistente que lo revise.

Si tu cliente solo admite stdio, ejecuta las mismas herramientas en local con el paquete de npm:

npx -y twittrapi-mcp

Problemas comunes

  • "404 Not found" o "Couldn't determine how this server signs in": a la URL le falta /mcp. Elimina el conector y añádelo de nuevo con la dirección completa.
  • La app dice que no está autorizada: se desconectó o se regeneró la clave. Elimina el conector y vuelve a conectarlo.
  • El asistente responde de memoria en lugar de llamar a una herramienta: dile "usa las herramientas de TwittrAPI" o indica la cuenta y el periodo. Algunas apps necesitan que actives el conector en el chat.

Preguntas frecuentes

¿Qué es un servidor MCP?

MCP, el Model Context Protocol, es un estándar abierto que permite a las apps de IA llamar a herramientas externas. Un servidor MCP ofrece esas herramientas. Aquí, las herramientas leen datos públicos de X.

¿Necesito una cuenta de desarrollador de X para el servidor MCP de Twitter?

No. El servidor es un servicio de terceros con su propia cuenta y su propia clave. No tiene relación con X.

¿El asistente puede publicar tweets a través de él?

Sí, en tu propia cuenta, una vez que le das al servidor tu sesión de X (la cookie de un navegador con sesión iniciada y un proxy). Tu app te pregunta antes de cada publicación. Configuración: Publica en X desde Claude y ChatGPT.

¿Cuánto cuesta una llamada MCP?

Una llamada a una herramienta es una llamada a la API, US$0.10 por 1,000 en Standard y menos con más volumen. Revisa el saldo en el panel; el asistente no puede gastar más que eso.

¿Con qué apps funciona?

Claude.ai, Claude Desktop, ChatGPT, Claude Code, Cursor y VS Code, y cualquier cliente que admita Streamable HTTP.

Fuentes

TwittrAPI no tiene relación con X Corp. Solo lee datos públicos.