Klavis MCP — Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

MCP hébergés pour Slack, Salesforce, Notion, Jira, Gmail, Drive, Calendar, HubSpot, Asana, etc.
OAuth 2.0 géré de bout en bout — aucun jonglage de tokens par utilisateur
Point d'accès MCP unique quel que soit le nombre d'apps activées
Journal d'audit de chaque appel d'outil par tenant
Option auto-hébergement via Docker pour les environnements soumis à des exigences de conformité

Démo en direct

Aperçu en pratique

klavis.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "klavis",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "klavis": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add klavis -- npx -y mcp-remote https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Klavis

Déployer un agent qui touche 5 outils SaaS sans 5 flux d'auth

👤 Builders de produits intégrant Claude dans leur application ⏱ ~45 min intermediate

Quand l'utiliser : Vos utilisateurs veulent que Claude lise Gmail, mette à jour HubSpot, commente sur Jira — et vous ne voulez pas écrire le code OAuth pour chacun.

Prérequis

Compte Klavis + clé API — Créez un compte sur klavis.ai et récupérez la clé depuis le tableau de bord
Serveurs sélectionnés activés — Activez Gmail, HubSpot, Jira dans l'interface Klavis

Déroulement

Connecter la passerelle

Ajoute Klavis comme serveur MCP avec mon token. Liste les outils maintenant disponibles.✓ Copié

→ La liste d'outils mentionne les points d'accès Gmail, HubSpot, Jira
Connexion utilisateur final

Génère l'URL de connexion Gmail pour user_id=xyz. Quand il revient, confirme que l'auth a réussi.✓ Copié

→ URL OAuth retournée ; post-callback affiche connected:true
Action inter-apps

Pour le dernier Gmail d'acme.com, crée un contact HubSpot et un ticket Jira résumant le fil.✓ Copié

→ Les trois API touchées dans un seul flux avec trace d'audit

Résultat : Un agent multi-SaaS fonctionnel avec auth par utilisateur et une seule URL de config.

Pièges

Les tokens utilisateur expirent silencieusement — Abonnez-vous au webhook auth_expired et invitez l'utilisateur à se reconnecter

Combiner avec : gmail · slack

Bot ops interne — créer des tickets, mettre à jour le CRM, poster sur Slack depuis un seul chat

👤 Équipes d'outils internes ⏱ ~30 min intermediate

Quand l'utiliser : Vous voulez un seul chat Claude capable de « gérer la paperasse » sur tout votre stack SaaS.

Prérequis

Authentifier toutes les apps une seule fois en admin — Connectez chaque app depuis le compte d'équipe, pas par utilisateur

Déroulement

Connecter le stack

Ajoute Klavis. Confirme que Salesforce, Jira, Slack sont tous connectés.✓ Copié

→ Les trois affichent le statut connecté
Traiter une plainte client

Pour la plainte client dans le dernier message Slack #support : crée un dossier Salesforce, un bug Jira, et réponds dans le fil avec les liens de tickets.✓ Copié

→ Dossier + bug créés ; la réponse Slack les lie

Résultat : Action multi-outils accomplie en un seul chat avec reçus dans chaque système.

Pièges

Limites de débit sur Slack — Le tableau de bord Klavis affiche le quota par app ; regroupez les opérations quand c'est possible

Combiner avec : slack · linear

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

klavis + gmail

MCP Gmail local pour usage personnel, Klavis pour les données multi-utilisateurs

Utilise mon MCP Gmail local pour moi, Klavis pour les données clients.✓ Copié

klavis + slack

Poster des mises à jour de statut depuis des flux ops

Après avoir créé le dossier Salesforce, poste un résumé dans #customers via Klavis.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
list_connected_apps	user_id?: str	Vérifier quelles apps un utilisateur donné a connectées	free
get_auth_url	app: str, user_id: str	Lancer le flux OAuth pour un utilisateur	free
proxy_tool_call	app, tool, args, user_id	Tout appel d'outil en aval — Klavis le route	varies by app

Coût et limites

Coût d'exécution

Quota d'API: Offre gratuite : 1k appels/mois. Pro : 100k/mois.
Tokens par appel: 100–2 000 selon l'app
Monétaire: Freemium + facturation à l'usage
Astuce: Auditez quelles apps génèrent l'essentiel des appels et définissez des quotas par app dans le tableau de bord

Sécurité

Permissions, secrets, portée

Portées minimales : read (per app) write-scoped (per app)

Stockage des identifiants : Klavis détient les tokens OAuth ; chiffrés au repos

Sortie de données : api.klavis.ai + chaque SaaS en aval

Ne jamais accorder : admin scopes unless truly needed

Utilisez le build Docker auto-hébergé pour les périmètres SOC2 — le plan hébergé voit tout le trafic

Dépannage

Erreurs courantes et correctifs

401 de proxy_tool_call

L'OAuth de l'utilisateur a expiré — rappelez get_auth_url et faites-le se reconnecter

Vérifier : Call list_connected_apps, check status==connected

Serveur « notion » absent de la passerelle

Activez-le d'abord dans le tableau de bord Klavis, puis redémarrez le client MCP pour prendre en compte les nouveaux outils

Limite de débit sur une seule app

Klavis retourne 429 avec retry_after ; attendez ou regroupez les requêtes

Alternatives

Klavis vs autres

Alternative	Quand l'utiliser	Compromis
Composio MCP	Vous voulez une plateforme d'intégration hébergée similaire avec une tarification différente	Couverture d'apps différente ; modèle d'auth similaire
Self-hosted individual MCPs	Utilisateur unique, peu d'apps, sensibilité à la conformité	Vous devez gérer vous-même le code OAuth pour chaque app

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills