Kontakt
(Leitfaden)

Claude-Connector für SaaS:was er voraussetzt

Aktualisiert · 4 Min. Lesezeit

Wenn Ihre Nutzer in Claude arbeiten, bringt ein Connector Ihr Produkt in diese Arbeit: Claude liest ihre Daten und handelt in ihrem Konto. Das verlangt Anthropic von einem solchen Connector, von der Anmeldung bis zum Verzeichniseintrag.

Was ein Connector bringt

Ein Connector ist ein entfernter MCP-Server, der zu Claude hinzugefügt wird. Für ein SaaS-Produkt heißt das:

  • Eine Anmeldung für alle Apps: claude.ai, die Desktop- und Mobil-Apps, Cowork und Claude Code.
  • In den Plänen Team und Enterprise aktiviert ein Owner der Organisation den Connector für das ganze Team.
  • Ein Verzeichniseintrag ist optional. Nutzer können den Connector über die Server-URL hinzufügen; das Verzeichnis bringt Sichtbarkeit und ein Qualitätslabel.
  • Derselbe Server funktioniert als ChatGPT-Plugin, mit eigener Anmeldekonfiguration und eigenem Eintrag.

Anmeldung: OAuth statt API-Schlüssel

Wenn Tools im Konto eines Nutzers handeln, meldet sich jeder Nutzer per OAuth 2.0 mit seinem eigenen Konto an. Der OAuth-Client von Claude hat einige Anforderungen, an denen Konfigurationen am häufigsten scheitern:

  • Client-Registrierung: standardmäßig über Dynamic Client Registration oder ein Client ID Metadata Document. Bei viel Verkehr aus dem Verzeichnis ist CIMD besser, denn DCR registriert bei jeder neuen Verbindung einen neuen Client.
  • Auf Anfrage (per E-Mail an mcp-review@anthropic.com) kann Anthropic die Zugangsdaten eines OAuth-Clients verwahren, den Sie für Claude anlegen.
  • PKCE mit der Methode S256 bei jeder Autorisierung. Ein client_credentials-Flow ohne beteiligten Nutzer wird nicht unterstützt.
  • Eine 401-Antwort mit einem WWW-Authenticate-Header, der auf Ihre Resource-Metadaten verweist. Aus einer 200-Antwort startet Claude keine Anmeldung.
  • Die Redirect-URI https://claude.ai/api/mcp/auth_callback sowie localhost-Redirects auf beliebigem Port für Claude Code.
  • OAuth-Endpunkte müssen innerhalb von 10 Sekunden antworten, die Token-Erneuerung innerhalb von 30.

Einige Tools ohne Anmeldung

Wenn einige Tools ohne Konto funktionieren (etwa die Suche in öffentlicher Dokumentation), unterstützt Claude Lazy Authentication: Nutzer verwenden diese Tools sofort und melden sich erst an, wenn sie ein Tool erreichen, das ihr Konto braucht. Für Unternehmen mit SSO gibt es Enterprise Managed Auth, das Nutzer über den Identity Provider der Organisation ohne Zustimmungsbildschirm verbindet.

Ein fester API-Schlüssel im Request-Header, den ein Owner der Organisation einmal eingibt, ist in der Beta und nur für einen Teil der Organisationen verfügbar. Planen Sie einen Connector für alle nicht darauf auf.

Tools, die die Prüfung bestehen

  • Getrennte Tools zum Lesen und zum Schreiben. Ein einzelnes Sammel-Tool wie api_request mit einem Methodenparameter wird abgelehnt.
  • Jedes Tool hat einen Titel und eine Annotation readOnlyHint oder destructiveHint. Lesende Tools dürfen ohne Rückfrage laufen, datenändernde fragen immer nach Zustimmung.
  • Namen mit höchstens 64 Zeichen und Beschreibungen, die genau sagen, was das Tool tut. Keine Anweisungen, die Claudes Verhalten steuern, und keine Werbung.
  • Konkrete Fehlermeldungen statt „Internal Server Error“ und Antworten in vernünftiger Größe.
  • Ihre eigene API auf der Domain Ihres Dienstes. Connectors, die Geld überweisen oder mit KI-Modellen Bilder, Videos oder Audio erzeugen, werden nicht angenommen.

Eine eigene Adresse für jeden Kunden

In vielen SaaS-Produkten hat jeder Kunde eine eigene Subdomain. In der Einreichung wählen Sie eine gemeinsame URL, eine feste Liste von URLs (etwa eine pro Region) oder ein Muster, dem die URL des Nutzers entsprechen muss. Für ein Muster empfiehlt Anthropic CIMD, und solche Einträge brauchen länger in der Prüfung.

Einreichung im Connectors Directory

Einreichen kann jeder mit einem kostenpflichtigen Claude-Plan, über das Portal unter claude.ai/directory/manage. Neben dem Server brauchen Sie ein vollständig befülltes Testkonto, öffentliche Dokumentation (ein Blogbeitrag oder Hilfeartikel genügt) und sieben Bestätigungen zu den Richtlinien. Die vollständige Checkliste für beide Verzeichnisse steht im Leitfaden So kommen Sie in die Verzeichnisse von ChatGPT und Claude.

Community oder Verified

Anthropic prüft jede Einreichung automatisch auf die Richtlinien und listet sie standardmäßig als Community-Connector. Einträge, die das System als besonders nützlich einstuft, kommen in die Verified-Prüfung, in der Prüfer jedes Tool testen. Einen eigenen Antrag für diesen Status gibt es nicht. Verified-Connectors tragen ein Häkchen neben dem Namen, und bevor jemand einen Community-Connector verbindet, weist Claude darauf hin, dass er nicht eingehend geprüft wurde.

FAQ
Brauche ich für die Einreichung einen Team- oder Enterprise-Plan?
Nein. Einreichen kann jeder mit einem kostenpflichtigen Claude-Plan.
Können Kunden den Connector schon vor dem Verzeichniseintrag nutzen?
Ja. Jeder kann den Connector über die Server-URL als eigenen Connector hinzufügen. Das Verzeichnis bringt Sichtbarkeit und ein Label, an der Funktion der Tools ändert es nichts.
Brauche ich für jeden Unternehmenskunden eine eigene OAuth-App?
Nein. Unternehmenskunden verbinden sich über dieselbe OAuth-App wie alle anderen, und was jeder Nutzer erreicht, bestimmen seine Berechtigungen in Ihrem Produkt.
Leitfäden

Brauchen Sie einen Claude-Connector für Ihr Produkt?

Claude-Connectors

MACHEN WIRETWAS, DASIM KOPF→BLEIBT

Schreiben Sie uns