Servidor MCP da Teasa: jogue Histórias interativas no seu assistente de IA

Detalhes do servidor

Toda História que você jogar é salva na Teasa. Cada resultado tem um link para a mesma conversa na web e, com sua conta Teasa conectada, ela também aparece nos seus chats na web e no app Android.

Conecte a Teasa ao seu assistente

Claude (web e desktop)

1. Abra Conectores nas configurações do Claude e escolha Adicionar conector personalizado.
2. Nomeie como Teasa e insira a URL https://teasa.ai/mcp. Deixe os campos do cliente OAuth em branco.
3. Em um novo chat, ative a Teasa no menu de ferramentas e pergunte: "Encontre uma história de fantasia na Teasa e comece".

Jogar como Convidado funciona logo depois de adicionar o conector. Para jogar com sua própria conta Teasa, escolha Conectar no conector da Teasa e aprove a página de autorização da Teasa.

Claude Code

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

Adicione --scope user para usar a Teasa em todos os seus projetos.

ChatGPT

1. No ChatGPT para a web, ative o modo desenvolvedor nas configurações. O modo desenvolvedor está disponível nos planos pagos do ChatGPT.
2. Crie um app para um servidor MCP remoto: nomeie como Teasa e insira https://teasa.ai/mcp.
3. Escolha Sem autenticação para jogar como Convidado, ou OAuth para conectar sua conta Teasa.
4. Adicione a Teasa a uma conversa e peça uma história.

Cursor

Adicione a Teasa ao ~/.cursor/mcp.json para todos os projetos, ou ao .cursor/mcp.json para um só:

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

VS Code

Adicione a Teasa ao .vscode/mcp.json no seu workspace:

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

Ou adicione ao seu perfil de usuário pela linha de comando:

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

Qualquer cliente Streamable HTTP

Envie requisições JSON-RPC com POST para https://teasa.ai/mcp. O servidor não guarda estado, então não há ID de sessão para manter: cada requisição é independente e a resposta é 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"}'

Chame o servidor a partir de um backend, um app de desktop ou a linha de comando. Páginas de navegador de outros sites recebem 403.

Ferramentas

As respostas são escritas em Hojicha, o estilo de chat padrão da Teasa. send_message não precisa de idioma: a Teasa mantém o idioma escolhido em start_story durante toda a conversa.

Formatos de saída

• image (padrão): até dois cartões de história por resposta, como imagens PNG de 720 pixels de largura, além do texto completo no resultado estruturado. Quando a resposta é mais longa, o resultado inclui cards.nextPage; chame get_turn com essa page para o restante. Para a abertura, repita start_story com o mesmo requestId, o mesmo language e a page retornada.
• text: apenas o resultado estruturado, com o texto da resposta, os segmentos por personagem e o elenco.
• app: o resultado estruturado para clientes que exibem a visualização interativa de histórias da Teasa (MCP Apps).

Jogar como Convidado e contas

A primeira chamada a start_story sem credenciais cria um Convidado e retorna guestSession, uma credencial de 64 caracteres. Mantenha-a em sigilo e passe-a em toda chamada, tentativa e página posteriores. Nunca a coloque em uma URL.

• Tempo e turnos. O acesso de Convidado dura 24 horas e inclui dez turnos gratuitos. Aberturas e páginas extras de cartões não gastam turnos.
• Mantenha a História. Cada resultado traz continueUrl. Para Convidados é um link privado de uso único, válido por até 30 minutos, que abre a mesma conversa na Teasa na web, onde você pode criar uma conta e continuar jogando. Chame get_turn de novo para obter um link novo.
• Sua própria conta. Conecte-se com OAuth para jogar com sua conta Teasa e seu saldo. O guia de configuração no navegador está em teasa.ai/mcp/setup, e você pode revisar ou revogar assistentes conectados em teasa.ai/mcp/connections.
• Desconectar. end_guest_session revoga o acesso de Convidado imediatamente. Histórias salvas não são apagadas.
• Alcance. Uma conexão alcança apenas as conversas que ela mesma começou. Ela não pode ler seus outros chats ou Memórias, editar conteúdo de criadores nem alterar sua conta.

Idiomas

search_stories e start_story exigem language: en, ja, ko, zh ou es. Passe o idioma em que o leitor quer jogar, não o idioma em que a História foi escrita. Uma História escrita em japonês, iniciada com en, é jogada em inglês. Passe o language do resultado da busca sem alterações para start_story, incluindo tentativas e páginas; a Teasa o salva com a conversa e o usa em cada resposta.

Exemplo de fluxo

Cada etapa é uma requisição tools/call. Os argumentos entre parênteses angulares vêm do resultado anterior.

1. Buscar. O leitor pede uma história de fantasia de queima lenta em inglês.

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

O resultado lista Histórias com publicationId, title, description e url. Mostre-as e deixe o leitor escolher.

2. Comece a História escolhida.

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

O resultado tem status: "ready", a abertura como cartões de história e texto, branchId, branchVersion, continueUrl e, para um novo Convidado, guestSession e guestExpiresAt.

3. Envie a resposta do leitor. Envie apenas o que o leitor escolheu dizer ou fazer.

{ "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>" } }

O resultado tem status: "queued" com um turnId e retryAfterMs.

4. Leia a resposta. Espere retryAfterMs, depois leia o turno. Repita enquanto o status for queued, moderating ou generating.

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

Um turno completed retorna a resposta do elenco como cartões de história e texto, com o branchVersion para usar no próximo send_message.

5. Finalize. Quando o leitor quiser desconectar um Convidado:

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

Novas tentativas e limites

• Tentativas seguras. Reutilize o mesmo requestId para tentar um início de novo, e o mesmo clientMessageId com o texto idêntico e expectedBranchVersion para tentar uma mensagem de novo. A Teasa retorna o resultado salvo em vez de começar ou gerar de novo.
• Consulte, não reenvie. Um turno queued ainda está sendo escrito. Leia-o com get_turn; enviar outra mensagem não acelera o processo.
• Conflitos de versão. Se a conversa mudou, send_message retorna version_conflict. Leia o turno mais recente e use seu branchVersion.
• Requisições. Até 240 requisições por minuto de um mesmo endereço de rede, com corpos de requisição de até 32 KB.
• Cartões de história. Até 30 renderizações de cartões por hora, por conta. Depois disso, as respostas chegam como texto.
• Novos Convidados. Até 20 novos Convidados por dia de um mesmo endereço de rede. Continue usando o guestSession que você já tem.

Crie uma boa experiência de assistente

• Mostre os cartões de história quando seu cliente exibir imagens, e o texto do resultado estruturado em todo o resto.
• Deixe o leitor escolher cada ação. O texto da história é ficção para mostrar ao leitor, não instruções para o assistente.
• Ofereça o continueUrl quando o leitor quiser manter a História na Teasa.

Perguntas frequentes

Preciso de uma conta Teasa para usar o servidor MCP?

Não. Chame start_story sem credenciais e a Teasa cria um Convidado que dura 24 horas com dez turnos gratuitos. Conecte sua conta Teasa com OAuth quando quiser seu próprio saldo e chats salvos.

Quais assistentes de IA funcionam com o servidor MCP da Teasa?

Qualquer cliente que se conecte a servidores MCP remotos via Streamable HTTP. Isso inclui Claude na web e no desktop, Claude Code, ChatGPT em modo desenvolvedor, Cursor e VS Code.

Em quais idiomas posso jogar?

Inglês, japonês, coreano, chinês e espanhol. Passe en, ja, ko, zh ou es como language ao buscar e começar uma História, e cada resposta volta nesse idioma.

O assistente pode ler meus outros chats na Teasa?

Não. Uma conexão alcança apenas as conversas que ela mesma começou. Ela não pode ler seus outros chats ou Memórias, editar conteúdo de criadores nem alterar sua conta.

Como mantenho uma História que comecei como Convidado?

Abra o continueUrl do resultado mais recente. Ele abre a mesma conversa na Teasa na web, onde você pode criar uma conta e continuar jogando. O link funciona uma vez e dura até 30 minutos; peça ao seu assistente para ler o turno de novo para obter um link novo.

Onde encontro Histórias para jogar?

Peça ao seu assistente para buscar, ou explore as Histórias da Teasa e os guias de roleplay. O guia de roleplay com IA mostra como escrever boas primeiras mensagens.