De l’installation à votre première IA branchée.

Choisissez une façon de faire tourner Calame :

Il vous faut aussi :

• Une base de données à exposer (PostgreSQL, MySQL ou SQLite). Pour les tests, Calame fournit un générateur SQLite de démo ; voir l’étape 04.
• Facultatif : une clé d’API LLM si vous voulez le chat intégré (Anthropic, OpenRouter, ou une installation Ollama locale).

Option A · Application desktop (Windows)

Téléchargez l’installeur et lancez-le : aucun droit administrateur requis, Calame s’ouvre sur http://localhost:4567 et continue de tourner depuis la barre système quand vous fermez la fenêtre. Les mises à jour s’installent silencieusement au démarrage.

Option B · Docker (serveurs, équipes)

$ git clone https://github.com/Calame-Tech/calame.git
$ cd calame
$ docker compose up

Attendez :

calame-1 | Calame is running on http://localhost:4567/

Option C · Node.js (dev)

$ git clone https://github.com/Calame-Tech/calame.git
$ cd calame
$ pnpm install
$ pnpm dev

Même cible : http://localhost:4567.

Ouvrez http://localhost:4567. Au premier lancement, vous arrivez sur la page Setup :

1. Choisissez un email et un mot de passe admin (12 caractères ou plus recommandés).
2. Validez. Vous êtes maintenant connecté en tant qu’admin de l’espace de travail.

Dans le panneau Sources, cliquez sur Nouvelle source. Trois moteurs SQL sont pris en charge dans le cœur :

• PostgreSQL
  port 5432
• MySQL
  port 3306
• SQLite
  chemin de fichier

Tester SQLite, sans configuration

Envie d’essayer sans toucher à de vraies données ? Utilisez le générateur fourni :

$ node scripts/generate-demo-db.js

Ceci crée demo-logistique-v2.db à la racine du dépôt, un jeu de données logistique fictif (~5 Mo, ~30 tables, fausses données personnelles). Utilisez ./demo-logistique-v2.db dans le formulaire de connexion SQLite.

Un profil est une vue publiée de votre base de données, avec sa propre authentification, son masquage et ses permissions. Une seule base, plusieurs profils.

1. 5.1 · Tables et colonnes

   Choisissez les tables à exposer. Pour chaque table, choisissez les colonnes visibles. Décochez tout ce que vous ne voulez pas que le LLM voie.

2. 5.2 · Masquage des données personnelles

   Calame détecte automatiquement les données personnelles probables (email, téléphone, adresse, carte, numéro de sécurité sociale…). Règles par colonne ou globales : caviardage complet, hachage, masquage partiel ou regex personnalisée.

3. 5.3 · Restriction au niveau des lignes (facultatif)

   Restreignez le profil aux lignes correspondant à une condition, par ex. client_email = "<email de l’utilisateur authentifié>". Utilisé pour l’isolation des données par utilisateur.

4. 5.4 · Mode d’authentification

   Choisissez-en un : ouvert · jeton Bearer · mot de passe · SSO OIDC · OAuth 2.1 avec enregistrement dynamique de client · URL de validation externe.

Pas besoin d’un client externe pour valider le profil.

1. Paramètres → Fournisseur IA → choisissez votre fournisseur (Anthropic, OpenRouter, ou un point de terminaison compatible OpenAI comme un Ollama local).
2. Choisissez un modèle (par ex. claude-sonnet-4-5, llama3.1:8b).
3. Ouvrez Chat → choisissez le profil → demandez : « Combien de tables dans cette base ? Montre un exemple de ligne pour chacune. »

Pour les clients IA externes avec authentification par jeton Bearer :

1. Panneau Utilisateurs → Nouvel utilisateur
2. Email, nom, profils attribués
3. Générer un jeton. Calame ne l’affiche qu’une fois. Copiez-le maintenant.

Pour les modes OAuth / SSO, aucun jeton n’est nécessaire ; le client gère le flux.

L’URL du point de terminaison MCP est toujours http://localhost:4567/mcp/<profile-name>.

Claude Desktop · en un clic

Ouvrez la page de votre serveur MCP et cliquez sur Connecter à Claude Desktop. Calame génère un jeton dédié révocable, fusionne l’entrée dans claude_desktop_config.json (une sauvegarde .bak horodatée est conservée), et le profil apparaît dans les outils de Claude après un redémarrage. Rien d’autre à installer sur la machine.

Cursor · VS Code · clients OAuth

Pour les profils en mode OAuth 2.1, il suffit de coller l’URL du point de terminaison dans les paramètres MCP du client : Calame prend en charge l’enregistrement dynamique de client, donc le client s’enregistre lui-même et invite l’utilisateur dans le navigateur. Aucun jeton à copier.

Copilot · ChatGPT · assistants cloud

Microsoft et OpenAI n’atteignent les serveurs MCP que via HTTPS public. Sur la page du serveur, cliquez sur Exposer pour Copilot / ChatGPT : un tunnel Cloudflare intégré donne à votre Calame local une URL publique protégée par jeton (aucun compte requis), avec des guides pas à pas pour Copilot Studio et les connecteurs ChatGPT. L’URL change à chaque session et meurt avec le tunnel.

Solution manuelle (tout client MCP)

Modifiez claude_desktop_config.json (Mac : ~/Library/Application Support/Claude/, Windows : %APPDATA%\Claude\), ou l’équivalent chez votre client :

{
  "mcpServers": {
    "calame": {
      "transport": {
        "type": "http",
        "url": "http://localhost:4567/mcp/sales",
        "headers": {
          "Authorization": "Bearer <your-token>"
        }
      }
    }
  }
}

Pour les profils OAuth, supprimez le bloc headers ; le client invite l’utilisateur via le navigateur.

Vérification avec curl

$ curl -X POST http://localhost:4567/mcp/sales \
    -H "Authorization: Bearer <your-token>" \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Vous devriez obtenir une réponse JSON listant les outils générés automatiquement pour votre profil (un par table + un outil de requête).

• Déployer en production : des modèles Caddy / nginx sont disponibles dans docs/Caddyfile et docs/nginx.conf.
• Journal d’audit : chaque requête, qui, quand, avec quelle portée. Filtrez et exportez depuis le panneau Audit.
• Utilisateurs multiples + SSO : Paramètres → Authentification unique ; connectez Calame à Google, Okta, Keycloak, Azure AD. (Pro ou Enterprise)
• Secrets dans Vault : Calame peut récupérer les identifiants de base de données depuis HashiCorp Vault au lieu de les stocker localement.