Was sind Client ID Metadata Documents? MCP-Clients erklärt

ProduktivbetriebProtokolle und IntegrationVeröffentlicht Aktualisiert Von Simon Budziak

Client ID Metadata Documents (CIMD) erlauben einem OAuth-Client, eine HTTPS-URL als Client-ID zu verwenden. Unter der URL liegt ein JSON-Dokument, das den Client beschreibt und das der Autorisierungsserver beim ersten Kontakt abruft. Die MCP-Autorisierungsspezifikation empfiehlt das für den häufigen Fall, dass ein Client auf einen unbekannten Server trifft, ganz ohne Registrierungsschritt.

Wie funktioniert ein Client ID Metadata Document?

Der Client hostet eine JSON-Datei unter einer HTTPS-URL mit Pfad und verwendet diese URL als seine client_id. Nach der Autorisierungsspezifikation von MCP muss das Dokument mindestens client_id, client_name und redirect_uris enthalten, und seine client_id muss exakt der URL entsprechen (MCP client registration, 2026-07-28, abgerufen am 16. November 2026). Gekürzt aus dem Beispiel der Spezifikation:

{
  "client_id": "https://app.example.com/oauth/client-metadata.json",
  "client_name": "Example MCP Client",
  "redirect_uris": ["http://127.0.0.1:3000/callback"],
  "token_endpoint_auth_method": "none"
}

Der Autorisierungsserver kündigt in seinen OAuth-Metadaten client_id_metadata_document_supported: true an. Kommt eine Autorisierungsanfrage mit einer client_id in URL-Form an, ruft er das Dokument ab, prüft, ob die client_id übereinstimmt, ob die Redirect-URI aufgeführt ist und ob das JSON gültig ist, und zeigt dem Nutzer dann einen Zustimmungsdialog mit dem Namen des Clients. Er sollte das Dokument gemäß seinen HTTP-Cache-Headern zwischenspeichern. Die Identität des Clients ist das, was seine eigene Domain ausliefert, kein Server führt also einen Registrierungseintrag für ihn. Damit weiß ein Server, welche Software anfragt, das ist die Frage der Agentenidentität, aber nicht, was sie tun darf.

Worin unterscheidet sich CIMD von Dynamic Client Registration?

CIMD ersetzt einen Registrierungsaufruf durch den Abruf eines Dokuments, einer von drei Mechanismen, die die MCP-Spezifikation nennt:

Client ID Metadata Documents Dynamic Client Registration Vorab-Registrierung
Woher die client_id kommt Eine HTTPS-URL, die der Client hostet Vom Registrierungsendpunkt des Servers ausgestellt Vorab ausgestellt, außerhalb des Protokolls
Wechsel des Autorisierungsservers Portabel, keine erneute Registrierung Erneute Registrierung nötig An den ausstellenden Server gebunden
Status in MCP 2026-07-28 SHOULD support Veraltet (deprecated), MAY support SHOULD bietet eine Option dafür an

Ein Client, der alle drei unterstützt, sollte zuerst vorab registrierte Zugangsdaten versuchen, dann CIMD, falls der Server es ankündigt, dann Dynamic Client Registration, falls der Server einen registration_endpoint hat, und erst dann den Nutzer fragen. CIMD kam mit der Revision 2025-11-25 als empfohlener Mechanismus in MCP (Changelog, abgerufen am 16. November 2026). Die Revision 2026-07-28, dieselbe, die MCP zustandslos machte, erklärte Dynamic Client Registration zu seinen Gunsten für veraltet; eine Entfernung ist ab der ersten Revision möglich, die am oder nach dem 28. Juli 2027 erscheint (deprecated features, abgerufen am 16. November 2026). Neue Clients und Autorisierungsserver sollten zuerst CIMD bauen und Dynamic Client Registration nur noch für ältere Server behalten.

Welche Sicherheitsrisiken lässt CIMD offen?

Der Autorisierungsserver ruft eine URL ab, die ein Fremder geliefert hat. Jeder CIMD-Abruf ist eine ausgehende Anfrage im Auftrag eines anderen, weshalb die Spezifikation Server auf die Hinweise des IETF-Entwurfs zu Server-Side Request Forgery (SSRF) verweist (MCP security considerations, abgerufen am 16. November 2026). CIMD allein kann auch nicht verhindern, dass sich eine lokale App als ein Client ausgibt, dessen Redirect-URIs auf localhost zeigen. Server sollten deshalb bei reinen Localhost-Redirect-URIs warnen und müssen während der Autorisierung den Hostnamen der Redirect-URI anzeigen. Die MCP-Spezifikation zitiert den Entwurf -00, der IETF-Entwurf ist inzwischen bei -03, zuletzt aktualisiert am 2. November 2026 und weiterhin ein Internet-Draft (IETF datatracker, abgerufen am 16. November 2026). Prüfen Sie also, welcher Revision Ihre Auth-Bibliothek folgt. Die breitere Angriffsfläche beschreibt MCP security in production (auf Englisch).

Wie regeln wir bei Soba Labs die Client-Registrierung, wenn wir unsere Agenten mit MCP-Servern verbinden?

Unsere Agenten erreichen entfernte MCP-Server über HTTP, jeweils pro Konto authentifiziert, meist mit OAuth. Wir probieren den eingebauten Autorisierungsablauf des Clients, bevor wir einen OAuth-Client von Hand anlegen. In einem Fall dokumentierte der Anbieter nur Abläufe, die einen eigenen, vorab registrierten Client voraussetzten, und der schlichte eingebaute Ablauf funktionierte ohne ihn, weil die Dokumentation von Anbietern den Servern hinterherhinkt. Grundsätzlich braucht ein Client, der sich selbst per CIMD oder Dynamic Client Registration registriert, nichts, was vorab angelegt wird. Wir vermerken einen Server erst als nutzbar, wenn ein echter Tool Call gelungen ist, denn einmal meldete der Client „connected“, während Tool Calls aus einer laufenden Sitzung mit dem Fehler „Incompatible auth server“ scheiterten.

Mit AI-Unterstützung geschrieben und von Simon Budziak geprüft. Die Hinweise aus der Praxis stammen aus Systemen, die Soba Labs baut und betreibt.

Häufig gestellte Fragen

Brauchen stdio-MCP-Server Client ID Metadata Documents?

Nein. MCP-Autorisierung ist optional und für HTTP-Transporte geschrieben; laut der Spezifikation 2026-07-28 sollen stdio-Implementierungen ihr nicht folgen und Zugangsdaten stattdessen aus der Umgebung beziehen.

Ist eine CIMD-client_id ein Geheimnis?

Nein. Sie ist eine öffentliche HTTPS-URL, die jeder abrufen kann. Ein Client, der sich am Token-Endpunkt authentifizieren muss, kann private_key_jwt mit veröffentlichten Schlüsseln nutzen, wie es die MCP-Seite zur Client-Registrierung erlaubt.

Diese Seite zusammenfassen mit

Ihr Team schulen, damit es das selbst baut