---
title: "Conecta tu IA (MCP)"
description: "Yumina tiene un servidor MCP en yumina.io/mcp. Conecta Claude, ChatGPT, Cursor, Claude Code o Codex a tu cuenta y leerá, editará y probará tus cartas en Studio, en vivo."
---

# Conecta tu IA

Yumina tiene un servidor [MCP](https://modelcontextprotocol.io) en `https://yumina.io/mcp`. Añádelo a la herramienta de IA que ya usas, inicia sesión una vez, y esa IA puede abrir tus cartas, escribir lore, variables, comportamientos y código de interfaz, crear imágenes y probar, con cada cambio apareciendo en vivo en tu lienzo. No puede publicar. Ese clic sigue siendo tuyo.

El Asistente IA de Studio hace el mismo trabajo sin configurar nada. Conecta tu propia IA cuando quieras tu propio modelo, tu propia suscripción o un agente que siga trabajando desde una terminal.

## Inicio rápido

1. Abre el menú ⋮ de arriba a la derecha del lienzo y pulsa **Conecta tu IA**. La carta tiene que estar guardada una vez antes.
2. Elige tu herramienta. El diálogo muestra sus pasos, y todos se reducen a la dirección de arriba.
3. Pulsa **Permitir** en la página de Yumina que se abre.
4. Envíale a tu IA un primer mensaje. El diálogo detecta la conexión y lo dice.

```text
Usa Yumina para abrir mi carta "Taberna del Champiñón" y dime qué tiene ahora mismo.
```

## Por cliente

### Claude

Escritorio o web. Abre Ajustes → Conectores → **Add custom connector**, ponle de nombre Yumina, pega la dirección, pulsa Continuar y luego Añadir. Pulsa Conectar y luego Permitir en la página de Yumina.

### ChatGPT y Codex

Ajustes → Plugins → Add → **Add MCP server**. Ponle de nombre yumina, elige Streamable HTTP, pega la dirección y guarda. Inicia sesión en Yumina y pulsa Permitir.

### Cursor

Pulsa **Añadir a Cursor** en el diálogo, o añade esto a `.cursor/mcp.json`, y luego inicia sesión en Yumina y pulsa Permitir:

```json
{ "mcpServers": { "yumina": { "url": "https://yumina.io/mcp" } } }
```

### Claude Code

```bash
claude mcp add --transport http yumina https://yumina.io/mcp
```

Luego escribe `/mcp` en Claude Code, elige yumina, Authenticate, y pulsa Permitir en el navegador.

### Codex CLI

```bash
codex mcp add yumina --url https://yumina.io/mcp
codex mcp login yumina
```

Luego abre `~/.codex/config.toml` y añade una línea bajo `[mcp_servers.yumina]`, porque Codex le da a una herramienta 60 segundos por defecto y una prueba o una imagen tardan más:

```toml
tool_timeout_sec = 300
```

### DeepSeek Harness

Todavía no puede iniciar sesión, así que su pestaña del diálogo crea un token para la carta que tienes abierta, te da un `yumina.yml` para guardar y un comando que ejecutar:

```bash
npx @deepseek-ai/dsh web --patch yumina.yml
```

El token llega solo a esa carta y caduca a los 90 días.

### Cualquier otra herramienta

Si no puede iniciar sesión, abre **¿No puedes iniciar sesión? Crea un token para esta tarjeta** en el diálogo. Pon en tu herramienta la dirección y la cabecera Authorization que muestra. El token se muestra una sola vez.

## Ejemplos de uso

```text
Añade un mercader astuto llamado Vex que habla con acertijos y tiene problemas de confianza.
```

```text
Haz una variable de hambre que baje con el tiempo. Cuando llegue a cero, el jugador muere.
```

```text
Monta una interfaz de fantasía oscura con salud, maná y huecos de inventario.
```

```text
Repasa las notas adhesivas de mi carta y haz todos los cambios que piden.
```

```text
Prueba cinco turnos como un jugador cauto y dime qué variables no se movieron nunca.
```

```text
Revisa la carta por si hay algo mal conectado y arréglalo.
```

## Herramientas disponibles

| Tarea | Herramientas |
|---|---|
| Encontrar tus cartas | `list_my_cards`, `create_card` |
| Leer una carta | `get_world`, `read_entities`, `grep_world`, `list_assets`, `read_ui_doc`, `load_skill` |
| Comprobarla, gratis | `validate_world`, `analyze_token_cost`, `simulate_behaviors` |
| Escribir la historia | `write_entry`, `write_variable`, `write_behavior`, `write_worldbook`, `write_audio`, `write_scene_image`, `write_note`, `update_settings`, `set_card_name`, `delete_entities` |
| Montar la interfaz | `write_custom_ui`, `edit_custom_ui`, `edit_ui_doc`, `set_ui_knobs` |
| Probarla | `playtest`, hasta 10 movimientos cada vez, y `screenshot_ui` |
| Crear imágenes | `generate_image`, `set_cover` |

La mayoría de las herramientas aceptan un `variant`, para poder trabajar en las versiones en otros idiomas de una carta. Lee tus notas adhesivas y sabe dónde está pegada cada una. El servidor le dice a cada IA que empiece por `get_world`, y `delete_entities` está marcada como destructiva, así que los clientes que respetan esa indicación te preguntan antes.

## Lo que cuesta

Leer, escribir y comprobar son gratis. Los movimientos de prueba, las capturas con movimientos y las imágenes cuestan mushies al precio normal, lo mismo que cuando los haces tú con un clic, y los fallos se devuelven.

## Seguridad

- **Ninguna contraseña en ningún archivo de configuración.** El inicio de sesión es OAuth 2.1 con PKCE. La IA tiene un token de corta duración con el permiso «cartas» y nada más, y la página de consentimiento enumera exactamente lo que cubre.
- **No puede publicar ni tocar tu cuenta.** En una carta publicada, sus ediciones esperan como cambios sin publicar hasta que tú los envías. Ni saldo, ni contraseña, ni ajustes.
- **Un punto de control antes de cada cambio.** ⋮ → Historial de cambios muestra «Antes: Claude», o la IA que fuera, y puedes volver a él. Como máximo uno por IA cada 15 minutos.
- **Los límites frenan a un agente desbocado.** 30 turnos de prueba, 20 imágenes y 30 capturas por hora, y 20 cartas nuevas al día.

Aun así deberías:

- **Leer lo que escribió** antes de publicar, igual que con el Asistente IA.
- **Desconectar lo que ya no uses.** IA conectadas, en el diálogo, o Ajustes → Cuenta → Apps conectadas, enumera cada una con la última vez que se usó. Desconéctala y pierde el acceso en ese mismo segundo. Los tokens de carta se enumeran y se revocan de la misma forma.
- **Cambiar de cuenta de forma limpia.** Desconecta, cierra sesión en Yumina en tu navegador, inicia sesión con la otra cuenta y vuelve a conectar. Para Codex CLI ejecuta `codex mcp logout yumina` y luego `codex mcp login yumina`.

## Sin conector

Si tu herramienta no tiene ningún soporte de MCP, dale en su lugar el [formato de archivo de mundo](/es/world-spec/). Escribe el JSON de la carta y tú lo importas.

## Relacionado

- [El Asistente IA](./studio-ai.md)
- [Formato de archivo de mundo](/es/world-spec/)
