Assistance
Documentation

Connecter un assistant IA à SuperSaaS

SuperSaaS fournit un serveur MCP (Model Context Protocol) qui permet à des assistants IA comme Claude ou ChatGPT de gérer votre agenda en langage naturel : vérifier les disponibilités, créer et déplacer des réservations, rechercher des utilisateurs, et plus encore. L’assistant dispose des mêmes autorisations que votre compte. Les informations de connexion doivent donc être considérées comme aussi sensibles qu’un mot de passe.

Ce que vous pourrez faire

Après la configuration, vous pouvez poser des questions et formuler des demandes à votre assistant IA, par exemple :

  • “Quels rendez-vous ai-je demain ?”
  • “Trouve un créneau libre pour une consultation de 30 minutes la semaine prochaine et réserve-le pour jane@example.com”
  • “Quelles réservations ont changé depuis hier ?”
  • “Crée un nouvel utilisateur avec le nom jim@example et le mot de passe ‘secret’ et accorde-lui 20 € de crédit”
La plupart des assistants demandent une confirmation avant d’effectuer une modification importante. N’oubliez toutefois pas qu’une fois connecté, l’assistant peut agir avec les mêmes autorisations que votre compte.

Choisissez votre client

La plupart des utilisateurs peuvent se connecter via OAuth. Il leur suffit de saisir l’URL du serveur, de se connecter à SuperSaaS dans leur navigateur, puis d’approuver la demande d’accès.

Pour les clients avec OAuth, utilisez cette URL du serveur : https://www.supersaas.fr/mcp

ChatGPT

Pour connecter ChatGPT, il suffit de saisir l’URL du serveur et d’approuver la connexion dans SuperSaaS. ChatGPT nécessite un abonnement payant (Plus, Pro ou Business) pour les connecteurs personnalisés.

  1. Rendez-vous sur https://chatgpt.com pour vous connecter. Utilisez la version web ; l’application mobile et l’application de bureau de ChatGPT n’ont pas encore d’option MCP, mais une fois connecté, vous pouvez utiliser les outils depuis l’application.
  2. Ouvrez Settings > Apps, faites défiler jusqu’à Advanced settings et activez le Developer mode.
  3. De retour dans Apps, choisissez Create app, nommez-la “SuperSaaS” et, dans le champ “Connexion”, saisissez “https://www.supersaas.fr/mcp”.
  4. Sous Authentication, assurez-vous que OAuth est sélectionné, cochez la case de confirmation et terminez la création du connecteur. Lorsque vous lancez la connexion, une page SuperSaaS s’ouvre dans votre navigateur. Connectez-vous, puis cliquez sur “Approuver” pour revenir à ChatGPT avec les outils disponibles.

Claude (application de bureau et application web)

Claude se connecte à SuperSaaS à l’aide d’un connecteur personnalisé. Vous n’avez besoin que de l’URL du serveur ; vous vous connectez à SuperSaaS dans votre navigateur et vous approuvez la connexion.

  1. Dans Claude, ouvrez Settings > Connectors et cliquez sur Add custom connector.
  2. Saisissez un nom tel que “SuperSaaS” et collez votre URL du serveur (https://www.supersaas.fr/mcp), puis cliquez sur Add.
  3. Cliquez sur Connect. Une page SuperSaaS s’ouvre dans votre navigateur ; connectez-vous avec votre nom de compte et votre mot de passe (si vous n’êtes pas déjà connecté) et cliquez sur Approuver.
  4. Vous êtes redirigé vers Claude, qui répertorie désormais les outils SuperSaaS sous l’icône des outils dans la zone de discussion.

Configuration manuelle pour les clients sans OAuth

Certains clients ne prennent pas encore en charge la connexion via le navigateur. Ces clients ont besoin de l’URL du serveur et d’une valeur Authorization commençant par Bearer …. Vous pouvez obtenir cette valeur en cliquant sur Connecter un assistant IA, ce qui ouvrira votre page avec une section supplémentaire. Cliquez sur Afficher pour voir le code Authorization.

Si vous cliquez ultérieurement sur Régénérer la clé, la valeur Authorization est modifiée. Tous les assistants qui l’utilisent cesseront de fonctionner tant que vous ne les aurez pas mis à jour avec cette nouvelle valeur.

Claude Code (terminal)

Exécutez cette seule commande en remplaçant l’espace réservé par votre valeur Authorization :

claude mcp add supersaas --transport http https://www.supersaas.fr/mcp \
  --header "Authorization: Bearer COLLEZ_VOTRE_VALEUR_ICI"

Codex

Le moyen le plus simple consiste à utiliser l’application Codex :

  1. Ouvrez Settings dans Codex.
  2. Accédez à MCP servers et cliquez sur Add.
  3. Choisissez un serveur distant/HTTP et saisissez votre URL du serveur.
  4. Ajoutez un en-tête HTTP nommé Authorization avec votre valeur Authorization (y compris le mot Bearer).
  5. Enregistrez le serveur et démarrez une nouvelle discussion Codex. Les outils SuperSaaS devraient être disponibles dans cette discussion.

Si vous préférez le terminal ou souhaitez configurer Codex manuellement, modifiez ~/.codex/config.toml (créez-le s’il n’existe pas) et ajoutez :

[mcp_servers.supersaas]
url = "https://www.supersaas.fr/mcp"
http_headers = { "Authorization" = "Bearer COLLEZ_VOTRE_VALEUR_ICI" }

Redémarrez ensuite Codex ; les outils SuperSaaS apparaissent automatiquement. Dans le terminal, vous pouvez vérifier la connexion avec codex mcp list, et dans Codex, vous pouvez utiliser /mcp pour inspecter les serveurs connectés.

Visual Studio Code (GitHub Copilot)

Dans VS Code, les serveurs MCP sont utilisés par le chat GitHub Copilot en mode Agent, un abonnement Copilot est donc requis (la version gratuite fonctionne).

  1. Ouvrez la palette de commandes (Ctrl/Cmd + Shift + P) et exécutez MCP : Add Server.
  2. Choisissez HTTP et saisissez votre URL du serveur.
  3. Lorsque le fichier mcp.json s’ouvre, ajoutez l’entrée headers afin que la définition du serveur ressemble à ceci :
{
  "servers": {
    "supersaas": {
      "type": "http",
      "url": "https://www.supersaas.fr/mcp",
      "headers": {
        "Authorization": "Bearer COLLEZ_VOTRE_VALEUR_ICI"
      }
    }
  }
}
  1. Ouvrez le panneau de chat Copilot, sélectionnez le mode Agent, puis cliquez sur l’icône des outils pour vérifier que les outils SuperSaaS sont bien disponibles.

Autres clients MCP (Cursor, Le Chat et plus)

Tout client prenant en charge les serveurs MCP distants avec des en-têtes personnalisés fonctionnera. Lorsque le client vous demande les informations du serveur, utilisez :

  • Type / transport : Streamable HTTP
  • URL : votre URL du serveur, par exemple https://www.supersaas.fr/mcp
  • En-tête : Authorization défini sur votre valeur Authorization (y compris le mot Bearer)
Pour les clients configurés avec un fichier JSON (comme le mcp.json de Cursor), l’équivalent est :
{
  "mcpServers": {
    "supersaas": {
      "url": "https://www.supersaas.fr/mcp",
      "headers": {
        "Authorization": "Bearer COLLEZ_VOTRE_VALEUR_ICI"
      }
    }
  }
}