MCP-Server mit API-Key in Claude nutzen

Q: Warum funktioniert mein Bearer-Token in Claude nicht?

Prüfen Sie zuerst, ob der Abschnitt Request headers in Ihrem Konnektor-Dialog erscheint – er ist noch nicht für alle Organisationen freigeschaltet. Wenn ja: Claude sendet den Wert genau so, wie Sie ihn eintragen. Fehlt das Wort Bearer vor dem Schlüssel, lehnen die meisten Server die Anfrage ab.

Viele MCP-Server im Internet erwarten bei jeder Anfrage einen festen API-Schlüssel, etwa als Authorization: Bearer … oder in einem eigenen Header wie X-API-Key. So arbeiten zum Beispiel selbst gebaute Server, Automatisierungen und viele Plugins. Claude dagegen ist bei Konnektoren auf OAuth ausgelegt: Sie fügen eine Adresse hinzu, melden sich an, fertig. Wer beides zusammenbringen will, hat heute vier Möglichkeiten. Dieser Ratgeber zeigt, wann welche passt.

Zuerst prüfen: Kann Ihr Server schon OAuth?

Bevor Sie etwas umbauen, lohnt ein Blick in die Einstellungen des Servers. Einige Anbieter bieten inzwischen neben dem Schlüssel auch OAuth an:

Der MCP Server Trigger von n8n kennt laut Dokumentation die Anmeldearten keine, Bearer, Header und n8n OAuth2.
Das WordPress-Plugin Royal MCP bietet laut seinen Verzeichniseinträgen einen API-Schlüssel im Header X-Royal-MCP-API-Key oder OAuth 2.1.

Bietet Ihr Server OAuth, nehmen Sie das: Jede Person meldet sich einzeln an, und Sie brauchen keinen der folgenden Wege.

Weg 1: Request-Header direkt in Claude

Seit Ende August 2026 kann Claude bei eigenen Konnektoren feste Header mitschicken. Laut der Claude-Dokumentation ist diese Funktion noch eine Beta und nur für einen Teil der Organisationen freigeschaltet. So gehen Sie vor:

In Claude Anpassen → Konnektoren → Eigenen Konnektor hinzufügen öffnen.
Die Adresse des Servers eintragen, zum Beispiel https://mcp.example.com/mcp.
Als Anmeldung Keine Anmeldung wählen und unter Request headers den Header eintragen.
Den Wert vollständig eingeben, bei Bearer-Tokens also Bearer mit Leerzeichen und dann den Schlüssel.

Wichtig zu wissen:

Sehen Sie den Abschnitt Request headers nicht, ist er für Ihre Organisation noch nicht freigeschaltet.
Erlaubt sind bis zu vier Header. Gängige Namen wie authorization und x-api-key stehen zur Auswahl; eigene Namen muss Anthropic erst freigeben.
Der Schlüssel gilt für alle, die den Konnektor nutzen. Die Dokumentation empfiehlt Header deshalb für gemeinsam genutzte Zugänge und OAuth, wenn sich jede Person selbst anmelden soll.
Die Anmeldedaten lassen sich nachträglich nicht ändern: Für einen neuen Schlüssel entfernen Sie den Konnektor und legen ihn neu an.

Weg 2: Claude Code, Cursor oder VS Code

Entwicklerwerkzeuge können Header schon lange setzen. Für Claude Code genügt ein Befehl:

claude mcp add --transport http mein-server https://mcp.example.com/mcp --header "Authorization: Bearer IHR_SCHLÜSSEL"

In Cursor tragen Sie den Server in ~/.cursor/mcp.json ein:

{
  "mcpServers": {
    "mein-server": {
      "url": "https://mcp.example.com/mcp",
      "headers": { "Authorization": "Bearer IHR_SCHLÜSSEL" }
    }
  }
}

In Visual Studio Code gehört die Konfiguration in .vscode/mcp.json. Damit der Schlüssel nicht in der Datei steht, lässt er sich beim Start abfragen:

{
  "inputs": [
    { "type": "promptString", "id": "api-key", "description": "API-Schlüssel", "password": true }
  ],
  "servers": {
    "mein-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": { "Authorization": "Bearer ${input:api-key}" }
    }
  }
}

Der Haken: Das hilft nur am eigenen Rechner. Im Browser, in der Claude-App auf dem Smartphone und für Kollegen ohne diese Werkzeuge bleibt der Server unerreichbar. Und der Schlüssel liegt auf jedem Laptop, auf dem er eingerichtet ist.

Weg 3: Eine eigene OAuth-Schicht davorsetzen

Sie können vor den Server einen eigenen Dienst stellen, der gegenüber Claude OAuth spricht und gegenüber dem Server den Schlüssel einsetzt. Das ist machbar, aber mehr Arbeit, als es zunächst aussieht:

Metadaten für geschützte Ressourcen (RFC 9728) und für den Autorisierungsserver (RFC 8414) veröffentlichen.
Anmeldung, Zustimmungsseite, PKCE, Registrierung von Clients (dynamisch oder über Client-ID-Metadaten-Dokumente) und Refresh-Tokens umsetzen.
Tokens an genau diesen Server binden und widerrufbar machen.
Den API-Schlüssel verschlüsselt speichern und aus Logs heraushalten.
Den Dienst betreiben, absichern und mit der Spezifikation aktuell halten, die sich regelmäßig ändert.

Für ein Entwicklerteam mit eigener Infrastruktur ist das ein überschaubares Projekt. Für einzelne Server, die einfach nur in Claude funktionieren sollen, lohnt es sich selten.

Weg 4: Die OAuth-Brücke von XenMCP (in Vorbereitung)

Genau diese Schicht plant XenMCP als Dienst. Zum Start der geschlossenen Beta sollen Sie die Adresse Ihres Servers und den Schlüssel eintragen und erhalten eine Adresse wie https://ihr-name.xenmcp.com/mcp, die Sie in Claude als gewöhnlichen Konnektor mit OAuth hinzufügen. Geplant ist:

Der Schlüssel wird verschlüsselt gespeichert (AES-256-GCM) und nirgends angezeigt.
Jede Person aus Ihrem Team meldet sich einzeln an; den Zugang einer Person können Sie widerrufen, ohne den Schlüssel zu wechseln.
Ein Protokoll zeigt, wer welches Werkzeug wann aufgerufen hat – nur Metadaten, keine Inhalte.
Betrieb in Deutschland, mit fester ausgehender IP-Adresse für Ihre Firewall.

Wie die Brücke funktioniert, beschreibt die Seite OAuth-Brücke für API-Key-Server, Details zum Schutz der Daten stehen unter Sicherheit. Was Claude selbst mit den Antworten des Servers macht, geschieht bei Anthropic; darauf hat auch eine Brücke keinen Einfluss.

Welcher Weg passt?

Ihr Server kann OAuth: OAuth direkt nutzen.
Sie arbeiten allein oder mit einem gemeinsamen Dienstkonto und sehen Request headers in Claude: Weg 1.
Sie nutzen den Server nur in Entwicklerwerkzeugen: Weg 2.
Mehrere Personen sollen sich einzeln anmelden, Zugänge widerrufbar und Aufrufe nachvollziehbar sein, und Sie wollen keinen eigenen Dienst betreiben: Weg 3 selbst bauen oder auf Weg 4 warten.

Wie Sie einen Konnektor in Claude auf allen Geräten einrichten, zeigt der Ratgeber MCP-Server mit Claude verbinden.

Häufige Fragen

Warum funktioniert mein Bearer-Token in Claude nicht?

Prüfen Sie zuerst, ob der Abschnitt Request headers in Ihrem Konnektor-Dialog erscheint – er ist noch nicht für alle Organisationen freigeschaltet. Wenn ja: Claude sendet den Wert genau so, wie Sie ihn eintragen. Fehlt das Wort Bearer vor dem Schlüssel, lehnen die meisten Server die Anfrage ab.

Ist ein gemeinsamer API-Schlüssel ein Sicherheitsproblem?

Nicht zwingend, aber er hat Grenzen: Alle Nutzer arbeiten mit denselben Rechten, und wenn jemand das Team verlässt, müssen Sie den Schlüssel wechseln. Geben Sie dem Schlüssel daher nur die Rechte, die wirklich gebraucht werden.

Funktioniert ein Konnektor aus dem Web auch in der Claude-App auf dem Smartphone?

Konnektoren, die Sie in Ihrem Claude-Konto anlegen, gelten für das Konto. Lokale Konfigurationen aus Claude Code, Cursor oder VS Code gelten dagegen nur auf dem jeweiligen Rechner.

Wann ist die OAuth-Brücke von XenMCP verfügbar?

Sie ist für den Start der geschlossenen Beta geplant. Tragen Sie sich auf der Warteliste ein und geben Sie an, welchen Server Sie verbinden möchten.

MCP-Server mit API-Key in Claude nutzen – vier Wege im Vergleich