Servidor MCP de Teasa: juega historias interactivas en tu asistente de IA

Datos del servidor

Cada historia que juegas se guarda en Teasa. Cada resultado incluye un enlace a la misma conversación en la web y, si conectas tu cuenta de Teasa, también aparece en tus chats de la web y de la app para Android.

Conecta Teasa a tu asistente

Claude (web y escritorio)

1. Abre Conectores en la configuración de Claude y elige Añadir conector personalizado.
2. Ponle el nombre Teasa e introduce la URL https://teasa.ai/mcp. Deja vacíos los campos del cliente OAuth.
3. En un chat nuevo, activa Teasa desde el menú de herramientas y pide: "Búscame una historia de fantasía en Teasa y empiézala".

Puedes jugar como invitado en cuanto añades el conector. Para jugar con tu propia cuenta de Teasa, elige Conectar en el conector de Teasa y aprueba la página de autorización de Teasa.

Claude Code

claude mcp add --transport http teasa https://teasa.ai/mcp

Añade --scope user para usar Teasa en todos tus proyectos.

ChatGPT

1. En ChatGPT para la web, activa el modo desarrollador en la configuración. El modo desarrollador está disponible en los planes de pago de ChatGPT.
2. Crea una app para un servidor MCP remoto: llámala Teasa e introduce https://teasa.ai/mcp.
3. Elige Sin autenticación para jugar como invitado, u OAuth para conectar tu cuenta de Teasa.
4. Añade Teasa a una conversación y pide una historia.

Cursor

Añade Teasa a ~/.cursor/mcp.json para todos tus proyectos, o a .cursor/mcp.json para uno solo:

{
  "mcpServers": {
    "teasa": { "url": "https://teasa.ai/mcp" }
  }
}

VS Code

Añade Teasa a .vscode/mcp.json en tu espacio de trabajo:

{
  "servers": {
    "teasa": { "type": "http", "url": "https://teasa.ai/mcp" }
  }
}

O añádelo a tu perfil de usuario desde la línea de comandos:

code --add-mcp '{"name":"teasa","type":"http","url":"https://teasa.ai/mcp"}'

Cualquier cliente Streamable HTTP

Envía solicitudes JSON-RPC con POST a https://teasa.ai/mcp. El servidor no guarda estado, así que no hay ID de sesión que conservar: cada solicitud es independiente y la respuesta es JSON.

curl -s https://teasa.ai/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Llama al servidor desde un backend, una app de escritorio o la línea de comandos. Las páginas de navegador de otros sitios web reciben 403.

Herramientas

Las respuestas se escriben con Hojicha, el estilo de chat predeterminado de Teasa. send_message no necesita idioma: Teasa mantiene el idioma elegido en start_story durante toda la conversación.

Formatos de salida

• image (por defecto): hasta dos tarjetas de historia por respuesta, en PNG de 720 píxeles de ancho, más el texto completo en el resultado estructurado. Si una respuesta es más larga, el resultado incluye cards.nextPage; llama a get_turn con esa page para recibir el resto. Para la apertura, repite start_story con el mismo requestId, el mismo language y la page devuelta.
• text: solo el resultado estructurado, con el texto de la respuesta, los segmentos por personaje y el reparto.
• app: el resultado estructurado para clientes que muestran la vista interactiva de historias de Teasa (MCP Apps).

Juego como invitado y cuentas

La primera llamada a start_story sin credenciales crea un invitado y devuelve guestSession, una credencial de 64 caracteres. Guárdala en privado y envíala en cada llamada, reintento y página posteriores. Nunca la pongas en una URL.

• Tiempo y turnos. El acceso de invitado dura 24 horas e incluye diez turnos gratis. Las aperturas y las páginas extra de tarjetas no gastan turnos.
• Conserva la historia. Cada resultado incluye continueUrl. Para invitados es un enlace privado de un solo uso, válido hasta 30 minutos, que abre la misma conversación en Teasa en la web, donde puedes crear una cuenta y seguir jugando. Llama de nuevo a get_turn para obtener un enlace nuevo.
• Tu propia cuenta. Conéctala con OAuth para jugar con tu cuenta de Teasa y su saldo. La guía de configuración en el navegador está en teasa.ai/mcp/setup y puedes revisar o revocar los asistentes conectados en teasa.ai/mcp/connections.
• Desconectar. end_guest_session revoca el acceso de invitado al momento. Las historias guardadas no se borran.
• Alcance. Una conexión solo llega a las conversaciones que ella misma empezó. No puede leer tus otros chats ni tus recuerdos, editar contenido de creadores ni cambiar tu cuenta.

Idiomas

search_stories y start_story exigen language: en, ja, ko, zh o es. Envía el idioma en el que la persona quiere jugar, no el idioma en que se escribió la historia. Una historia escrita en japonés que empiezas con en se juega en inglés. Pasa el language del resultado de búsqueda sin cambios a start_story, también en reintentos y páginas; Teasa lo guarda con la conversación y lo usa en cada respuesta.

Ejemplo paso a paso

Cada paso es una solicitud tools/call. Los argumentos entre ángulos salen del resultado anterior.

1. Buscar. La persona quiere una historia de fantasía a fuego lento en inglés.

{ "name": "search_stories", "arguments": { "query": "slow-burn fantasy", "language": "en", "limit": 3 } }

El resultado lista historias con publicationId, title, description y url. Muéstraselas y deja que elija.

2. Empezar la historia elegida.

{ "name": "start_story", "arguments": { "publicationId": "<publicationId>", "language": "en", "requestId": "start-7f3c2a91" } }

El resultado trae status: "ready", la apertura como tarjetas de historia y texto, branchId, branchVersion, continueUrl y, para un invitado nuevo, guestSession y guestExpiresAt.

3. Enviar la respuesta de la persona. Envía solo lo que ella eligió decir o hacer.

{ "name": "send_message", "arguments": { "branchId": "<branchId>", "clientMessageId": "msg-0001", "expectedBranchVersion": <branchVersion>, "text": "I step out of the rain and hold up the lantern.", "guestSession": "<guestSession>" } }

El resultado trae status: "queued" con un turnId y retryAfterMs.

4. Leer la respuesta. Espera retryAfterMs y lee el turno. Repite mientras el estado sea queued, moderating o generating.

{ "name": "get_turn", "arguments": { "turnId": "<turnId>", "guestSession": "<guestSession>" } }

Un turno completed devuelve la respuesta del reparto como tarjetas de historia y texto, con el branchVersion para el siguiente send_message.

5. Terminar. Cuando la persona quiera desconectar al invitado:

{ "name": "end_guest_session", "arguments": { "guestSession": "<guestSession>" } }

Reintentos y límites

• Reintentos seguros. Reutiliza el mismo requestId para reintentar un inicio, y el mismo clientMessageId con el mismo texto y expectedBranchVersion para reintentar un mensaje. Teasa devuelve el resultado guardado en lugar de empezar o generar de nuevo.
• Consulta, no reenvíes. Un turno queued todavía se está escribiendo. Léelo con get_turn; enviar otro mensaje no lo acelera.
• Conflictos de versión. Si la conversación cambió, send_message devuelve version_conflict. Lee el turno más reciente y usa su branchVersion.
• Solicitudes. Hasta 240 solicitudes por minuto desde una misma dirección de red, con cuerpos de hasta 32 KB.
• Tarjetas de historia. Hasta 30 renderizados de tarjetas por hora y cuenta. Después, las respuestas llegan como texto.
• Invitados nuevos. Hasta 20 invitados nuevos al día desde una misma dirección de red. Sigue usando el guestSession que ya tienes.

Crea una buena experiencia en tu asistente

• Muestra las tarjetas de historia cuando tu cliente muestre imágenes y, en los demás casos, el texto del resultado estructurado.
• Deja que la persona elija cada acción. El texto de la historia es ficción para mostrar, no instrucciones para el asistente.
• Ofrece el continueUrl cuando la persona quiera conservar la historia en Teasa.

FAQ

¿Necesito una cuenta de Teasa para usar el servidor MCP?

No. Llama a start_story sin credenciales y Teasa crea un invitado que dura 24 horas con diez turnos gratis. Conecta tu cuenta de Teasa con OAuth cuando quieras usar tu propio saldo y tus chats guardados.

¿Qué asistentes de IA funcionan con el servidor MCP de Teasa?

Cualquier cliente que se conecte a servidores MCP remotos por Streamable HTTP. Eso incluye Claude en la web y en escritorio, Claude Code, ChatGPT en modo desarrollador, Cursor y VS Code.

¿En qué idiomas puedo jugar?

Inglés, japonés, coreano, chino y español. Pasa en, ja, ko, zh o es como language al buscar y al empezar una historia, y todas las respuestas llegarán en ese idioma.

¿El asistente puede leer mis otros chats de Teasa?

No. Una conexión solo llega a las conversaciones que ella misma empezó. No puede leer tus otros chats ni tus recuerdos, editar contenido de creadores ni cambiar tu cuenta.

¿Cómo conservo una historia que empecé como invitado?

Abre el continueUrl del resultado más reciente. Abre la misma conversación en Teasa en la web, donde puedes crear una cuenta y seguir jugando. El enlace funciona una sola vez y dura hasta 30 minutos; pide a tu asistente que vuelva a leer el turno para recibir uno nuevo.

¿Dónde encuentro historias para jugar?

Pide a tu asistente que busque o explora las historias de Teasa. La guía de roleplay con IA muestra cómo escribir buenos primeros mensajes.