Connecter un assistant IA à TESSA (MCP)

TESSA expose ses outils de calcul via le Model Context Protocol (MCP). Cela vous permet de piloter TESSA depuis un assistant IA tel que Claude, ChatGPT ou Mistral — en demandant en langage naturel de créer des quartiers, de générer des tracés de réseau, de dimensionner des conduites, de lancer des simulations, et bien plus. L'assistant appelle les mêmes outils que l'application web TESSA, les exécute sur votre propre compte et vos propres projets, et rapporte les résultats dans la conversation.

Cette page explique comment connecter un assistant IA courant à TESSA. Vous n'avez pas besoin d'installer quoi que ce soit ni d'écrire de code — la connexion se configure via l'interface de votre assistant.

Ce qu'il vous faut avant de commencer

• Un compte TESSA ayant accès aux projets sur lesquels vous souhaitez travailler. L'assistant agit en votre nom : il ne peut voir et modifier que les projets que votre compte peut déjà voir et modifier.
• Un assistant IA prenant en charge les connecteurs MCP distants (parfois appelés « connecteurs personnalisés », « intégrations » ou « serveurs MCP distants »). La prise en charge et les noms exacts des menus varient selon le produit et l'abonnement — voir les notes par outil ci-dessous.
• L'URL du point de terminaison MCP de TESSA pour votre instance. Il s'agit de votre adresse web TESSA avec /mcp ajouté à la fin :

  https://<your-tessa-domain>/mcp
  

  
  Par exemple, si vous utilisez habituellement TESSA à l'adresse https://app.example-tessa.ch, le point de terminaison MCP est https://app.example-tessa.ch/mcp.
  Si vous n'êtes pas sûr de votre domaine TESSA, demandez à votre administrateur ou au support client Planeto.

Comment fonctionne la connexion

Lors de votre première connexion, votre assistant ouvre une page de connexion TESSA dans votre navigateur. Vous vous connectez avec vos identifiants TESSA habituels (la même connexion Auth0 que celle utilisée pour l'application web), et l'assistant reçoit un jeton sécurisé pour agir en votre nom.

• Vous vous connectez une seule fois par connexion ; l'assistant renouvelle son accès automatiquement par la suite.
• L'assistant ne voit jamais votre mot de passe — il ne reçoit qu'un jeton émis après votre connexion.
• Chaque appel d'outil est effectué en votre nom, de sorte que toutes vos permissions de projet et l'isolation de vos données restent appliquées.

Connecter Claude

Claude (claude.ai et l'application de bureau Claude) prend en charge les serveurs MCP distants via des connecteurs personnalisés.

1. Dans une conversation Claude, cliquez sur le bouton « + » (ou recherche et outils) près de la zone de message.
2. Choisissez Gérer les connecteurs → Ajouter un connecteur personnalisé (la formulation exacte varie selon la version).
3. Donnez-lui un nom, p. ex. TESSA.
4. Collez l'URL de votre point de terminaison MCP : https://<your-tessa-domain>/mcp
5. Enregistrez. Claude ouvrira une fenêtre de navigateur vous demandant de vous connecter à TESSA. Effectuez la connexion.
6. De retour dans Claude, activez le connecteur TESSA pour votre conversation. Vous pouvez désormais demander à Claude d'utiliser les outils TESSA.

{
  "mcpServers": {
    "tessa": {
      "url": "https://<your-tessa-domain>/mcp"
    }
  }
}

Connecter ChatGPT

ChatGPT prend en charge les serveurs MCP distants via des connecteurs (la disponibilité dépend de votre abonnement ; les connecteurs MCP personnalisés/distants sont généralement disponibles sur les formules Plus, Pro, Team et Enterprise, ainsi qu'en mode développeur).

1. Ouvrez Paramètres → Connecteurs (ou Paramètres → Connexions).
2. Choisissez Ajouter un connecteur / Créer et sélectionnez un serveur MCP personnalisé / distant.
3. Saisissez un nom (TESSA) et l'URL du serveur : https://<your-tessa-domain>/mcp
4. Choisissez OAuth comme méthode d'authentification si cela vous est demandé. Enregistrez.
5. ChatGPT ouvre une fenêtre de navigateur pour vous connecter à TESSA. Effectuez la connexion.
6. Dans une conversation, activez le connecteur TESSA (via le menu des outils / connecteurs) et demandez à ChatGPT d'utiliser TESSA.

Connecter Mistral (Le Chat)

Le Chat de Mistral prend en charge les connecteurs MCP.

1. Dans Le Chat, ouvrez Paramètres → Connecteurs (ou la zone des connecteurs / outils).
2. Choisissez d'ajouter un connecteur MCP personnalisé ou distant.
3. Saisissez un nom (TESSA) et l'URL du serveur : https://<your-tessa-domain>/mcp
4. Enregistrez et effectuez la connexion à TESSA dans la fenêtre de navigateur qui s'ouvre.
5. Activez le connecteur dans votre conversation.

Autres outils compatibles MCP

Tout client prenant en charge les serveurs MCP distants authentifiés par OAuth peut se connecter en utilisant la même URL de point de terminaison (https://<your-tessa-domain>/mcp). La connexion suit toujours le même schéma :

1. Ajoutez un serveur MCP distant/personnalisé pointant vers https://<your-tessa-domain>/mcp.
2. Utilisez l'authentification OAuth.
3. Connectez-vous à TESSA dans le navigateur lorsque cela vous est demandé.

Ce que vous pouvez faire une fois connecté

Une fois connecté, votre assistant peut appeler les outils de TESSA en votre nom. Les demandes typiques incluent :

• « Crée un quartier dans TESSA à partir des bâtiments de cette région. »
• « Génère un tracé de réseau en arbre couvrant minimal pour mon quartier. »
• « Dimensionne les conduites et lance une simulation thermique. »
• « Dimensionne les sources de chaleur du centre énergétique. »

L'assistant choisit l'outil pertinent, l'exécute et attend le résultat (la plupart des outils s'exécutent en tâche de fond et peuvent prendre jusqu'à quelques minutes). Les résultats apparaissent à la fois dans votre conversation et dans l'application web TESSA, où vous pouvez les inspecter comme d'habitude.

Dépannage

Si vous continuez à rencontrer des problèmes de connexion, contactez le support client Planeto.

Sécurité et confidentialité

• L'assistant s'authentifie en tant que vous via la connexion standard de TESSA. Il ne peut accéder à rien de ce à quoi votre compte n'a pas accès.
• Aucun mot de passe n'est partagé avec l'assistant — seulement un jeton émis après votre connexion.
• Les conversations et les demandes d'outils sont traitées par votre fournisseur d'IA choisi (Anthropic, OpenAI, Mistral, etc.) selon leurs conditions. Évitez de coller des données sensibles que vous ne voudriez pas envoyer à ce fournisseur.