Einen KI-Assistenten mit TESSA verbinden (MCP)

TESSA stellt seine Rechenwerkzeuge über das Model Context Protocol (MCP) bereit. Dadurch können Sie TESSA über einen KI-Assistenten wie Claude, ChatGPT oder Mistral steuern — indem Sie in natürlicher Sprache darum bitten, Quartiere zu erstellen, Netzverläufe zu erzeugen, Leitungen zu dimensionieren, Simulationen auszuführen und mehr. Der Assistent ruft dieselben Werkzeuge auf, die auch die TESSA-Web-App verwendet, führt sie gegen Ihr eigenes Konto und Ihre Projekte aus und meldet die Ergebnisse im Gespräch zurück.

Diese Seite erklärt, wie Sie einen gängigen KI-Assistenten mit TESSA verbinden. Sie müssen nichts installieren und keinen Code schreiben — die Verbindung wird über die Oberfläche Ihres Assistenten eingerichtet.

Was Sie brauchen, bevor Sie beginnen

• Ein TESSA-Konto mit Zugriff auf die Projekte, an denen Sie arbeiten möchten. Der Assistent handelt als Sie: Er kann nur die Projekte sehen und ändern, die Ihr Konto bereits sehen und ändern kann.
• Einen KI-Assistenten, der entfernte MCP-Konnektoren unterstützt (manchmal „custom connectors", „integrations" oder „remote MCP servers" genannt). Die Unterstützung und die genauen Menünamen variieren je nach Produkt und Tarif — siehe die produktspezifischen Hinweise weiter unten.
• Die TESSA-MCP-Endpunkt-URL für Ihre Instanz. Das ist Ihre TESSA-Webadresse mit angehängtem /mcp:

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

  
  Wenn Sie TESSA beispielsweise normalerweise unter https://app.example-tessa.ch verwenden, lautet der MCP-Endpunkt https://app.example-tessa.ch/mcp.
  Wenn Sie sich Ihrer TESSA-Domain nicht sicher sind, fragen Sie Ihren Administrator oder den Planeto-Kundensupport.

Wie die Anmeldung funktioniert

Wenn Sie sich zum ersten Mal verbinden, öffnet Ihr Assistent eine TESSA-Anmeldeseite in Ihrem Browser. Sie melden sich mit Ihren normalen TESSA-Anmeldedaten an (dieselbe Auth0-Anmeldung, die Sie für die Web-App verwenden), und der Assistent erhält ein sicheres Token, um in Ihrem Namen zu handeln.

• Sie melden sich pro Verbindung einmal an; der Assistent erneuert seinen Zugriff danach automatisch.
• Der Assistent sieht niemals Ihr Passwort — er erhält nur ein Token, das nach Ihrer Anmeldung ausgestellt wird.
• Jeder Werkzeugaufruf wird als Sie ausgeführt, sodass alle Ihre Projektberechtigungen und die Datenisolierung weiterhin gelten.

Claude verbinden

Claude (claude.ai und die Claude-Desktop-App) unterstützt entfernte MCP-Server über custom connectors.

1. Klicken Sie in einer Claude-Unterhaltung auf die Schaltfläche „+" (oder search & tools) in der Nähe des Nachrichtenfelds.
2. Wählen Sie Manage connectors → Add custom connector (die genaue Formulierung variiert je nach Version).
3. Geben Sie ihm einen Namen, z. B. TESSA.
4. Fügen Sie Ihre MCP-Endpunkt-URL ein: https://<your-tessa-domain>/mcp
5. Speichern Sie. Claude öffnet ein Browserfenster und bittet Sie, sich bei TESSA anzumelden. Schliessen Sie die Anmeldung ab.
6. Zurück in Claude aktivieren Sie den TESSA-Konnektor für Ihre Unterhaltung. Sie können Claude nun bitten, TESSA-Werkzeuge zu verwenden.

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

ChatGPT verbinden

ChatGPT unterstützt entfernte MCP-Server über connectors (die Verfügbarkeit hängt von Ihrem Tarif ab; benutzerdefinierte/entfernte MCP-Konnektoren sind in der Regel in den Stufen Plus, Pro, Team und Enterprise sowie im Entwicklermodus verfügbar).

1. Öffnen Sie Settings → Connectors (oder Settings → Connections).
2. Wählen Sie Add connector / Erstellen und wählen Sie einen custom / remote MCP server aus.
3. Geben Sie einen Namen (TESSA) und die Server-URL ein: https://<your-tessa-domain>/mcp
4. Wählen Sie OAuth als Authentifizierungsmethode, falls danach gefragt wird. Speichern Sie.
5. ChatGPT öffnet ein Browserfenster, um sich bei TESSA anzumelden. Schliessen Sie die Anmeldung ab.
6. Aktivieren Sie in einem Chat den TESSA-Konnektor (über das Werkzeug-/Konnektormenü) und bitten Sie ChatGPT, TESSA zu verwenden.

Mistral (Le Chat) verbinden

Mistrals Le Chat unterstützt MCP-Konnektoren.

1. Öffnen Sie in Le Chat Settings → Connectors (oder den Konnektoren-/Werkzeugbereich).
2. Wählen Sie das Hinzufügen eines custom- oder remote MCP-Konnektors.
3. Geben Sie einen Namen (TESSA) und die Server-URL ein: https://<your-tessa-domain>/mcp
4. Speichern Sie und schliessen Sie die TESSA-Anmeldung im sich öffnenden Browserfenster ab.
5. Aktivieren Sie den Konnektor in Ihrer Unterhaltung.

Andere MCP-kompatible Werkzeuge

Jeder Client, der entfernte, OAuth-authentifizierte MCP-Server unterstützt, kann sich über dieselbe Endpunkt-URL (https://<your-tessa-domain>/mcp) verbinden. Die Verbindung folgt immer demselben Muster:

1. Fügen Sie einen entfernten/benutzerdefinierten MCP-Server hinzu, der auf https://<your-tessa-domain>/mcp zeigt.
2. Verwenden Sie die OAuth-Authentifizierung.
3. Melden Sie sich bei Aufforderung im Browser bei TESSA an.

Was Sie nach der Verbindung tun können

Nach der Verbindung kann Ihr Assistent die Werkzeuge von TESSA in Ihrem Namen aufrufen. Typische Anfragen sind:

• „Erstelle in TESSA ein Quartier aus den Gebäuden in dieser Region."
• „Erzeuge einen Minimum-Spanning-Tree-Netzverlauf für mein Quartier."
• „Dimensioniere die Leitungen und führe eine thermische Simulation aus."
• „Dimensioniere die Wärmequellen für die Energiezentrale."

Der Assistent wählt das passende Werkzeug, führt es aus und wartet auf das Ergebnis (die meisten Werkzeuge laufen als Hintergrundberechnungen und können bis zu einigen Minuten dauern). Die Ergebnisse erscheinen sowohl in Ihrer Unterhaltung als auch in der TESSA-Web-App, wo Sie sie wie gewohnt prüfen können.

Fehlerbehebung

Wenn Sie weiterhin Probleme beim Verbinden haben, kontaktieren Sie den Planeto-Kundensupport.

Sicherheit und Datenschutz

• Der Assistent authentifiziert sich als Sie über die Standardanmeldung von TESSA. Er kann auf nichts zugreifen, worauf Ihr Konto keinen Zugriff hat.
• Es wird kein Passwort mit dem Assistenten geteilt — nur ein Token, das nach Ihrer Anmeldung ausgestellt wird.
• Unterhaltungen und Werkzeuganfragen werden von Ihrem gewählten KI-Anbieter (Anthropic, OpenAI, Mistral usw.) gemäss dessen Bedingungen verarbeitet. Vermeiden Sie das Einfügen sensibler Daten, die Sie nicht an diesen Anbieter senden möchten.