Serveur MCP Teasa : joue à des histoires interactives dans ton assistant IA

Informations du serveur

Chaque histoire que tu joues est enregistrée dans Teasa. Chaque résultat renvoie vers la même conversation sur le web. Si ton compte Teasa est connecté, elle apparaît aussi dans tes conversations sur le web et dans l’application Android.

Connecter Teasa à ton assistant

Claude sur le web et sur ordinateur

1. Ouvre Connectors dans les réglages de Claude et choisis Add custom connector.
2. Nomme le connecteur Teasa et saisis https://teasa.ai/mcp. Laisse les champs du client OAuth vides.
3. Dans une nouvelle conversation, active Teasa dans le menu des outils et demande : « Trouve une histoire de fantasy sur Teasa et démarre-la. »

Le mode invité fonctionne dès l’ajout du connecteur. Pour jouer avec ton compte Teasa, choisis Connect sur le connecteur Teasa et approuve la page d’autorisation de Teasa.

Claude Code

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

Ajoute --scope user pour utiliser Teasa dans tous tes projets.

ChatGPT

1. Sur ChatGPT pour le web, active Developer mode dans les réglages. Ce mode est disponible avec les offres payantes de ChatGPT.
2. Crée une application pour un serveur MCP distant : nomme-la Teasa et saisis https://teasa.ai/mcp.
3. Choisis No authentication pour le mode invité, ou OAuth pour connecter ton compte Teasa.
4. Ajoute Teasa à une conversation et demande une histoire.

Cursor

Ajoute Teasa à ~/.cursor/mcp.json pour tous tes projets, ou à .cursor/mcp.json pour un seul :

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

VS Code

Ajoute Teasa à .vscode/mcp.json dans ton espace de travail :

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

Tu peux aussi l’ajouter à ton profil utilisateur depuis la ligne de commande :

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

Tout client Streamable HTTP

Envoie des requêtes JSON-RPC avec POST à https://teasa.ai/mcp. Le serveur fonctionne sans état : aucun identifiant de session n’est à conserver. Chaque requête est autonome et la réponse est en 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"}'

Appelle le serveur depuis un backend, une application de bureau ou la ligne de commande. Les pages web d’autres sites reçoivent une réponse 403.

Outils

Les réponses utilisent Hojicha, le style de chat par défaut de Teasa. send_message n’a pas besoin de langue : Teasa conserve celle choisie dans start_story pour toute la conversation.

Formats de sortie

• image par défaut : jusqu’à deux cartes d’histoire par réponse, sous forme d’images PNG de 720 pixels de large, avec le texte complet dans le résultat structuré. Une réponse plus longue inclut cards.nextPage : appelle get_turn avec cette page pour lire la suite. Pour l’ouverture, rappelle start_story avec les mêmes requestId et language, ainsi que la page renvoyée.
• text : le résultat structuré seul, avec le texte, les segments par locuteur et les personnages.
• app : le résultat structuré pour les clients qui affichent la vue interactive de Teasa, via MCP Apps.

Mode invité et comptes

Le premier appel à start_story sans authentification crée un invité et renvoie guestSession, un identifiant secret de 64 caractères. Garde-le privé et transmets-le à chaque appel suivant, nouvelle tentative et page. Ne le mets jamais dans une URL.

• Durée et tours. L’accès invité dure 24 heures et comprend 20 tours gratuits. Les ouvertures et les pages de cartes supplémentaires ne consomment aucun tour.
• Conserver l’histoire. Chaque résultat contient continueUrl. Pour les invités, c’est un lien privé à usage unique, valable jusqu’à 30 minutes. Il ouvre la même conversation dans Teasa sur le web, où tu peux créer un compte et continuer à jouer. Rappelle get_turn pour obtenir un nouveau lien.
• Ton compte. Connecte-toi avec OAuth pour utiliser ton compte Teasa et son quota. Le guide de configuration est sur teasa.ai/mcp/setup. Consulte ou révoque tes assistants connectés sur teasa.ai/mcp/connections.
• Déconnexion. end_guest_session révoque immédiatement l’accès invité. Les histoires enregistrées restent conservées.
• Accès. Une connexion accède uniquement aux conversations qu’elle a démarrées. Elle ne peut pas lire tes autres conversations ou souvenirs, modifier tes créations ou changer ton compte.

Langues

search_stories et start_story exigent le paramètre language : en, ja, ko, zh, es, pt ou fr. Indique la langue dans laquelle tu veux jouer. Une histoire écrite en japonais et démarrée avec fr se joue en français. Transmets la valeur language du résultat de recherche sans la changer à start_story, y compris lors des nouvelles tentatives et de la pagination. Teasa l’enregistre avec la conversation et l’utilise pour chaque réponse.

Exemple de parcours

Chaque étape est une requête tools/call. Les paramètres entre chevrons viennent du résultat précédent.

1. Rechercher. Le joueur demande une histoire de fantasy avec une romance progressive, en français.

{ "name": "search_stories", "arguments": { "query": "romance progressive fantasy", "language": "fr", "limit": 3 } }

Le résultat liste les histoires avec publicationId, title, description et url. Affiche-les et laisse le joueur choisir.

2. Démarrer l’histoire choisie.

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

Le résultat contient status: "ready", l’ouverture en cartes et en texte, branchId, branchVersion et continueUrl. Pour un nouvel invité, il comprend aussi guestSession et guestExpiresAt.

3. Envoyer la réponse du joueur. Envoie uniquement ce que le joueur a choisi de dire ou de faire.

{ "name": "send_message", "arguments": { "branchId": "<branchId>", "clientMessageId": "msg-0001", "expectedBranchVersion": <branchVersion>, "text": "Je sors de la pluie et je lève la lanterne.", "guestSession": "<guestSession>" } }

Le résultat contient status: "queued", turnId et retryAfterMs.

4. Lire la réponse. Attends retryAfterMs, puis lis le tour. Répète tant que son état est queued, moderating ou generating.

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

Un tour completed renvoie la réponse des personnages en cartes et en texte, avec la branchVersion à utiliser pour le prochain send_message.

5. Terminer. Quand le joueur veut déconnecter un invité :

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

Nouvelles tentatives et limites

• Réessayer sans doublon. Réutilise le même requestId pour relancer un démarrage, et le même clientMessageId avec un texte et une expectedBranchVersion identiques pour relancer un message. Teasa renvoie le résultat enregistré.
• Consulter l’état. Un tour en attente est encore en cours d’écriture. Lis-le avec get_turn ; envoyer un autre message ne l’accélère pas.
• Conflits de version. Si la conversation a changé, send_message renvoie version_conflict. Lis le dernier tour et utilise sa branchVersion.
• Requêtes. Jusqu’à 240 requêtes par minute depuis une même adresse réseau, avec des corps de requête jusqu’à 32 Ko.
• Cartes d’histoire. Jusqu’à 30 rendus de cartes par heure et par compte. Les réponses suivantes arrivent en texte.
• Nouveaux invités. Jusqu’à 20 nouveaux invités par jour depuis une même adresse réseau. Continue d’utiliser la guestSession existante.

Créer une bonne expérience dans l’assistant

• Affiche les cartes si ton client prend en charge les images, et le texte du résultat structuré dans les autres cas.
• Laisse le joueur choisir chaque action. Le texte de l’histoire est une fiction à afficher au joueur.
• Propose continueUrl quand le joueur souhaite retrouver son histoire dans Teasa.

Questions fréquentes

Ai-je besoin d’un compte Teasa pour utiliser le serveur MCP ?

Non. Appelle start_story sans authentification : Teasa crée un invité valable 24 heures, avec 20 tours gratuits. Connecte ton compte Teasa avec OAuth pour utiliser ton quota et retrouver tes conversations enregistrées.

Quels assistants IA fonctionnent avec le serveur MCP de Teasa ?

Tout client qui se connecte aux serveurs MCP distants en Streamable HTTP, dont Claude sur le web et sur ordinateur, Claude Code, ChatGPT en mode développeur, Cursor et VS Code.

Dans quelles langues puis-je jouer ?

En anglais, japonais, coréen, chinois, espagnol, portugais et français. Passe en, ja, ko, zh, es, pt ou fr comme language lors de la recherche et du démarrage. Chaque réponse arrive dans cette langue.

L’assistant peut-il lire mes autres conversations Teasa ?

Non. Une connexion accède uniquement aux conversations qu’elle a démarrées. Elle ne peut pas lire tes autres conversations ou souvenirs, modifier tes créations ou changer ton compte.

Comment conserver une histoire commencée en mode invité ?

Ouvre le continueUrl du dernier résultat. Il ouvre la même conversation dans Teasa sur le web, où tu peux créer un compte et continuer à jouer. Le lien fonctionne une seule fois et reste valable jusqu’à 30 minutes. Demande à ton assistant de relire le tour pour obtenir un nouveau lien.

Où trouver des histoires à jouer ?

Demande à ton assistant de chercher, ou explore les histoires de Teasa. Le centre d’aide explique comment commencer. Le guide du jeu de rôle avec IA montre comment écrire de bonnes premières répliques.