# Installer le serveur MCP Patriboum {#doc-installation}

> 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 {#prerequis}

- 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 {#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 ») :

```json
{
  "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-code}

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

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

## Cursor {#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`) :

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

## ZCode {#zcode}

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

En ligne de commande :

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

## Windsurf {#windsurf}

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

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

Puis « Refresh » dans le panneau MCP.

## VS Code (GitHub Copilot) {#vscode}

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

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

## Gemini CLI {#gemini-cli}

Dans `~/.gemini/settings.json` :

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

## Autres clients {#autres}

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 {#premiere-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 {#selfhost}

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

```bash
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 {#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](#selfhost).

**Quels outils l'agent reçoit-il ?** 22 tools listés dans la
[documentation](/docs).

## Avertissement {#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](/mentions-legales).