docs: translate xurl and mcp updates to ja, es, pt, ko (#241)

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

Author: mintlify[bot]

es/tools/mcp.mdx

@@ -63,7 +63,7 @@ Elige una de dos rutas:
 
 1. **Crea una app de X** con **OAuth 2.0** habilitado.
 2. **Registra la URI de redirección** `http://localhost:8080/callback` en la app (requerida para el inicio de sesión por navegador en la primera ejecución). Para usar otra, define `REDIRECT_URI` y registra esa en su lugar.
-3. **Copia tu `CLIENT_ID` y `CLIENT_SECRET`** — los colocarás en la configuración del cliente.
+3. **Copia tu `CLIENT_ID` y `CLIENT_SECRET`** — los colocarás en la configuración del cliente. Si alguna vez ejecutas `xurl auth oauth2` manualmente (por ejemplo, el flujo headless de más abajo), expórtalos como variables de entorno en esa shell primero — el login falla en el navegador sin ellos.
 4. **Ten Node.js instalado** (para `npx`).
 5. Recomendamos que **instales [xurl](https://github.com/xdevplatform/xurl)**:
 
@@ -270,6 +270,11 @@ El handshake de MCP se mantiene en espera hasta que termines — por eso los cli
 ¿No hay un navegador accesible? Autentícate una vez fuera de banda y luego inicia el cliente:
 
 ```bash
+# Required: the env block in your client config only applies to the bridge,
+# not to manual xurl runs — export the credentials in this shell first.
+export CLIENT_ID="YOUR_X_APP_CLIENT_ID"
+export CLIENT_SECRET="YOUR_X_APP_CLIENT_SECRET"
+
 xurl auth oauth2 --headless                 # prints an auth URL; you paste back the redirect URL/code
 xurl auth oauth2 --app my-app --headless    # for a specific app
 ```
@@ -292,6 +297,10 @@ Contrapartida: sin auto-refresh y sin contexto de usuario (sin acciones como tú
 
 #### Múltiples apps y cuentas
 
+<Note>
+El inicio de sesión de OAuth autoriza **la cuenta de X que esté con sesión iniciada cuando se abre el navegador** — no necesariamente la cuenta que es dueña de la app. Si estás publicando en nombre de una cuenta secundaria o de bot, cambia a esa cuenta en tu navegador antes de completar el inicio de sesión (o usa `-u` para elegir un usuario previamente autorizado).
+</Note>
+
 ```bash
 xurl --app my-app mcp                  # bridge using a specific registered app
 xurl mcp -u alice https://api.x.com/mcp  # act as a specific OAuth2 user
@@ -325,6 +334,7 @@ npx -y @xdevplatform/xurl mcp https://api.x.com/mcp
 | El cliente excede el tiempo de espera al arrancar | Aumenta `startup_timeout_sec` a 300+; el puente está esperando tu inicio de sesión en el navegador |
 | El navegador nunca se abre | Sin display (headless) → ejecuta primero `xurl auth oauth2 --headless`; asegúrate de que `npx` se resuelva |
 | `401` / `token refresh failed` | Credenciales de la app incorrectas, o refresh token revocado → vuelve a ejecutar el inicio de sesión (`xurl auth oauth2 [--app NAME]`) |
+| El navegador muestra "Something went wrong — You weren't able to give access to the App" | `CLIENT_ID`/`CLIENT_SECRET` no están definidos donde se ejecuta `xurl` → colócalos en el bloque `env` del cliente, o haz `export` en tu shell antes de ejecutar `xurl auth oauth2` manualmente |
 | Error de redirect/callback en el navegador | `http://localhost:8080/callback` no está registrado en la app (o `REDIRECT_URI` no coincide) |
 | `client-not-enrolled` después de iniciar sesión | La app no está en el paquete/entorno correcto de X → en el portal muévela a **Pay-per-use** + **Production** |
 | `npx` descarga una versión obsoleta | Hay un mirror de registro privado por defecto → fija `--registry=https://registry.npmjs.org/` en `args` |

es/tools/xurl.mdx

@@ -0,0 +1,123 @@
+---
+title: xurl — cliente de línea de comandos estilo curl para la X API
+sidebarTitle: CLI (xurl)
+description: Instala y usa xurl, una CLI estilo curl para la X API con OAuth integrado que te permite probar endpoints, firmar solicitudes y hacer prototipos desde la terminal.
+keywords: ["xurl", "CLI", "command line", "curl", "X API CLI", "API testing", "OAuth", "developer tools"]
+---
+
+[xurl](https://github.com/xdevplatform/xurl) es una herramienta de línea de comandos estilo curl para la X API. Se encarga automáticamente de la autenticación OAuth para que puedas hacer solicitudes a la API sin gestionar tokens ni firmar solicitudes manualmente.
+
+<Card title="Repositorio de GitHub" icon="github" href="https://github.com/xdevplatform/xurl">
+  Código fuente, releases y documentación.
+</Card>
+
+---
+
+## Instalación
+
+Instala con Go, o descarga un binario precompilado desde [releases](https://github.com/xdevplatform/xurl/releases).
+
+```bash
+go install github.com/xdevplatform/xurl@latest
+```
+
+---
+
+## Configuración
+
+### 1. Crea una app de X
+
+xurl se autentica usando tu propia app de desarrollador. En el [X Developer Portal](https://developer.x.com):
+
+1. Crea (o abre) una app con **OAuth 2.0** habilitado.
+2. Registra la URI de redirección `http://localhost:8080/callback` en la app.
+3. Copia el **Client ID** y el **Client Secret** de la app desde la página "Keys and tokens".
+
+### 2. Configura tus credenciales
+
+Exporta las credenciales en la misma shell desde la que ejecutarás xurl:
+
+```bash
+export CLIENT_ID="your-x-app-client-id"
+export CLIENT_SECRET="your-x-app-client-secret"
+```
+
+### 3. Autoriza
+
+```bash
+xurl auth oauth2
+```
+
+Esto abre un flujo de OAuth en el navegador. Una vez autorizado, xurl almacena tus tokens localmente en `~/.xurl` para que no necesites autenticarte de nuevo.
+
+<Warning>
+Si el navegador muestra **"Something went wrong — You weren't able to give access to the App"**, xurl inició el login sin credenciales válidas. Asegúrate de que `CLIENT_ID` y `CLIENT_SECRET` estén exportados en la shell donde ejecutaste `xurl auth oauth2`, y de que `http://localhost:8080/callback` esté registrado como URI de redirección en tu app.
+</Warning>
+
+---
+
+## Uso
+
+### Solicitudes crudas a la API
+
+Usa xurl como curl — se encarga de los headers de autenticación automáticamente:
+
+```bash
+# Consultar un usuario
+xurl /2/users/by/username/xdevelopers
+
+# Buscar posts recientes
+xurl "/2/tweets/search/recent?query=from:xdevelopers&max_results=10"
+
+# Crear un post
+xurl -X POST /2/tweets -d '{"text": "Hello from xurl!"}'
+```
+
+### Comandos de acceso rápido
+
+xurl incluye atajos integrados para operaciones comunes:
+
+```bash
+# Consultar un usuario por nombre de usuario
+xurl user xdevelopers
+
+# Buscar posts recientes
+xurl search "X API"
+
+# Publicar un tweet
+xurl post "Hello from xurl!"
+```
+
+---
+
+## ¿Por qué usar xurl?
+
+| Característica | curl | xurl |
+|:--------|:-----|:-----|
+| **Autenticación** | Configuración manual del header OAuth | Automática — solo ejecuta `xurl auth` una vez |
+| **Gestión de tokens** | Tú manejas el refresh/rotación | Almacenamiento y refresh de tokens integrados |
+| **Atajos de API** | URL completa requerida | Comandos abreviados para tareas comunes |
+| **Firma de solicitudes** | Firma OAuth 1.0a manual | Automática para todas las solicitudes |
+
+---
+
+## Uso de xurl con agentes de IA
+
+xurl incluye un archivo [`SKILL.md`](https://github.com/xdevplatform/xurl/blob/main/SKILL.md) que describe sus capacidades en un formato legible por máquina. Los agentes de IA pueden usarlo para entender cómo invocar los comandos de xurl en tu nombre.
+
+```bash
+npx skills add https://github.com/xdevplatform/xurl
+```
+
+---
+
+## Relacionado
+
+<CardGroup cols={2}>
+  <Card title="Haz tu primera solicitud" icon="rocket" href="/make-your-first-request">
+    Comienza a usar la X API con cURL o SDKs.
+  </Card>
+  <Card title="API Playground" icon="flask" href="https://github.com/xdevplatform/playground">
+    Prueba endpoints localmente con datos simulados — sin gastar créditos de la API.
+  </Card>
+</CardGroup>