Skip to content

Conecta tu IA ​

Yumina tiene un servidor MCP 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 ​

TareaHerramientas
Encontrar tus cartaslist_my_cards, create_card
Leer una cartaget_world, read_entities, grep_world, list_assets, read_ui_doc, load_skill
Comprobarla, gratisvalidate_world, analyze_token_cost, simulate_behaviors
Escribir la historiawrite_entry, write_variable, write_behavior, write_worldbook, write_audio, write_scene_image, write_note, update_settings, set_card_name, delete_entities
Montar la interfazwrite_custom_ui, edit_custom_ui, edit_ui_doc, set_ui_knobs
Probarlaplaytest, hasta 10 movimientos cada vez, y screenshot_ui
Crear imágenesgenerate_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. Escribe el JSON de la carta y tú lo importas.

Relacionado ​