# Instrucciones para el agente: X MCP: conecta herramientas oficiales de la API a tu agente

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.

- Dificultad: intermedio
- Proyecto: https://github.com/xdevplatform/xmcp
- Guía completa: https://lab.wisd.ai/hub/x-official-mcp

---

## 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:

```bash
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

```bash
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.