Accueil/Guide d'installation

Guide d'installation

Installer le serveur MCP Patriboum

Une URL à coller dans votre assistant : Claude Desktop, Claude Code, Cursor, ZCode, Windsurf, VS Code, Gemini CLI. Aucun compte à créer, aucun paiement, aucun logiciel à installer.

  • 7 clients supportés
  • ~2 minutes
  • Gratuit

Une seule information suffit : l'URL du serveur https://patriboum.com/mcp. Transport MCP streamable HTTP, stateless, compatible tous les clients MCP modernes. Aucun process local, aucune clé d'API, gratuit.

Prérequis

  • Un client MCP avec support du transport HTTP streamable (tous les clients majeurs depuis 2025) ;
  • Une connexion internet. Le serveur est public : les sessions créées disposent d'une URL de visualisation partageable.

Claude Desktop

Option interface : Paramètres → Connecteurs → « Ajouter un connecteur personnalisé » → collez https://patriboum.com/mcp.

Option fichier de config (claude_desktop_config.json, via Paramètres → Développeur → « Modifier la config ») :

{
  "mcpServers": {
    "patriboum": {
      "type": "http",
      "url": "https://patriboum.com/mcp"
    }
  }
}

Redémarrez Claude Desktop, puis vérifiez que les tools patriboum apparaissent dans une conversation.

Claude Code

claude mcp add --transport http patriboum https://patriboum.com/mcp

Vérification : claude mcp list doit afficher patriboum: … - Connected.

Cursor

Option interface : Paramètres → Cursor Settings → MCP → « Add new MCP server » → nom patriboum, type HTTP, URL https://patriboum.com/mcp.

Option fichier (.cursor/mcp.json) :

{
  "mcpServers": {
    "patriboum": {
      "url": "https://patriboum.com/mcp"
    }
  }
}

ZCode

Settings → MCP → « Ajouter un serveur distant » → type url → https://patriboum.com/mcp.

En ligne de commande :

zcode mcp add --transport http patriboum https://patriboum.com/mcp

Windsurf

Cascade → icône MCP → « View raw config » ou éditez directement ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "patriboum": {
      "serverUrl": "https://patriboum.com/mcp"
    }
  }
}

Puis « Refresh » dans le panneau MCP.

VS Code (GitHub Copilot)

Ajoutez un serveur dans .vscode/mcp.json (ou via la palette de commandes : « MCP: Add Server », type HTTP) :

{
  "servers": {
    "patriboum": {
      "type": "http",
      "url": "https://patriboum.com/mcp"
    }
  }
}

Gemini CLI

Dans ~/.gemini/settings.json :

{
  "mcpServers": {
    "patriboum": {
      "httpUrl": "https://patriboum.com/mcp"
    }
  }
}

Autres clients

Patriboum étant un serveur MCP streamable HTTP stateless, tout client supportant ce transport fonctionne : configurez une URL distante pointant vers https://patriboum.com/mcp. Aucun header d'authentification requis.

Première utilisation

Dans une conversation avec votre agent, essayez :

Liste les types de nœuds disponibles dans Patriboum.

puis :

Construis le patrimoine d'un couple de 40 ans : deux PEA (200 k€), une
assurance-vie (80 k€), un appartement locatif financé à crédit (240 k€
sur 20 ans à 3,5 %). DCA 2 000 €/mois réparti intelligemment. Simule sur
25 ans en Monte Carlo et montre-moi le lien de visualisation.

L'agent créera la session, construira le graphe, simulera — et vous donnera une URL patriboum.com/app?load=<id> à ouvrir dans votre navigateur : le graphe et le rapport y sont chargés dans l'application.

Workflow conseillé avec un client :

  1. décrivez sa situation (ou celle de votre client) en langage naturel ;
  2. laissez l'agent construire et simuler ;
  3. envoyez le viewUrl au client : il ouvre l'app avec la session chargée ;
  4. itérez (« et si krach en année 8 ? », « compare avec 100 % SCPI »…).

Auto-hébergement

Le serveur MCP vit dans l'application Nuxt de Patriboum (repo ouvert) :

git clone <repo> && npm install && npm run dev   # http://localhost:3001/mcp

Variables utiles : NUXT_PUBLIC_BASE_URL (URL publique des viewUrls) et PATRIMOINE_SESSIONS_DIR (dossier des sessions, défaut data/sessions/). Pointez alors vos clients vers http://localhost:3001/mcp.

FAQ

Le serveur est-il gratuit ? Oui, sans inscription.

Y a-t-il une authentification ? Pas à ce jour : l'endpoint est public et rate-limité. N'envoyez pas de données sensibles ; chaque session est accessible via son identifiant (UUID non devinable) à quiconque possède le lien.

Mes données de session sont-elles privées ? Les sessions sont accessibles par leur UUID : ne partagez le viewUrl qu'avec les personnes concernées, et ne saisissez pas de données personnelles de tiers sans base légale.

Ça fonctionne en local ? Oui, voir auto-hébergement.

Quels outils l'agent reçoit-il ? 22 tools listés dans la documentation.

Avertissement

Patriboum est un outil de simulation à vocation pédagogique : il ne fournit pas de conseil en investissement personnalisé. Les projections reposent sur des hypothèses et ne constituent pas des garanties ; investir comporte un risque de perte en capital. L'output d'un agent IA doit être vérifié par un professionnel avant toute décision. Voir les mentions légales.