# Einen KI-Assistenten verbinden

Am Ende kennt Ihr Assistent die Werkzeuge von Szenera, arbeitet in Ihrer Organisation mit den Rechten, die Sie gewählt haben, und beantwortet die Frage, wer er in Szenera ist.

> **Typ:** anleitung
> **Für wen:** Alle, die Claude, ChatGPT, Cursor, VS Code oder einen anderen Client anbinden, der das Model Context Protocol spricht
> **Voraussetzung:** ein Konto in Ihrer Organisation und entweder ein Client, der sich über OAuth anmelden kann, oder ein API-Schlüssel `ak_…` mit den Rechten der Werkzeuge, die Sie nutzen wollen
> **Ort:** die Einstellungen Ihres Assistenten

## Die Adresse

| Was | Wert |
|---|---|
| Adresse | `https://mcp.<domain>/mcp`, wobei `<domain>` die Domain Ihrer Umgebung ist, zum Beispiel `https://mcp.szenera.com/mcp` |
| Übertragung | Streamable HTTP |
| Anmeldung | OAuth 2.1 mit Einwilligung oder `Authorization: Bearer ak_…` |

## Den Weg der Anmeldung wählen

| Weg | Gut für | Was Sie eintragen |
|---|---|---|
| **Anmeldung über OAuth** | Assistenten mit eigenem Anmeldeweg, etwa Claude, ChatGPT, Claude Code und VS Code | Nur die Adresse. Der Assistent registriert sich selbst, öffnet die Anmeldung von Szenera im Browser, und Sie entscheiden auf der Einwilligungsseite, was er darf. |
| **API-Schlüssel** | Clients ohne Anmeldeweg, Automatisierung und geteilte Rechner | Die Adresse und die Kopfzeile `Authorization: Bearer ak_…` |

Über OAuth handelt die Verbindung in Ihrem Namen und bekommt nie mehr, als Ihr Konto hat. Mit einem API-Schlüssel bekommt sie genau die Rechte des Schlüssels. Welche Rechte die Werkzeuge brauchen, steht unter [Rechte und Einwilligung](/de/mcp/permissions).

## Schritte

### Claude (claude.ai und die Desktop-App)

1. Öffnen Sie in Claude die Einstellungen unter **Connectors** und fügen Sie einen eigenen Connector hinzu. Ob das geht, hängt von Ihrem Claude-Tarif ab.
2. Tragen Sie einen Namen wie „Szenera“ und die Adresse ein.
3. Verbinden Sie den Connector. Ihr Browser öffnet die Anmeldung von Szenera und danach die Seite **Zugriff erlauben?**
4. Prüfen Sie die Bereiche, schalten Sie ab, was der Assistent nicht bekommen soll, und klicken Sie auf **Erlauben**.

### Claude Code

Tragen Sie den Server einmal ein und melden Sie sich in Claude Code an:

```bash
claude mcp add --transport http szenera https://mcp.szenera.com/mcp
```

Rufen Sie danach in Claude Code `/mcp` auf, wählen Sie `szenera` und melden Sie sich an. Mit einem API-Schlüssel geben Sie die Kopfzeile stattdessen beim Eintragen mit:

```bash
claude mcp add --transport http szenera https://mcp.szenera.com/mcp \
  --header "Authorization: Bearer ak_…"
```

### ChatGPT

Legen Sie einen eigenen Connector mit der Adresse an, sofern Ihr ChatGPT-Tarif eigene Connectors anbietet, und wählen Sie OAuth als Anmeldung. ChatGPT registriert sich selbst und öffnet die Anmeldung von Szenera. Bestätigen Sie die Einwilligungsseite wie bei Claude.

### Cursor

Tragen Sie den Server in `.cursor/mcp.json` Ihres Projekts ein, oder in `~/.cursor/mcp.json` für alle Projekte:

```json
{
  "mcpServers": {
    "szenera": {
      "url": "https://mcp.szenera.com/mcp",
      "headers": { "Authorization": "Bearer ak_…" }
    }
  }
}
```

### VS Code mit GitHub Copilot

Tragen Sie den Server in `.vscode/mcp.json` ein. Das Eingabefeld fragt beim Start des Servers nach dem Schlüssel, er steht also nie in der Datei:

```json
{
  "inputs": [
    { "type": "promptString", "id": "szenera-key", "description": "Szenera API key", "password": true }
  ],
  "servers": {
    "szenera": {
      "type": "http",
      "url": "https://mcp.szenera.com/mcp",
      "headers": { "Authorization": "Bearer ${input:szenera-key}" }
    }
  }
}
```

Ohne die Zeile `headers` meldet sich VS Code stattdessen über OAuth an.

## Ergebnis prüfen

Fragen Sie Ihren Assistenten: „Wer bin ich in Szenera?“ Er ruft `whoami` auf und nennt Ihr Konto, Ihre Organisation und die Zahl der Rechte, die die Verbindung trägt. Nennt er Rechte unter `missingPermissions`, scheitern die Werkzeuge dahinter, siehe [Rechte und Einwilligung](/de/mcp/permissions#wenn-ein-recht-fehlt).

Fragen Sie dann etwas, das nur liest, etwa „Welche Displays sind seit gestern offline?“ Ein Werkzeug, das etwas ändert, zeigt Ihnen immer zuerst eine Vorschau.

## Trennen

| Weg | So geht es |
|---|---|
| OAuth | Im Portal unter **Einstellungen › Mein Konto › Sicherheit**, Karte **Verbundene Anwendungen**, in der Zeile des Assistenten auf **Widerrufen** klicken. Er verliert jede Erlaubnis sofort. |
| API-Schlüssel | Den Schlüssel unter **Einstellungen › Für Entwickler › API-Schlüssel** widerrufen. Jeder Client, der ihn nutzt, verliert den Zugang. |

Den Server nur im Assistenten zu entfernen, beendet die Verbindung allein auf dieser Seite. Die Erlaubnis in Szenera bleibt, bis Sie sie widerrufen.

## Wenn etwas nicht klappt

| Symptom | Bedeutung | Lösung |
|---|---|---|
| Der Assistent bittet immer wieder um Anmeldung | Das Zugriffstoken ist abgelaufen oder die Erlaubnis widerrufen. | Neu anmelden. Ein Zugriffstoken gilt eine Stunde, der Client erneuert es. |
| Ein Werkzeug antwortet `permission_denied` | Der Einwilligung oder dem Schlüssel fehlt das Recht. | Den Bereich neu erlauben oder einen Schlüssel mit dem Recht verwenden, siehe [Rechte und Einwilligung](/de/mcp/permissions). |
| Der Client erreicht den Server nicht | Die Adresse stimmt nicht, oder der Server läuft in Ihrer Umgebung nicht. | Die Adresse prüfen und ob sie auf `/mcp` endet. |

Weitere Fehler und die Grenzen des Servers stehen unter [Wenn der Assistent keine Verbindung bekommt oder ein Werkzeug scheitert](/de/mcp/troubleshooting).

## Weiterführendes

- [Was kann ein KI-Assistent mit Szenera tun?](/de/mcp/about-mcp)
- [Delegierter Zugang mit OAuth 2.1](/de/api/oauth-delegated-access)
- [Einen API-Schlüssel erzeugen](/de/getting-started/create-api-key)