Connecter une IA à Dunjn

Dunjn expose chaque campagne à l’IA de votre choix à travers un serveur MCP (Model Context Protocol). L’IA lit votre wiki, vos sessions et vos notes, crée ou modifie des entités, prépare des rencontres. C’est elle qui rédige, avec son propre abonnement chez son fournisseur : Dunjn ne facture rien pour l’IA.

L’essentiel

• Endpoint : https://app.dunjn.io/api/mcp/v1 (MCP Streamable HTTP, requêtes JSON-RPC en POST).
• Authentification : OAuth 2.1 avec PKCE (recommandé), ou clé API personnelle en en-tête Authorization: Bearer.
• Permissions : dunjn:read (lecture), dunjn:write (écriture), dunjn:rag (recherche sémantique, option désactivée par défaut).
• Découverte : https://app.dunjn.io/.well-known/oauth-authorization-server et https://app.dunjn.io/.well-known/oauth-protected-resource.
• Outils : tous préfixés par dunjn_. Liste exacte dans Outils et prompts MCP.

Méthode 1 : connexion OAuth (recommandée)

Pour les clients qui gèrent les serveurs MCP distants : Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Cursor et les autres.

1. Dans votre client, ajoutez un connecteur ou un serveur MCP distant et collez l’URL de l’endpoint.
2. Le client vous envoie sur une page de consentement Dunjn. Connectez-vous et autorisez l’accès.
3. L’application apparaît dans « Applications connectées » de votre profil Dunjn. Vous pouvez révoquer l’accès à tout moment depuis cette page.

Aucune clé à copier, aucun identifiant client à demander : l’enregistrement dynamique des clients est pris en charge.

Exemple avec Claude Code :

claude mcp add --transport http dunjn https://app.dunjn.io/api/mcp/v1

Puis tapez /mcp dans Claude Code pour lancer l’authentification.

Méthode 2 : clé API personnelle

Pour les clients qui ne gèrent pas OAuth mais acceptent un en-tête HTTP, et pour vos propres scripts.

1. Dans Dunjn : Profil, puis Clés API, puis Générer une clé. Elle commence par dunjn_pak_. Vous pouvez la limiter à la lecture seule et la restreindre à certaines campagnes.
2. Envoyez-la en en-tête Authorization: Bearer dunjn_pak_… sur l’endpoint.

Exemple de configuration pour Cursor, dans .cursor/mcp.json :

{
  "mcpServers": {
    "dunjn": {
      "url": "https://app.dunjn.io/api/mcp/v1",
      "headers": { "Authorization": "Bearer dunjn_pak_xxx" }
    }
  }
}

Clients qui ne lancent que des serveurs locaux

Pour un client qui ne sait démarrer que des serveurs MCP locaux (un fichier de configuration qui attend une commande, pas une URL), le pont dunjn-mcp relaie l’entrée standard vers l’endpoint HTTPS avec votre clé. Node.js 18 ou plus est requis.

{
  "mcpServers": {
    "dunjn": {
      "command": "npx",
      "args": ["-y", "dunjn-mcp@latest"],
      "env": { "DUNJN_API_TOKEN": "dunjn_pak_xxx" }
    }
  }
}

Code source : github.com/Liendaar/dunjn-mcp.

Une clé API est un mot de passe : ne la partagez pas, et révoquez-la depuis la page Clés API si elle fuite.

Première conversation

Une fois connecté, demandez à votre IA de lister vos campagnes (outil dunjn_list_campaigns), puis de choisir celle sur laquelle travailler (dunjn_set_active_campaign). Ensuite, parlez-lui comme à un co-MJ : « Crée le tavernier de Padhrone et lie-le à l’auberge. » Elle appelle les outils Dunjn, et le résultat apparaît dans votre wiki.

Six prompts prêts à l’emploi, nommés d’après le Conseil des Mages, donnent un rôle à l’assistant :

• dunjn_salmanazar : assistant MJ généraliste qui pilote Dunjn.
• dunjn_melchizedek : création d’entités (PNJ, monstres, lieux).
• dunjn_balthazar : rédaction de notes de session et de lore.
• dunjn_nabuchodonosor : conception de rencontres complètes.
• dunjn_jeroboam : préparation complète d’une session.
• dunjn_rehoboam : mise en forme de notes existantes.

Ce que l’IA peut faire

• Lire : campagnes, entités, sessions, notes du monde, tables de jet, images.
• Écrire : créer et modifier des entités, des relations, des sessions, des rencontres, des notes (section par section), des tags, des tables de jet ; téléverser des images.
• Rien n’est généré côté Dunjn : c’est le modèle de votre client qui écrit. Dunjn ne consomme ni ne facture de crédits IA.

Sécurité et confidentialité

• Chaque accès est lié à votre compte : une clé ou une application connectée ne voit que vos campagnes, et seulement celles que vous lui ouvrez.
• Révocation à tout moment depuis votre profil (clés API et applications connectées).
• L’IA lit vos campagnes avec votre compte chez son fournisseur. L’usage de ces données relève des conditions de ce fournisseur.
• Dunjn n’entraîne aucun modèle avec vos contenus.