Dies ist ein vollständiger Leitfaden für die Einreichung Ihres Remote-MCP-Servers im Anthropic MCP Directory zur breiteren Verteilung und Auffindbarkeit.
Voraussetzungen
Vor der Servereinreichung sollten Sie folgende Punkte erfüllt haben:
Ein funktionierender und vollständig getesteter Remote-MCP-Server
OAuth 2.0-Authentifizierung implementiert (falls Authentifizierung erforderlich)
Alle Tools mit ordnungsgemäßen Sicherheitsanmerkungen
Produktionsreife Bereitstellung
Ein dedizierter Support-Kanal (E-Mail oder Web)
Bereitgestelltes Testkonto mit Beispieldaten
Umfassende Dokumentation
Neu in der Remote-MCP-Entwicklung? Siehe zunächst Getting Started with Custom Connectors Using Remote MCP. Für technische Best Practices und Protokolldetails siehe MCP Protocol Documentation.
Hinweis: Dieser Leitfaden behandelt Remote-MCP-Server (Cloud-gehostet, HTTPS). Für lokale Desktop-Erweiterungen siehe Local MCP Server Submission Guide.
1. Verzeichnisübersicht
Welche Vorteile bietet die Aufnahme ins Verzeichnis?
Auffindbarkeit und Vertrauen:
Aufgelistet im offiziellen Anthropic MCP Directory, zugänglich von Claude.ai
Zugänglich für Claude-Benutzer auf allen Plattformen (Web, Desktop, Mobilgeräte)
Professionelle Sichtbarkeit für Ihren Service
Benutzererlebnis:
Verbindung mit einem Klick aus dem Verzeichnis
Integration mit Claudes Connector-Schnittstelle
Standardisierte Darstellung auf allen Plattformen
OAuth-Flow wird nahtlos verwaltet
Support und Glaubwürdigkeit:
Anthropic-Überprüfung von Qualität, Sicherheit und Compliance
Aufgelistet neben anderen überprüften Connectoren
Community-Sichtbarkeit und Feedback
Professioneller Vertriebskanal
Welche Claude-Plattformen unterstützen Remote-MCP-Server?
Alle wichtigen Claude-Plattformen:
Claude.ai (Web) - Vollständige Unterstützung mit OAuth
Claude Desktop - Vollständige Unterstützung mit OAuth
Claude Code - Direkte Verbindung vom Benutzercomputer (mit OAuth-Unterstützung)
Claude API - Integrationsunterstützung
Claude Mobile-Apps - Connector-Unterstützung
2. Obligatorische Anforderungen
Alle Anforderungen in diesem Abschnitt sind obligatorisch für die Verzeichnisgenehmigung. Das Fehlen einer dieser Anforderungen führt zu Ablehnung oder Überarbeitungsanfragen.
Sind Sicherheitsanmerkungen erforderlich?
JA - Jedes Tool MUSS genaue Sicherheitsanmerkungen haben.
Erforderlich bei jedem Tool:
readOnlyHint: true - Für Tools, die nur Daten lesen
destructiveHint: true - Für Tools, die Daten ändern oder Nebenwirkungen haben
Siehe MCP Protocol - Tool Annotations für vollständiges Schema und Implementierungsdetails.
Nicht optional. Dies ist eine zwingende Anforderung aus der MCP Directory Policy.
So entscheiden Sie, welche Anmerkung:
Tool-Verhalten | Anmerkung | Beispiele |
Liest nur Daten | readOnlyHint: true, destructiveHint: false | search, get, list, fetch, read |
Schreibt/ändert Daten | destructiveHint: true, readOnlyHint: false | create, update, delete, send |
Erstellt temporäre Dateien | destructiveHint: true | Auch temporäre Schreibvorgänge zählen |
Sendet externe Anfragen | destructiveHint: true | E-Mails, Benachrichtigungen, Webhooks |
Speichert nur intern | readOnlyHint: true | Interne Optimierung OK |
Zusätzliche empfohlene Anmerkung:
title - Benutzerfreundlicher Tool-Name für die UI-Anzeige (verbessert die Benutzererfahrung)
Muss ich Testkonten bereitstellen?
JA - Falls Ihr Server Authentifizierung erfordert.
Was bereitzustellen ist:
Testkonten-Anmeldedaten (Benutzername/Passwort oder API-Schlüssel)
Beispieldaten im Konto (notwendig für funktionales Testen)
Anweisungen zur Einrichtung der Testumgebung
Zugriffsbeschränkungen (falls vorhanden)
Testkonten sollten folgende Eigenschaften haben:
Zugriff auf alle überprüften Tools
Repräsentative Beispieldaten
Angemessene Berechtigungen für vollständiges Funktionalitätstesten
Aktiver Status während und nach der Überprüfungsphase
Bereitstellung:
Anmeldedaten im Einreichungsformular einfügen (idealerweise über sichere Methode wie 1Password-Link)
Sicherstellen, dass Konten während und nach der Überprüfung aktiv bleiben für regelmäßige Überprüfungen nach der Zulassung
Ausreichenden Zugriff für umfassendes Testen bereitstellen
Ist OAuth 2.0 erforderlich?
JA - Falls Ihr Server Authentifizierung erfordert.
OAuth-Implementierungsanforderungen:
Muss OAuth 2.0 Authorization Code Flow verwenden
Zertifikate von anerkannten Behörden
Whitelist lokaler MCP-Client-Callback-URLs (z. B. Claude Code, MCP Inspector):
Whitelist Claude-Callback-URLs:
Ordnungsgemäße Redirect-URI-Konfiguration
Häufige OAuth-Probleme, die zu vermeiden sind:
Ungültige Redirect-URI-Fehler (stellen Sie sicher, dass beide Callback-URLs auf der Whitelist stehen)
HEAD-Anfragen ohne Token (nach OAuth-Flow ordnungsgemäß verarbeiten)
Implementierungsleitfaden: Siehe OAuth 2.0 Authorization Framework für vollständige OAuth-Implementierungsdetails.
Gibt es Firewall-Anforderungen?
JA - Muss Claudes IP-Adressen für claude.ai-Kompatibilität auf die Whitelist setzen
Für Server hinter Firewalls müssen IP-Adressen von https://docs.claude.com/en/api/ip-addresses auf die Whitelist gesetzt werden.
Erforderlich für: Claude.ai und Claude Desktop
Nicht erforderlich für: Claude Code (verbindet sich direkt vom Benutzercomputer)
Wichtig: IP-Whitelisting allein wird nicht als Sicherheitsmaßnahme empfohlen. Verwenden Sie OAuth 2.0 zur Authentifizierung, wenn möglich.
Welche Dokumentation ist erforderlich?
Umfassende Server-Dokumentation mit spezifischen Abschnitten.
Empfohlene Abschnitte:
Server-Beschreibung - Klare Erklärung, was Ihr Server tut
Funktionen - Wichtigste Fähigkeiten und Anwendungsfälle
Einrichtungsanweisungen - Wie Benutzer sich verbinden und konfigurieren
Authentifizierung - OAuth-Einrichtung und Anforderungen (falls zutreffend)
Verwendungsbeispiele - Mindestens 3 funktionierende Beispiele mit Prompts (erforderlich)
Datenschutzrichtlinie - Link zur vollständigen Datenschutzrichtlinie
Support - Wie Benutzer Hilfe erhalten oder Probleme melden können
Beispiel-Dokumentationsstruktur:
# [Ihr Service-Name] MCP Server
## Beschreibung
[Kurze Beschreibung der Service-Integration und Fähigkeiten]
## Funktionen
- Funktion 1: [Beschreibung und Wert]
- Funktion 2: [Beschreibung und Wert]
- Funktion 3: [Beschreibung und Wert]
## Einrichtung
1. Besuchen Sie das [Anthropic MCP Directory](https://claude.com/connectors)
2. Suchen und verbinden Sie sich mit [Ihr Service]
3. Schließen Sie die OAuth-Authentifizierung ab
4. Konfigurieren Sie alle erforderlichen Einstellungen
## Authentifizierung
Dieser Server erfordert OAuth-Authentifizierung. Sie benötigen:
- Gültiges [Ihr Service]-Konto
- [Alle spezifischen Berechtigungen oder Kontotypen]
## Beispiele
[Siehe Abschnitt mit mindestens 3 Beispielen unten]
## Datenschutzrichtlinie
Siehe unsere Datenschutzrichtlinie: https://your-domain.com/privacy
## Support
- E-Mail: [email protected]
- Dokumentation: https://your-domain.com/mcp-docs
- Probleme: https://github.com/yourcompany/mcp-server/issues
Wie viele Verwendungsbeispiele sind erforderlich?
MINDESTENS drei funktionierende Beispiele, die die Kernfunktionalität demonstrieren.
Was als gutes Beispiel gilt:
Zeigt realistische Benutzer-Prompt/Anfrage
Demonstriert tatsächliche Server-Funktionalität
Enthält erwartete Ausgabe oder Verhalten
Klarer und verständlicher Workflow
Deckt verschiedene Fähigkeiten ab
Beispielformat:
## Beispiele
### Beispiel 1: Dokumente durchsuchen
**Benutzer-Prompt:** "Finde aktuelle Projektberichte in meinem Workspace"
**Was passiert:**
- Server durchsucht Ihren Workspace
- Gibt übereinstimmende Dokumente mit Metadaten zurück
- Bietet schnelle Zugrifflinks
### Beispiel 2: Neuen Inhalt erstellen
**Benutzer-Prompt:** "Erstelle eine neue Aufgabenliste für die Marketingkampagne"
**Was passiert:**
- Server erstellt neue Aufgabenliste
- Fügt basierend auf Kontext eine anfängliche Struktur hinzu
- Gibt Link zur neu erstellten Liste zurück
### Beispiel 3: Vorhandene Daten aktualisieren
**Benutzer-Prompt:** "Aktualisiere den Projektstatus auf 'In Bearbeitung' und füge den heutigen Meilenstein hinzu"
**Was passiert:**
- Server lokalisiert das Projekt
- Aktualisiert das Statusfeld
- Fügt Meilenstein mit aktuellem Datum hinzu
- Bestätigt vorgenommene Änderungen
Anforderungen:
Mindestens 3 Beispiele (kein Maximum)
Decken verschiedene Tools/Fähigkeiten ab
Zeigen realistische Benutzerinteraktionen
Demonstrieren Wertversprechen
In Server-Dokumentation enthalten
Welche Anforderungen für Produktionsreife gibt es?
Server muss im Status General Availability (GA) sein.
Produktionsreife bedeutet:
Server ist stabil und zuverlässig in der Produktion
Nicht als "beta", "alpha" oder "development" gekennzeichnet
Alle Funktionen vollständig implementiert und getestet
Ordnungsgemäße Fehlerbehandlung und elegante Ausfallsicherung
Skalierbare Infrastruktur und Überwachung
Vollständige Dokumentation und Support-Kanäle
Kann nicht enthalten sein: Beta-Versionen, Entwicklungsserver oder Services mit eingeschränktem Zugriff.
Welche technischen Anforderungen müssen erfüllt sein?
Muss die Kern-Compliance-Standards erfüllen.
Transport und Leistung:
Muss Streamable HTTP-Transport unterstützen (SSE-Unterstützung kann veraltet sein)
Schnelle Antwortzeiten mit hoher Verfügbarkeit
Elegante Fehlerbehandlung mit hilfreichen Meldungen
Token-effiziente Antworten (max. 25.000 Token pro Tool-Ergebnis)
Sicherheit und Daten:
HTTPS/TLS mit gültigen Zertifikaten
CORS ordnungsgemäß für Browser-Clients konfiguriert
Unterstützung für alle erforderlichen Claude-Client-Origins
Erfassung nur notwendiger Daten für Funktionalität
Keine Erfassung zusätzlicher Konversationsdaten
Datenschutzkonforme Datenpraktiken
3. Einreichungsprozess
Wie reiche ich meinen Remote-MCP-Server ein?
Folgen Sie diesem schrittweisen Einreichungsprozess:
1. Checkliste vor der Einreichung:
Überprüfen Sie obligatorische Anforderungen:
[ ] Alle Tools haben readOnlyHint ODER destructiveHint Anmerkungen
[ ] OAuth 2.0 implementiert (falls Authentifizierung erforderlich)
[ ] Server über HTTPS zugänglich
[ ] Claudes IP-Adressen auf Whitelist (falls Server hinter Firewall)
[ ] Umfassende Dokumentation veröffentlicht
[ ] Datenschutzrichtlinie veröffentlicht und zugänglich
[ ] Dedizierte Support-Kanäle (E-Mail oder Web)
[ ] Testkonto bereit (falls Authentifizierung erforderlich)
[ ] Server ist produktionsreif (GA-Status)
Testen Sie Ihren Server:
[ ] Funktioniert korrekt von Claude.ai
[ ] Funktioniert korrekt von Claude Desktop
[ ] Funktioniert korrekt von Claude Code (falls keine IP-Beschränkungen)
[ ] OAuth-Flow wird erfolgreich abgeschlossen
[ ] Alle Tools funktionieren wie dokumentiert
[ ] Fehlermeldungen sind hilfreich und benutzerfreundlich
[ ] Leistung ist unter Last akzeptabel
2. Einreichungsformular ausfüllen:
Einreichungsformular: MCP Directory Server Review Form
Erforderliche Informationen: Server-Details, Dokumentations-Links, Test-Anmeldedaten, Beispiele (mindestens 3) und Kontaktinformationen. Das Formular bietet eine vollständige Liste.
Obwohl wir uns bemühen, jede Einreichung so schnell wie möglich zu überprüfen, können wir aufgrund des großen Interesses nicht garantieren, dass wir Ihre Einreichung akzeptieren oder einzeln beantworten.
4. Häufige Probleme
Was sind die häufigsten Gründe für Überarbeitungsanfragen?
Dies sind die Top-Probleme basierend auf Einreichungsdaten:
1. Fehlende Tool-Anmerkungen
Problem: Tools fehlen erforderliche Sicherheitsanmerkungen
Lösung: Fügen Sie readOnlyHint oder destructiveHint zu ALLEN Tools hinzu
Auswirkung: Sofortige Ablehnung, erfordert Code-Änderungen
Prävention: Validieren Sie alle Tools vor der Einreichung
2. OAuth-Implementierungsprobleme
Problem: OAuth-Flow schlägt fehl oder hat Konfigurationsfehler
Häufige Ursachen:
Fehlende Callback-URLs im OAuth-Provider
Ungültige Redirect-URI-Konfiguration
Firewall-Fehlkonfiguration
Lösung: Testen Sie OAuth-Flow gründlich mit MCP Inspector, Claude Code oder Claude.ai
Auswirkung: Funktionales Testen kann nicht abgeschlossen werden, verzögert Genehmigung
3. Unvollständige Dokumentation
Problem: Fehlende Beispiele, unklar Einrichtungsanweisungen oder fehlende erforderliche Abschnitte
Lösung: Geben Sie mindestens 3 detaillierte Beispiele und füllen Sie alle Dokumentations