> 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/connect-your-client.md).

# Verbinden Sie Ihren Client

Verbinden Sie einen kompatiblen KI-Client mit dem BuildingPro-Suites-MCP-Server.

Verbinden Sie einen KI-Client über einen API-Schlüssel mit BuildingPro Suites. Der Server verwendet Streamable HTTP unter

```http
https://buildings.ability.abb/suites/mcp
```

## Vorbereitung

* Ein MCP-kompatibler Client, der Streamable HTTP und den `X-API-Key` -Header unterstützt.
* Ein API-Schlüssel für den BuildingPro-Suites-Mandanten, auf den Sie zugreifen möchten.
* Der MCP-Endpunkt: `https://buildings.ability.abb/suites/mcp`.

Informationen zum Einrichten eines Schlüssels finden Sie unter [API-Schlüssel erstellen](https://docs.buildings.ability.abb/collection/german/plattform/platform-core/api-keys.md#create-api-keys). Bitten Sie Ihren Administrator um einen Schlüssel mit nur den Berechtigungen, die für Ihre Aufgabe erforderlich sind.

Ein API-Schlüssel identifiziert den Mandanten und dessen Ressourcenberechtigungen. Er identifiziert nicht die Person, die beim KI-Client angemeldet ist. Geben Sie den Schlüssel nicht in Prompts, freigegebenen Konfigurationsdateien oder der Quellcodeverwaltung an.

## Server hinzufügen

MCP-Endpunkt verwenden `https://buildings.ability.abb/suites/mcp`.

Wählen Sie Streamable HTTP aus, wenn Ihr Client nach einem Transport fragt. Dieser Server unterstützt weder `stdio` noch `SSE`. Zusätzliche optionale Verbindungsfelder können Sie in der Regel leer lassen.

1. Fügen Sie die Server-URL zu Ihrem KI-Client hinzu.
2. Setzen Sie den Anfrage-Header `X-API-Key` auf Ihren API-Schlüssel.
3. Stellen Sie die Serververbindung her.
4. Bitten Sie den Client, die Standorte aufzulisten, ohne Änderungen vorzunehmen.
5. Vergewissern Sie sich, dass die zurückgegebenen Standorte zum vorgesehenen Mandanten gehören.

Geben Sie den API-Schlüssel nicht in der URL an. Übertragen Sie ihn nicht über öffentliches HTTP.

## Client konfigurieren

Verwenden Sie diese Einstellungen für die folgenden Client-Konfigurationen.

| Einstellung | Wert                                       |
| ----------- | ------------------------------------------ |
| Server-URL  | `https://buildings.ability.abb/suites/mcp` |
| Transport   | `Streamable HTTP`                          |
| HTTP-Header | `X-API-Key: <your API key>`                |

{% tabs %}
{% tab title="Allgemeines" %}
Wählen Sie einen Client aus, der Streamable HTTP und benutzerdefinierte Anfrage-Header unterstützt.

{% stepper %}
{% step %}

### Server-URL festlegen

Geben Sie `https://buildings.ability.abb/suites/mcp`.
{% endstep %}

{% step %}

### Transport auswählen

Wählen Sie `Streamable HTTP`.
{% endstep %}

{% step %}

### API-Schlüssel hinzufügen

Legen Sie den `X-API-Key` Anfrage-Header auf Ihren API-Schlüssel fest.
{% endstep %}
{% endstepper %}

Geben Sie den API-Schlüssel nicht in der URL an und übertragen Sie ihn nicht über öffentliches HTTP.
{% endtab %}

{% tab title="Claude Web oder Desktop" icon="claude" %}
Derzeit können Sie eine Verbindung zu unserem MCP-Server nur herstellen, indem Sie ihn als benutzerdefinierten Connector hinzufügen. Siehe [Benutzerdefinierte Connectoren in Claude Desktop](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) für detaillierte Anweisungen.
{% endtab %}

{% tab title="ChatGPT Web" icon="openai" %}
Die benutzerdefinierte MCP-Verbindung von ChatGPT Web unterstützt derzeit nicht die `X-API-Key` Authentifizierung dieses Servers. Sie können erst dann mit einem API-Schlüssel eine Verbindung herstellen, wenn wir eine kompatible Authentifizierungsmethode unterstützen.

Verwenden Sie OpenAI Codex mit der Konfiguration im nächsten Tab. Siehe [OpenAI-MCP-Authentifizierung](https://developers.openai.com/plugins/build/auth) zu den aktuellen Anforderungen des Clients.
{% endtab %}

{% tab title="Claude Code" icon="claude" %}
Legen Sie `BPRO_MCP_API_KEY` in Ihrer lokalen Umgebung oder Ihrem Secret-Manager fest. Fügen Sie diesen Eintrag zu `.mcp.json`:

```json
{
  "mcpServers": {
    "bpro-suites-mcp": {
      "type": "http",
      "url": "https://buildings.ability.abb/suites/mcp",
      "headers": {
        "X-API-Key": "${BPRO_MCP_API_KEY}"
      }
    }
  }
}
```

Speichern Sie den Schlüsselwert nicht in `.mcp.json`. Starten Sie Claude Code in einer Umgebung, in der `BPRO_MCP_API_KEY` festgelegt ist, und überprüfen Sie anschließend die Verbindung unter `/mcp`.

Siehe [MCP-Einrichtung für Claude Code](https://code.claude.com/docs/en/mcp) zu weiteren Konfigurationsoptionen.
{% endtab %}

{% tab title="OpenAI Codex" icon="openai" %}
Legen Sie `BPRO_MCP_API_KEY` in Ihrer lokalen Umgebung oder Ihrem Secret-Manager fest. Fügen Sie diesen Eintrag zu `~/.codex/config.toml`:

```toml
[mcp_servers.bpro-suites-mcp]
url = "https://buildings.ability.abb/suites/mcp"
env_http_headers = { "X-API-Key" = "BPRO_MCP_API_KEY" }
```

`env_http_headers` gibt den Namen der Umgebungsvariablen an, die den Schlüssel enthält. Der Schlüssel selbst ist darin nicht enthalten. Starten Sie Codex neu und überprüfen Sie die Liste der MCP-Server.

Siehe [MCP-Konfiguration für Codex](https://learn.chatgpt.com/docs/extend/mcp).
{% endtab %}

{% tab title="VS Code" icon="vscode" %}
Fügen Sie diesen Eintrag zu `.vscode/mcp.json`:

```json
{
  "servers": {
    "bpro-suites-mcp": {
      "type": "http",
      "url": "https://buildings.ability.abb/suites/mcp",
      "headers": {
        "X-API-Key": "${input:bpro-suites-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "bpro-suites-api-key",
      "description": "BuildingPro Suites API-Schlüssel",
      "password": true
    }
  ]
}
```

VS Code fordert zur Eingabe des Schlüssels auf, ohne ihn anzuzeigen. Starten Sie den Server in der MCP-Ansicht und bestätigen Sie, dass die Verbindung hergestellt wird.

Siehe [MCP-Server in VS Code hinzufügen](https://code.visualstudio.com/docs/agent-customization/mcp-servers).
{% endtab %}
{% endtabs %}

## Tools auswählen

Wenn Sie `toolsets`weglassen, erkennt Ihr Client alle vom MCP-Server bereitgestellten Tools. Um die Liste einzuschränken, fügen Sie der MCP-URL einen `toolsets` Abfrageparameter hinzu:

```
https://buildings.ability.abb/suites/mcp?toolsets=assets,data
```

Verfügbare Toolsets sind `context`, `admin`, `alarms`, `assets`, `data`, `dashboards`, `rules`und `sites`. Sie können mehrere auswählen.

Die Auswahl der Toolsets ändert nur, welche Tools der Client sieht. Sie gewährt keine Berechtigungen und macht einen Schlüssel mit Schreibberechtigung nicht schreibgeschützt. Der API-Schlüssel autorisiert weiterhin jeden Vorgang.

Diese bieten hauptsächlich eine Möglichkeit, die Nutzung des Kontexts feiner zu steuern.

## Verbindung überprüfen

Bitten Sie den Client, Standorte oder bestimmte Assets aufzulisten. Fordern Sie ein schreibgeschütztes Ergebnis an und fügen Sie den API-Schlüssel nicht in Ihre Eingabe ein.

Bitten Sie den Client, Ihre Standorte aufzulisten, und bestätigen Sie den Mandanten, bevor Sie Daten anfordern. Stimmen die Standorte nicht überein, brechen Sie ab und überprüfen Sie den API-Schlüssel (oder bitten Sie einen Administrator, ihn zu prüfen). Das Tool `whoami` kann dabei helfen, die mit dem API-Schlüssel verknüpfte Identität zu überprüfen.

Wenn ein Client keine Verbindung herstellen kann, überprüfen Sie die URL, den `X-API-Key` Header, den Ablauf des Schlüssels und die dem API-Schlüssel zugewiesenen Berechtigungen.


---

# 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/connect-your-client.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.
