lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio claude-codemcpxpython

X MCP: conecta herramientas oficiales de la API a tu agente

Consulta X desde un cliente MCP y limita las herramientas que cargas según el trabajo y los permisos de tu aplicación.

✓ verificado el 27 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Preparación

Comprueba Git, Python ≥3.10 con venv y pip y descarga el repositorio antes de abrir su raíz. El README anuncia Python ≥3.9, pero las versiones actuales de fastmcp y xai-sdk de requirements.txt exigen ≥3.10 según sus metadatos en PyPI. La activación siguiente es para macOS/Linux; usa la variante de tu sistema si corresponde.

Paso 1: prepara una copia del repositorio

Descarga con git clone https://github.com/xdevplatform/xmcp.git, entra con cd xmcp y ejecuta:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp env.example .env

Paso 2: configura X

En .env configura X_OAUTH_CONSUMER_KEY, X_OAUTH_CONSUMER_SECRET y X_BEARER_TOKEN de la misma app del portal X. Registra http://127.0.0.1:8976/oauth/callback como callback OAuth1 de esa app. Para la prueba limita X_API_TOOL_ALLOWLIST=getUsersByUsername,searchPostsRecent; evita copiar createPosts del ejemplo si solo quieres lectura.

Paso 3: inicia

python server.py

Deja el proceso activo. Con Claude Code ya instalado, registra desde otra terminal claude mcp add --transport http x-local http://127.0.0.1:8000/mcp y abre una sesión nueva. Completa el consentimiento en el navegador que abre el servidor. Pide consultar una cuenta pública conocida mediante getUsersByUsername y contrasta el usuario e ID con la fuente.

Comprobación

Completa el consentimiento y comprueba que el cliente ve las herramientas elegidas. Prueba una consulta de lectura antes de habilitar acciones de escritura.

Si algo falla

Si no llega el callback, comprueba host, puerto y ruta registrados. Los cambios de allowlist exigen reiniciar. No actives las opciones de impresión de tokens para depurar.

ver en .md ¿Prefieres el recurso entero?

Qué es

xmcp es el servidor del equipo X Developer Platform que expone operaciones de la API mediante FastMCP. Carga su definición OpenAPI y convierte las operaciones admitidas en herramientas.

Para qué te sirve

  • Cuando necesitas buscar publicaciones desde un agente que ya usa MCP.
  • Cuando quieres consultar una cuenta con la autenticación oficial.
  • Cuando prefieres cargar un conjunto pequeño de herramientas en vez de toda la API.

Cómo funciona

El proceso local sirve un endpoint HTTP para el cliente MCP. Al arrancar obtiene el esquema y aplica una lista de herramientas permitidas si la configuraste. La autenticación OAuth1 abre un consentimiento en navegador y mantiene sus tokens en memoria durante el proceso.

Antes de empezar

El README anuncia Python ≥3.9, pero fastmcp y xai-sdk actuales exigen ≥3.10: utiliza ese mínimo para instalar requirements.txt sin fijar versiones antiguas. Necesitas venv, pip, una aplicación de X y sus credenciales. El README exige clave y secreto de consumidor junto con el bearer. Registrar la URL de retorno correcta es parte de la preparación. Los permisos y límites de X siguen aplicándose.

Límites y alternativas

No incluye endpoints de streaming ni webhooks. Algunas herramientas escriben o borran contenido: empieza con una lista explícita de lectura. GitHub no detecta licencia; confirma las condiciones de reutilización. X CLI añade archivo local si buscas reutilizar búsquedas.

Recursos