Connecter VoLog à votre assistant IA

Ce que permet le Connecteur VoLog

Le Connecteur VoLog permet à votre assistant IA de lire vos campagnes et vos sessions VoLog. Vous pouvez ensuite lui demander de retrouver un détail d'une partie passée ou de vous aider à préparer la prochaine, sans recopier vos notes.

L'accès est en lecture seule : votre assistant IA ne peut rien modifier, supprimer ni partager dans VoLog. Il ne lit que les contenus de votre compte.

Avant de commencer

• Un compte VoLog.
• Au moins une session dans l'Atelier pour obtenir des résultats. Un compte sans session peut se connecter, mais votre assistant IA n'y trouvera rien à lire.
• Pour Claude : un compte Claude. Le Connecteur VoLog s'y ajoute comme connecteur personnalisé, par son adresse, sur tous les plans. Le plan gratuit de Claude n'accepte qu'un seul connecteur personnalisé.
• Pour Le Chat : un compte Le Chat. Le connecteur personnalisé y est gratuit. Son ajout est réservé à l'administrateur de l'espace de travail ; sur un plan individuel, le titulaire du compte l'est par défaut.

L'adresse du connecteur est https://volog.app/mcp. Vous la retrouvez avec le bouton Copier sous Adresse du connecteur, dans la page Connecteur VoLog de votre compte.

Les libellés de Claude et de Le Chat cités dans ce guide sont ceux de leur documentation, en anglais. Votre interface peut les afficher dans votre langue.

Connecter Claude

Sur le web ou dans l'application de bureau de Claude :

1. Ouvrez Customize > Connectors.
2. Sélectionnez Add custom connector.
3. Saisissez un nom, par exemple VoLog, puis l'adresse https://volog.app/mcp.
4. Laissez vides les champs d'identifiant et de secret : VoLog n'en demande pas. Si Claude demande une méthode d'authentification (Authentication), choisissez Sign in now ou Sign in when needed, jamais No sign-in : VoLog demande toujours de vous connecter. Si Claude propose plusieurs façons de s'identifier, gardez l'option recommandée, Use Claude's published identity.
5. Validez avec Add.
6. Sélectionnez Connect. Claude ouvre VoLog : connectez-vous si nécessaire, vérifiez l'écran d'autorisation, puis choisissez Autoriser.

Dans une conversation, ouvrez le menu +, puis Connectors, et vérifiez que le connecteur VoLog est activé.

Sur téléphone, ajoutez le connecteur depuis le web ou l'application de bureau : son ajout depuis les applications mobiles de Claude est encore en bêta. Une fois ajouté à votre compte Claude, il est aussi disponible dans l'application mobile.

Sur un plan Team ou Enterprise, un propriétaire de l'organisation ajoute d'abord le connecteur. Chaque membre se connecte ensuite avec son propre compte VoLog, depuis Customize > Connectors, avec Connect.

Connecter Le Chat

1. Ouvrez la page Connectors de Le Chat.
2. Sélectionnez + Add Connector, puis l'onglet des connecteurs personnalisés.
3. Saisissez un nom de connecteur sans espace, par exemple VoLog, puis l'adresse du serveur https://volog.app/mcp.
4. Sélectionnez Connect. Le Chat détecte la méthode de connexion et ouvre VoLog : connectez-vous si nécessaire, vérifiez l'écran d'autorisation, puis choisissez Autoriser.

Pour Le Chat, l'écran d'autorisation porte la mention Application non vérifiée et s'affiche à chaque nouvelle autorisation. Choisissez Autoriser seulement si vous venez de lancer la connexion depuis Le Chat.

Dans une conversation, ouvrez le menu + ou tapez /, sélectionnez Tools, puis activez le connecteur VoLog.

Vérifier l'écran d'autorisation

Avant tout accès, VoLog affiche l'écran Connecter votre assistant IA. Il indique :

• le nom déclaré par l'application qui demande l'accès et le compte VoLog connecté ;
• après Retour vers, le domaine auquel VoLog renverra la réponse, par exemple claude.ai pour Claude ;
• Application vérifiée lorsque VoLog reconnaît l'adresse de retour exacte de l'assistant IA, comme celle de Claude, sinon Application non vérifiée ;
• un avertissement lorsque l'application tourne sur votre ordinateur ou s'ouvre par un logiciel installé sur votre appareil, comme les outils de développement de la dernière section ;
• l'accès demandé, Lire vos Campagnes et Sessions, en lecture seule ;
• la phrase « Ce que votre assistant IA lit suit ses propres règles. » ;
• la mention « Vous pourrez retirer cet accès à tout moment depuis votre compte. ».

Ne continuez que si vous venez de lancer la connexion depuis votre assistant IA. Refuser renvoie vers l'application sans lui donner accès.

Après Autoriser, une application vérifiée, comme Claude, ne revoit pas cet écran tant que vous ne lui retirez pas l'accès. Une application non vérifiée, comme Le Chat, ou qui tourne sur votre appareil, l'affiche à chaque nouvelle autorisation.

Ce que votre assistant IA lit suit ses propres règles, par exemple pour la conservation des conversations. VoLog ne les contrôle pas : consultez les réglages de votre assistant IA avant de lui confier vos contenus.

Le Connecteur VoLog est inclus dans votre compte. Les lectures de votre assistant IA ne consomment aucun crédit et ne demandent aucun achat.

Ce que vous pouvez demander

Une fois le connecteur activé, posez vos questions à votre assistant IA comme d'habitude. Il interroge VoLog quand c'est utile, et VoLog lui transmet, pour chaque élément, le lien de sa page dans l'Atelier.

Pour retrouver un détail de campagne :

• « Qu'a promis Varek aux joueurs il y a trois sessions ? »
• « Liste les lieux visités dans la campagne La Couronne de cendres. »

Pour préparer la prochaine partie :

• « Prépare un récapitulatif à lire à la table avant de jouer. »
• « Quels fils narratifs sont restés ouverts ? Propose quelques accroches. »

Le connecteur propose aussi deux demandes prêtes à l'emploi : Récapitulatif de début de partie et Préparer la prochaine Session. Choisissez la campagne concernée ; votre assistant IA lit ses dernières sessions et rédige le résultat. Elles apparaissent dans les assistants IA qui les prennent en charge ; Le Chat ne les affiche pas pour un connecteur personnalisé. Vous pouvez toujours formuler la même demande avec vos mots.

Votre assistant IA peut lire :

• vos campagnes : nom, système de jeu, cadre de campagne et chronique ;
• vos sessions non archivées et leurs contenus disponibles : note complète, résumé de la session, compte rendu, moments forts et variantes de note ;
• les fiches des personnages, lieux, objets, sorts et pouvoirs.

Ce que votre assistant IA ne lit pas

• les transcriptions ;
• les images : illustrations, portraits et médias ajoutés à une note ;
• les parties Discord qui n'ont pas de session ;
• les contenus archivés ;
• l'historique de VoLog Search ;
• les partages publics d'autres comptes et vos favoris.

Tant qu'une session est en cours de préparation, ou que sa note complète attend votre relecture, votre assistant IA n'en lit aucun contenu.

Retirer l'accès

1. Ouvrez la page Connecteur VoLog, depuis l'onglet Connecteur VoLog de votre compte.
2. Dans Applications connectées, repérez l'application. Chacune affiche son nom, sa mention, sa date d'autorisation et son dernier usage.
3. Sélectionnez Retirer l'accès, puis confirmez.

Le retrait prend effet immédiatement : la demande suivante de cette application est refusée, même si son accès venait d'être accordé. Les autres applications gardent le leur. Pour la reconnecter, relancez la connexion depuis votre assistant IA : l'écran d'autorisation s'affiche de nouveau.

Un nouveau mot de passe, enregistré depuis l'onglet Mot de passe de votre compte ou par réinitialisation, retire l'accès de toutes les applications connectées. Une application inutilisée pendant 90 jours perd aussi son accès.

Retirer l'accès dans VoLog ne retire pas le connecteur de votre assistant IA et n'efface pas ce qu'il a déjà lu : gérez-les dans ses propres réglages.

Dépannage

La connexion échoue ou a expiré

Une demande de connexion reste valable 10 minutes. Si VoLog affiche Connexion impossible avec « Cette demande de connexion a expiré ou a déjà été traitée », relancez la connexion depuis votre assistant IA, par exemple avec Connect dans Claude. Si VoLog indique ne pas avoir pu vérifier l'application, réessayez dans quelques instants.

L'écran affiche Application non vérifiée

VoLog ne reconnaît pas l'adresse de retour de l'application. C'est attendu avec Le Chat et avec un outil de développement qui tourne sur votre ordinateur. Ne continuez que si vous venez de lancer la connexion depuis votre assistant IA ou votre outil. Pour un assistant IA sur le web, vérifiez aussi que le domaine affiché après Retour vers est bien le sien. Sinon, choisissez Refuser.

Votre assistant IA ne trouve rien

• Vérifiez que le connecteur est activé dans la conversation.
• Vérifiez que l'application figure dans Applications connectées, sur la page Connecteur VoLog du compte VoLog qui contient vos sessions. L'écran d'autorisation, lorsqu'il s'affiche, indique aussi le compte connecté.
• Un compte sans session ne renvoie aucun résultat. Votre assistant IA reçoit alors un message neutre et un lien vers l'Atelier.
• Les sessions archivées ne sont jamais lues. Restaurez-les depuis les archives de l'Atelier si votre assistant IA doit les retrouver.

La limite d'appels est atteinte

Chaque application connectée peut faire jusqu'à 60 appels par minute, dont 20 recherches, et 2 000 appels par jour. Au-delà, VoLog refuse temporairement ses appels et votre assistant IA affiche une erreur. Attendez une minute, ou jusqu'à 24 heures si la limite quotidienne est atteinte, puis relancez votre demande.

Votre assistant IA demande de se reconnecter

Après un retrait d'accès, un changement de mot de passe ou 90 jours sans usage, l'ancienne connexion ne fonctionne plus. Relancez la connexion depuis votre assistant IA, par exemple avec Connect dans Customize > Connectors de Claude, et connectez-vous à VoLog si nécessaire.

Après un retrait d'accès ou un changement de mot de passe, l'écran d'autorisation s'affiche de nouveau : choisissez Autoriser. Après 90 jours sans usage, une application vérifiée, comme Claude, se reconnecte sans repasser par cet écran ; choisissez Autoriser seulement s'il s'affiche.

Contacter le support

Si le problème continue, écrivez à contact@volog.app depuis l'adresse de votre compte VoLog. Indiquez votre assistant IA, l'étape qui échoue et le message affiché. N'envoyez jamais votre mot de passe.

Connecter Claude Code, Cursor ou VS Code

Ces outils de développement se connectent au serveur MCP VoLog, https://volog.app/mcp, en HTTP, puis ouvrent la connexion à VoLog dans votre navigateur. Rien d'autre n'est à saisir : vous vous connectez avec votre compte VoLog.

Comme la réponse revient en général à un programme de votre ordinateur, l'écran d'autorisation porte alors la mention Application non vérifiée et un avertissement, et il s'affiche à chaque nouvelle autorisation.

Claude Code

claude mcp add --transport http volog https://volog.app/mcp

Ajoutez l'option --scope user pour rendre le serveur disponible dans tous vos projets. Dans Claude Code, lancez ensuite /mcp et suivez les étapes de connexion dans votre navigateur.

Cursor

Ajoutez le serveur dans ~/.cursor/mcp.json pour tous vos projets, ou dans .cursor/mcp.json pour un seul projet :

{
  "mcpServers": {
    "volog": {
      "url": "https://volog.app/mcp"
    }
  }
}

Lancez ensuite l'authentification du serveur volog proposée par Cursor : la page VoLog s'ouvre dans votre navigateur.

VS Code

Ajoutez le serveur dans .vscode/mcp.json pour un projet, ou dans la configuration utilisateur ouverte par la commande MCP: Open User Configuration :

{
  "servers": {
    "volog": {
      "type": "http",
      "url": "https://volog.app/mcp"
    }
  }
}

Confirmez que vous faites confiance au serveur lorsque VS Code le demande. À la première connexion, VS Code ouvre la page VoLog dans votre navigateur.

Dans ces outils, les deux demandes prêtes à l'emploi sont des prompts du serveur MCP, nommés game_start_recap et prepare_next_session.