Démarrage — brancher Aeliam sur votre assistant IA¶

Pour qui : courtiers et collaborateurs de cabinet (aucune compétence technique requise).

Objectif : connecter votre assistant Claude (Desktop, Code ou web) à votre compte Aeliam, pour piloter votre CRM et lancer des tarifications en langage naturel.

L'authentification se fait par OAuth : vous vous connectez avec votre compte cabinet, il n'y a aucune clé à copier.

Point de connexion (DEV)

Serveur MCP : https://mcp-dev.aeliam.ai/mcp (en production, ce sera https://mcp.aeliam.ai/mcp — voir Environnements).

Prérequis¶

Un compte Aeliam rattaché à un cabinet (le même que celui de la console dev.aeliam.ai).
Un client IA compatible MCP : Claude Code, Claude Desktop, ou Cursor.

Option A — Claude Code (le plus simple)¶

Dans Claude Code, vous pouvez tout faire en une commande. Collez ce message à l'assistant :

« Installe le MCP Aeliam dev. Exécute : claude mcp add --transport http aeliam-dev https://mcp-dev.aeliam.ai/mcp -s user puis dis-moi comment m'authentifier. »

Ce qui se passe :

La commande ajoute le serveur aeliam-dev (scope user = disponible dans tous vos projets).
Relancez Claude Code, ou tapez /mcp → aeliam-dev → Authenticate.
Un navigateur s'ouvre sur dev.aeliam.ai → connectez-vous avec votre compte cabinet → un écran de consentement liste les autorisations demandées → Autoriser.
Le message « Authentication successful » s'affiche (page de Claude Code, c'est normal) → les outils aeliam-dev sont prêts.

Portée de l'installation

-s user (recommandé) : pour vous, partout. · -s local : ce projet seulement. · -s project : partagé via le .mcp.json du dépôt. Pour retirer : claude mcp remove aeliam-dev.

Option B — Claude Desktop / claude.ai (interface graphique)¶

Les connecteurs HTTP s'ajoutent depuis l'interface (un assistant ne peut pas modifier sa propre configuration — barrière de sécurité). C'est rapide :

Réglages ⚙️ → Connecteurs → Ajouter un connecteur personnalisé
Nom : Aeliam (dev)
URL : https://mcp-dev.aeliam.ai/mcp
Ajouter → l'OAuth s'ouvre → connexion sur dev.aeliam.ai → Autoriser → rechargez Claude.

Vérifier que ça marche¶

Collez ceci dans un nouveau chat (après connexion) :

Tu as accès au MCP "aeliam-dev". Teste-le et montre-moi les résultats bruts :
1. whoami → à quel cabinet et quels droits suis-je rattaché ?
2. list_opportunities (mes 5 dernières).
3. get_produit_schema (code=mrp, compagnie=axa) → résume les champs requis.
4. enqueue_tarification en DRY-RUN (dry_run=true) avec des données fictives → montre le statut.
Ne déclenche AUCUNE tarification réelle (dry_run=false) sans mon accord explicite.

Si whoami renvoie votre cabinet et vos scopes, la connexion est opérationnelle. 🎉

Bon à savoir¶

Ouvrir l'URL du serveur dans un navigateur affiche Method Not Allowed, use POST : c'est normal. Le point /mcp n'accepte que des requêtes POST ; ce message prouve juste que le serveur tourne. On ne l'ouvre jamais à la main, on le branche comme connecteur.
Droits granulaires : l'écran de consentement indique précisément ce que l'assistant pourra faire (lecture seule, ou écriture, ou tarification). Vous gardez la main.
Tarification réelle : l'outil enqueue_tarification lance un robot sur le vrai portail assureur. Il demande une confirmation explicite et propose un mode dry_run sans effet. Voir Sécurité & confidentialité.

Étape suivante : Utilisation au quotidien.