> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german/fur-entwickler/mcp.md).

# MCP

Verbinden Sie KI-Clients über MCP mit BuildingPro Suites.

Der BuildingPro Suites MCP-Server verbindet kompatible KI-Clients mit Plattformtools. Verwenden Sie ihn, um Gebäudedaten zu prüfen oder unterstützte Einstellungen über einen KI-Client zu verwalten.

{% hint style="warning" %}
MCP ist noch nicht vollständig verfügbar. \
Derzeit ist es nur auf unserem **Demosystem** unter folgender Adresse verfügbar:

`https://demo.buildings.ability.abb/suites-demo/mcp`
{% endhint %}

{% hint style="warning" %}
Es ist möglich, **Daten zu ändern und zu löschen** (z. B. Dashboard-Konfigurationen und Sollwerte von Anlagen) über unseren MCP-Server.

Auch wenn unsere Tooldefinitionen auf den vorgesehenen Verwendungszweck und die möglichen Auswirkungen jeder Operation hinweisen, liegt es gemäß den [Best Practices](https://modelcontextprotocol.io/specification/2026-07-28/server/tools) des Model Context Protocol in der Verantwortung des Clients, sicherzustellen, dass alle über MCP vorgenommenen Änderungen korrekt und beabsichtigt sind.

**Gehen Sie vorsichtig vor** und **bestätigen Sie** die von Ihrem KI-Agenten vorgesehenen Änderungen, bevor Sie Schreibvorgänge ausführen. Ein API-Schlüssel mit Schreibzugriff verfügt im Wesentlichen über Systemadministratorrechte und damit über die vollständige Kontrolle über die Ressourcen, auf die er zugreifen kann.

Wir übernehmen keine Verantwortung für unbeabsichtigte Änderungen oder Folgen, die sich aus der Verwendung von MCP ergeben.
{% endhint %}

## Was MCP macht

Das Model Context Protocol (MCP) ermöglicht es einem KI-Client, Tools aufzurufen, die von einem anderen Dienst bereitgestellt werden. Der BuildingPro Suites MCP-Server stellt ausgewählte Tools für Ihren Mandanten bereit.

Der [Daten-Agent](https://docs.buildings.ability.abb/collection/german/copilot-assistant/agent-modes/data-agent.md) im Copilot Assistant ist darauf ausgelegt, Daten für Ihren Mandanten abzurufen und zu analysieren; Daten ändern kann er derzeit noch nicht. MCP ist eine separate Verbindung für kompatible KI-Clients, über die Sie Sprachmodelle direkt mit den Anlagen Ihres Mandanten, deren Daten und unterstützten Plattformfunktionen interagieren lassen können.

## Zugriff

Verbinden Sie Ihren MCP-Client mit `https://buildings.ability.abb/suites/mcp`.

Ihr API-Schlüssel legt fest, auf welche Mandanten- und Plattformressourcen der Server zugreifen kann. Die Anmeldung bei BuildingPro Suites mit Microsoft SSO meldet einen MCP-Client nicht an. MCP verwendet derzeit zur Authentifizierung einen API-Schlüssel und keine individuelle Benutzeranmeldung.

{% hint style="info" %}
Nur ein Administrator kann einen API-Schlüssel erstellen. Jeder Schlüssel gewährt derzeit entweder Lesezugriff oder Lese- und Schreibzugriff. Wir planen, API-Schlüssel zu überarbeiten und fein abgestufte rollenbasierte Zugriffsrechte sowie dedizierte MCP-Schlüssel einzuführen.
{% endhint %}

[Toolset-Auswahl](https://docs.buildings.ability.abb/collection/german/fur-entwickler/mcp/connect-your-client.md#choose-tools) legt fest, welche Tools der Client finden kann.

## Derzeitige Funktionen

| Aufgabe                                                                                                                                                           | Möglichkeiten                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Wichtige Einschränkungen                                                                                                                                                                                                                    |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Anlagen finden](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets.md)                                                             | Anlagen suchen, ihre [Details](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets/asset-details.md)prüfen und [physische/räumliche und funktionale Beziehungen](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets/structuring-assets.md).                                                                                                                                                                                                                                                                                                                                                                                              | Namen können mehrdeutig sein. Überprüfen Sie anhand eindeutiger Kennungen (z. B. `gai`, `asset_id`), ob es sich um die richtige Anlage handelt, bevor Sie sie ändern.                                                                       |
| [Daten lesen und analysieren](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets/asset-data.md)                                     | Lesen Sie [aktuelle Werte und historische Daten](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets/asset-data.md), vergleichen Sie Trends und verwenden Sie bei Bedarf konfigurierte Einheitenumrechnungen.                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Für einige Attribute liegen keine historischen Messwerte vor. Fehlende Messwerte sind nicht gleich null. Achten Sie beim Vergleich von Werten verschiedener Anlagen darauf, dass ihre Einheiten und Bedeutungen miteinander vereinbar sind. |
| [Alarme prüfen](https://docs.buildings.ability.abb/collection/german/plattform/alert-center/alarms.md)                                                            | Aktuelle oder historische Alarme auflisten und einen Alarm bestätigen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Die aktuellen Ergebnisse können bereits behobene Alarme enthalten, die noch bestätigt werden müssen.                                                                                                                                        |
| [Alarmregeln verwalten](https://docs.buildings.ability.abb/collection/german/plattform/alarms-rules-and-escalations/rules/create-a-rule.md)                       | Unterstützte Alarmregeln auflisten, prüfen, erstellen, aktualisieren oder löschen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Ermitteln Sie zuerst das Asset und das aktivierte Attribut. MCP unterstützt nicht alle in BuildingPro Suites verfügbaren Felder.                                                                                                            |
| [Berechnungen verwalten](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets/attribute-functions/calculate-values-the-calculator.md) | Attributberechnungen auflisten, prüfen, erstellen, aktualisieren oder löschen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Eine Berechnung verwendet entweder eine Formel oder einen unterstützten Filter, nicht beides. Listen gelten mandantenweit oder werden nach Regel-ID gefiltert.                                                                              |
| [Dashboards erstellen](https://docs.buildings.ability.abb/collection/german/plattform/live-cockpit/create-a-new-dashboard.md)                                     | Dashboards suchen und lesen, Dashboards erstellen, Widget-Typen prüfen und [Widgets verwalten](https://docs.buildings.ability.abb/collection/german/plattform/live-cockpit/add-widgets-to-the-dashboard.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Ohne Browserzugriff oder Screenshots kann ein Agent nur die unverarbeitete, gespeicherte Konfiguration sehen und nicht bestätigen, wie das Dashboard in der Benutzeroberfläche aussieht.                                                    |
| [Gebäudeeinrichtung verwalten](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets.md)                                               | Verwalten Sie [Assets](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets.md), [Asset-Typen](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/platform-core/asset-core/configure-attributes.md), [Tags](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/platform-core/workspace-and-identity/tags.md) und [Standorte](https://docs.buildings.ability.abb/collection/german/erste-schritte/2.-configure-edge-and-connect-via-openbos/associate-site.md). Listen Sie [Benutzer und Rollen](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/platform-core/workspace-and-identity/roles.md). | Benutzer- und Rollentools sind schreibgeschützt. Tags können nicht gelöscht werden. Beim Löschen eines Assets können auch die zugehörigen Daten gelöscht werden.                                                                            |
| [Daten schreiben](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets/asset-data.md#add-new-data-entry)                              | Unterstützte Werte in Asset-Attribute schreiben.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Der API-Schlüssel muss Schreibzugriffe erlauben. Das Schreiben in ein Ausgabattribut kann Geräte steuern.                                                                                                                                   |

## Mögliche zukünftige Funktionen

Die folgenden Bereiche werden für eine zukünftige MCP-Unterstützung in Betracht gezogen.

| Bereich                 | Mögliche Funktion                                                                                             |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
| Insight Analytics       | Gespeicherte Analysen erstellen und verwalten und sie anschließend für einen ausgewählten Zeitraum auswerten. |
| Smart Views             | Ansichten, ihre Elemente und ihre Datenbindungen erstellen und verwalten.                                     |
| Tickets                 | Tickets suchen und verwalten, einschließlich Zuweisungen, Kommentaren und Statusänderungen.                   |
| Smart-Logic-Regelketten | Regelketten erstellen und verwalten.                                                                          |
| Berichte und Skripte    | Mit Berichten oder Skripten arbeiten (z. B. Berichte prüfen oder bei der Skripterstellung helfen).            |
| Module und Apps         | Unterstützte Moduldienste und möglicherweise Apps wie Anomalieerkennung oder Buchung anbinden.                |

## Client verbinden

<a href="https://docs.buildings.ability.abb/collection/german/fur-entwickler/mcp/connect-your-client.md" class="button secondary">Client verbinden</a>

## Beispiel ausprobieren

Auf der [Workflows und Prompts](https://docs.buildings.ability.abb/collection/german/fur-entwickler/mcp/workflows-and-prompts.md) -Seite finden Sie Prompts, die Sie kopieren oder bei einem unterstützten KI-Anbieter öffnen können. Verbinden Sie Ihren Client, bevor Sie einen Prompt senden.

{% prompt description="Check current temperature readings" openInAIProviders="true" defaultExpanded="full" %}

```markdown
Verwende die BuildingPro-Suites-MCP-Tools, um Temperatursensoren in [Gebäude] zu finden.
Bitte mich um eine Auswahl, wenn mehr als ein Gebäude infrage kommt.
Zeige für jeden Sensor den aktuellen Messwert, die Einheit und den Zeitstempel an.
Führe fehlende Messwerte separat auf. Ändere nichts.
```

{% endprompt %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.buildings.ability.abb/collection/german/fur-entwickler/mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
