> 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/faq-and-troubleshooting.md).

# FAQ und Fehlerbehebung

Beheben Sie Probleme mit dem MCP-Zugriff, den Berechtigungen und den Tool-Ergebnissen von BuildingPro Suites.

## MCP-Grundlagen

<details>

<summary>Was ist das Model Context Protocol?</summary>

Das Model Context Protocol (MCP) ist ein offener Standard, der definiert, wie KI-Agenten (in der Regel große Sprachmodelle) mit externen Tools und Diensten verbunden werden. Weitere Informationen finden Sie auf [modelcontextprotocol.io](https://modelcontextprotocol.io/).

In unserem Fall ermöglicht MCP die Definition von Tools für die Funktionen und Merkmale von BuildingPro Suites. KI-Clients können anschließend auf diese zugreifen und damit mit den Daten und Diensten der Plattform interagieren.

</details>

## Verbindung und Authentifizierung

<details>

<summary>Welche MCP-Server-URL soll ich verwenden?</summary>

Verwenden Sie `https://buildings.ability.abb/suites/mcp` in Ihrem MCP-Client.

</details>

<details>

<summary>Kann ich mich mit Microsoft anmelden, statt einen API-Schlüssel zu verwenden?</summary>

Derzeit erfolgt die Authentifizierung bei unserem MCP-Server ausschließlich über einen API-Schlüssel, nicht über die Microsoft-Sitzung, mit der Sie sich bei BuildingPro Suites anmelden.

</details>

<details>

<summary>Warum kann ich über Codex, aber nicht über ChatGPT im Web eine Verbindung herstellen?</summary>

Codex unterstützt benutzerdefinierte HTTP-Header, die einen Schlüssel aus einer Umgebungsvariablen auslesen können. Die benutzerdefinierte MCP-Verbindung von ChatGPT im Web unterstützt derzeit nicht die `X-API-Key` -Authentifizierung, die dieser Server verwendet.

</details>

<details>

<summary>Warum schlägt es fehl, die MCP-URL in einem Browser zu öffnen?</summary>

Die MCP-URL ist ein Endpunkt für kompatible Clients und keine Webseite. Verwenden Sie sie in Ihrem MCP-Client.

</details>

<details>

<summary>Wie kann ich den Zugriff eines Clients beenden?</summary>

Löschen oder ersetzen Sie den API-Schlüssel in BuildingPro Suites. Siehe [Informationen zum API-Schlüssel](https://docs.buildings.ability.abb/collection/german/plattform/platform-core/api-keys.md#api-key-information). Ein Client mit einem gelöschten oder abgelaufenen Schlüssel kann sich nicht mehr authentifizieren.

</details>

## Mandantenzugriff und Berechtigungen

<details>

<summary>Welchen Mandanten und welche Berechtigungen verwendet meine Verbindung?</summary>

Der API-Schlüssel legt den Mandanten und die API-Berechtigungen fest. Die Verbindung übernimmt nicht die Berechtigungen einer Person, die auf der BuildingPro-Suites-Website angemeldet ist. Ein API-Schlüssel verfügt entweder über schreibgeschützte Berechtigungen, die nur das Abrufen von Daten erlauben, oder über Lese- und Schreibberechtigungen, die Änderungen gemäß den autorisierten Vorgängen erlauben.

</details>

<details>

<summary>Wird mein Schlüssel schreibgeschützt, wenn ich weniger Toolsets auswähle?</summary>

Nein. Toolsets legen fest, welche Tools der Client erkennt. Die Berechtigungen des API-Schlüssels autorisieren die einzelnen Vorgänge. Verwenden Sie einen Schlüssel mit schreibgeschützten Berechtigungen, wenn Sie nur Daten lesen müssen.

</details>

<details>

<summary>Warum funktioniert eine Standort-ID nicht mit Tools für die Anlagenhierarchie?</summary>

Ein Standorteintrag verwendet eine UUID. Eine Standortanlage verwendet eine numerische Anlagen-ID. Diese Kennungen sind unterschiedlich. Verwenden Sie die Standort-UUID für Standortfilter und die numerische Anlagen-ID für Hierarchie-Tools.

</details>

<details>

<summary>Warum fehlen einige Tools?</summary>

Toolsets legen fest, welche Tools in Ihrem Client angezeigt werden (und ermöglichen so eine granularere Kontextverwaltung). Wählen Sie das benötigte Toolset aus oder lassen Sie `toolsets` weg, um alle vom MCP-Server bereitgestellten Tools anzuzeigen. Ihr API-Schlüssel bestimmt, welche Vorgänge Sie ausführen können. Bitten Sie einen Administrator, den Zugriff zu prüfen, wenn ein Vorgang abgelehnt wird.

</details>

## Fehlende Tools oder Daten

<details>

<summary>Warum fehlen einige Messwerte?</summary>

Eine Anlage kann vorhanden sein, ohne dass nutzbare Messwerte verfügbar sind. Die Plattform erstellt nicht für jeden Attribut-Untertyp historische Trenddatensätze. Fehlende Messwerte sind nicht gleich null.

</details>

<details>

<summary>Warum enthalten aktuelle Alarme auch behobene Alarme?</summary>

Die Ergebnisse aktueller Alarme können Alarme enthalten, die behoben wurden, aber noch auf eine Bestätigung warten. Prüfen Sie die Zeitstempel für die Behebung und die Bestätigung separat.

</details>

<details>

<summary>Kann MCP Smart-Logic-Regelketten erstellen?</summary>

Derzeit nicht. MCP unterstützt ausgewählte Alarmregeln und Attributberechnungen. Smart-Logic-Regelketten werden damit nicht erstellt.

</details>

## Änderungen und Anlagensteuerung

<details>

<summary>Kann eine MCP-Aktion eine Anlage verändern?</summary>

Ja. Das Schreiben in ein Ausgangsattribut kann eine Anlage steuern. Prüfen Sie die genaue Anlage, das Attribut und den Wert, bevor Sie einen Schreibvorgang genehmigen.

</details>

<details>

<summary>Verhindert eine Genehmigungsanweisung in einem Prompt eine Aktion?</summary>

Nein. Ein Prompt leitet den KI-Client an, erzwingt aber keine Genehmigung. Prüfen Sie die Bestätigung des Clients und die Tool-Argumente, bevor Sie eine Änderung zulassen.

</details>

<details>

<summary>Sieht ein gespeichertes Dashboard in der Benutzeroberfläche korrekt aus?</summary>

Nicht unbedingt. Eine erfolgreiche Speicherung bestätigt, dass die Konfiguration gespeichert wurde. Öffnen Sie das Dashboard in BuildingPro Suites, um sein Erscheinungsbild zu prüfen.

</details>

## MCP und Copilot Assistant

<details>

<summary>Ist MCP Teil von Copilot Assistant?</summary>

Nein. MCP ist eine separate Verbindung für kompatible KI-Clients, die Sie mit den KI-Modellen und Umgebungen Ihrer Wahl verwenden können. Der Data Agent von Copilot Assistant konzentriert sich auf das Abrufen und Analysieren von Daten.

</details>

<details>

<summary>Welche Informationen erhält mein KI-Anbieter?</summary>

Der KI-Client sendet Prompts und MCP-Tool-Anfragen an den konfigurierten Anbieter und empfängt Tool-Ergebnisse (und damit auch Informationen über Ihre Assets und deren Messwerte), die in den meisten Fällen ebenfalls vom Anbieter verarbeitet werden. Prüfen Sie die KI-Richtlinien Ihrer Organisation und die Datenschutzbestimmungen des Anbieters, bevor Sie Mandantendaten verbinden.

</details>


---

# 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/faq-and-troubleshooting.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.
