Einen KI-Assistenten verbinden
Den Server in Claude, ChatGPT, Cursor oder VS Code eintragen, sich anmelden oder einen API-Schlüssel hinterlegen und die Verbindung prüfen.
- 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
Auf dieser Seite
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.
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.
Schritte
Claude (claude.ai und die Desktop-App)
- Ö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.
- Tragen Sie einen Namen wie „Szenera“ und die Adresse ein.
- Verbinden Sie den Connector. Ihr Browser öffnet die Anmeldung von Szenera und danach die Seite Zugriff erlauben?
- 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:
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:
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:
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:
Ohne die Zeile headers meldet sich VS Code stattdessen über OAuth an.
claude mcp add --transport http szenera https://mcp.szenera.com/mcpclaude mcp add --transport http szenera https://mcp.szenera.com/mcp \ --header "Authorization: Bearer ak_…"{ "mcpServers": { "szenera": { "url": "https://mcp.szenera.com/mcp", "headers": { "Authorization": "Bearer ak_…" } } }}{ "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}" } } }}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.
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. |
| 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.