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.com 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.

Vous changez de système de réservation ? Les rendez-vous existants ne peuvent pas être repris par l’import CSV classique, qui ne traite que les utilisateurs, mais un assistant IA peut s’en charger. Exportez les rendez-vous de votre ancien système, transmettez le fichier à votre assistant et demandez-lui de créer les réservations dans l’agenda SuperSaaS correspondant. Commencez par un petit lot et vérifiez le résultat avant de lui laisser importer le reste.

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 (version web)

Pour connecter ChatGPT, il suffit de saisir l’URL du serveur et d’approuver la connexion dans SuperSaaS. Vous ajoutez la connexion comme plugin personnel. La disponibilité du mode développeur dépend de votre compte et de la politique de votre espace de travail. Les étapes ci-dessous utilisent les noms anglais des boutons et des menus.

  1. Rendez-vous sur https://chatgpt.com pour vous connecter.
  2. Ouvrez Settings > Security and login et activez le Developer mode.
  3. Ouvrez Plugins et choisissez Create app. Dans le formulaire New Plugin, nommez-le “SuperSaaS” et saisissez “https://www.supersaas.fr/mcp” dans le champ MCP Server URL. La description est facultative.
  4. Laissez Authentication sur OAuth, lisez l’avertissement, cochez I understand and want to continue et cliquez sur Create. Lorsque vous lancez la connexion, une page SuperSaaS s’ouvre dans votre navigateur. Connectez-vous, puis cliquez sur Approuver pour revenir à ChatGPT.
  5. Retrouvez SuperSaaS dans vos plugins personnels, ouvrez-le et cliquez sur le bouton plus pour l’installer.
  6. Revenez à la page d’accueil de ChatGPT, passez de Chat à Work et démarrez une nouvelle discussion. Tapez @ dans la zone de message et sélectionnez SuperSaaS pour utiliser ses outils.

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 Customize > Connectors (l’icône de boîte à outils en bas de la barre latérale), cliquez sur le bouton + et choisissez 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. Activez le connecteur pour une conversation en cliquant sur le bouton + dans la zone de discussion (ou en tapant /), en survolant Connectors et en activant SuperSaaS. Les outils SuperSaaS sont alors disponibles dans cette discussion.

Avec un abonnement Team ou Enterprise, le connecteur est ajouté par le propriétaire de l’espace de travail sous Organization settings > Connectors ; les autres membres n’ont qu’à cliquer sur Connect et à se connecter à SuperSaaS. Un compte Claude gratuit ne peut contenir qu’un seul connecteur personnalisé, les abonnements payants en autorisent plusieurs. Une fois le connecteur ajouté dans la version web ou l’application de bureau, il fonctionne aussi dans les applications Claude pour iOS et Android.

Configuration manuelle avec une valeur Authorization

Si votre client ne prend pas en charge OAuth, ou si vous préférez une configuration manuelle, utilisez l’URL du serveur et 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, application de bureau et IDE)

Claude Code prend aussi en charge OAuth, aucune valeur Authorization n’est donc nécessaire. Ajoutez le serveur avec cette commande :

claude mcp add --transport http supersaas https://www.supersaas.fr/mcp

Tapez ensuite /mcp dans Claude Code, sélectionnez SuperSaaS et suivez les étapes dans votre navigateur pour vous connecter et approuver l’accès. Claude Code enregistre le jeton et le renouvelle automatiquement. La même commande fonctionne dans le terminal, dans l’application de bureau Claude Code et dans les extensions pour Visual Studio Code et JetBrains.

Pour utiliser à la place la valeur Authorization de la section sur la configuration manuelle ci-dessus, transmettez-la comme en-tête :

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

Application de bureau ChatGPT et Codex

L’application de bureau ChatGPT permet de configurer MCP directement, y compris la connexion via OAuth. Codex est le nom de l’environnement de programmation et du client pour le terminal. Pour vous connecter via l’application de bureau, avec les noms anglais des boutons et des menus :

  1. Passez à Codex dans l’application de bureau ChatGPT, puis ouvrez Settings.
  2. Accédez à Plugins, ouvrez le menu Add et choisissez Add MCP server. Si votre version dispose d’une section MCP servers distincte dans les réglages, ouvrez cette section et cliquez sur Add server.
  3. Nommez le serveur SuperSaaS, choisissez Streamable HTTP et saisissez https://www.supersaas.fr/mcp.
  4. Enregistrez le serveur et choisissez Restart.
  5. Ouvrez l’onglet MCPs sous Settings > Plugins et choisissez Authenticate pour SuperSaaS. Connectez-vous à SuperSaaS dans votre navigateur et cliquez sur Approuver.
  6. Démarrez une nouvelle discussion Codex locale et utilisez /mcp pour vérifier que le serveur SuperSaaS est connecté.

L’application de bureau, le client Codex pour le terminal et l’extension pour IDE partagent la configuration MCP sur le même ordinateur. Comme alternative à OAuth, vous pouvez utiliser la valeur Authorization de la section sur la configuration manuelle ci-dessus. 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"
      }
    }
  }
}