Dies ist ein vollständiger Leitfaden zur Einreichung Ihres lokalen Servers (MCPB) im öffentlichen Verzeichnis von Anthropic für breitere Verteilung und Auffindbarkeit.
Voraussetzungen
Bevor Sie diesen Leitfaden lesen, sollten Sie folgende Voraussetzungen erfüllen:
Ein funktionierender MCPB
Portabler Code mit Variablenersetzung
Gute Fehlermeldungen und Benutzererfahrung
Saubere, gebündelte Abhängigkeiten
Neu bei der MCPB-Entwicklung? Siehe zunächst Building MCPB Extensions. Für technische Best Practices (Tests, Fehlermeldungen, Portabilität) siehe MCPB Repository.
Hinweis: Dieser Leitfaden behandelt lokale MCP-Server. Für Remote-Desktop-Erweiterungen siehe Remote MCP Server Submission Guide.
1. Verzeichnisübersicht
Welche Vorteile bietet die Aufnahme in das Verzeichnis?
Auffindbarkeit und Vertrauen:
Aufgelistet im offiziellen Anthropic-Verzeichnis innerhalb von Claude Desktop
Durchsuchbar durch einzelne Claude Desktop-Benutzer
Sichtbar für Teams/Enterprise-Benutzer, wenn sie von Administratoren zur Zulassungsliste hinzugefügt werden
Anthropic-Überprüfung schafft Benutzervertrauen
Benutzererfahrung:
Installation mit einem Klick aus dem Verzeichnis
Integration mit Claude Desktop-Einstellungen-UI
Standardisierte Präsentation
Support und Glaubwürdigkeit:
Anthropic-Überprüfung von Qualität und Sicherheit
Aufgelistet neben anderen überprüften Erweiterungen
Sichtbarkeit in der Community und Feedback
Professioneller Verteilungskanal
2. Obligatorische Anforderungen
Alle Anforderungen in diesem Abschnitt sind obligatorisch für die Verzeichnisgenehmigung. Das Fehlen einer dieser Anforderungen führt zu einer Ablehnung oder einer Überarbeitungsanfrage.
Hinweis: Dies sind spezifische Anforderungen für das Anthropic-Verzeichnis.
Für allgemeine Best Practices bei der MCPB-Entwicklung (Tests, Fehlerbehandlung, Portabilität) siehe die MCPB Repository README.
Sind Tool-Annotationen erforderlich?
JA. Jedes Tool MUSS genaue Sicherheitsannotationen haben und diese beibehalten.
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 das vollständige Schema und Implementierungsdetails.
Nicht optional. Dies ist eine zwingende Anforderung aus der MCP Directory Policy.
So entscheiden Sie, welche Annotation zu verwenden ist:
Tool-Verhalten | Annotation | Beispiele |
Liest nur Daten | readOnlyHint: true | search, get, list, fetch, read |
Schreibt/ändert Daten | destructiveHint: true | create, update, delete, send, write |
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 |
Implementierungsdetails: Siehe MCP Protocol - Tools für:
Vollständiges Tool-Schema mit Annotationen
Tool-Definitionsstruktur
Eingabe-/Ausgabeschema-Spezifikationen
Zusätzliche Tool-Eigenschaften (einschließlich optionales Titelfeld)
Validierung vor der Einreichung:
# Überprüfen Sie, dass alle Tools Annotationen haben
grep -A 5 -B 5 "readOnlyHint\|destructiveHint" server/
# Überprüfen Sie, dass jedes Tool genau eine Annotation hat
Auswirkung: Das erste, das wir überprüfen, und der häufigste Grund für eine Überarbeitungsanfrage.
Zusätzliche empfohlene Annotation:
title - Benutzerfreundlicher Tool-Name für die UI-Anzeige (verbessert die Benutzererfahrung)
Sind Datenschutzrichtlinien erforderlich?
Ja, Datenschutzrichtlinien sind an zwei Stellen erforderlich:
Ort 1: README.md
Fügen Sie einen Abschnitt „Datenschutzrichtlinie" zu Ihrer README hinzu, mit einem Link zu Ihrer vollständigen Datenschutzrichtlinie, damit Benutzer Ihre Praktiken kennen:
## Datenschutzrichtlinie
Diese Erweiterung erfasst [Datentypen beschreiben]. Vollständige Datenschutzinformationen finden Sie in unserer Datenschutzrichtlinie: https://your-domain.com/privacy-policy
### Datenerfassung
- [Auflistung, welche Daten erfasst werden]
- [Wie sie verwendet werden]
- [Ob sie mit Dritten geteilt werden]
- [Aufbewahrungszeitraum]
Ort 2: manifest.json
Fügen Sie ein Array privacy_policies mit öffentlich zugänglichen HTTPS-URLs hinzu:
Vollständige Implementierung: Siehe MCPB Manifest Spec - Privacy Policies für:
Struktur des Datenschutzrichtlinien-Feldes
Manifest-Versionsanforderungen (0.3+)
Unterstützung mehrerer Richtlinien-URLs
Validierungsanforderungen
Datenschutzrichtlinie muss folgende Punkte abdecken:
Welche Daten Ihr MCPB erfasst
Wie Daten verwendet und gespeichert werden
Ob Daten mit Dritten geteilt werden
Richtlinien zur Aufbewahrung von Benutzerdaten
Kontaktinformationen für Datenschutzfragen
Anforderungen:
Muss öffentlich zugängliche HTTPS-URL sein
Muss von Ihrer Domain stammen (nicht von Drittanbieter-Hosting)
Muss aktuell und genau sein
Muss in README UND manifest.json vorhanden sein
Muss manifest_version „0.3" oder höher verwenden
Häufige Fehler:
Datenschutzrichtlinie in manifest, aber nicht in README
Datenschutzrichtlinie in README, aber nicht in manifest
Verwendung von manifest_version „0.2" oder älter
Ungültige oder nicht zugängliche URLs
Datenschutzrichtlinie auf Drittanbieter-Website gehostet
Auswirkung: Eine der häufigsten Ursachen für Ablehnung - einfach zu beheben, aber häufig übersehen.
Wie viele Beispiele sind erforderlich?
MINDESTENS drei funktionierende Beispiele, die die Kernfunktionalität demonstrieren.
Was als gutes Beispiel gilt:
Zeigt realistischen Anwendungsfall
Enthält erwartete Benutzereingabe/Aufforderung
Zeigt erwartete Ausgabe/Verhalten
Demonstriert tatsächliche Tool-Nutzung
Klarer und verständlicher Workflow
Beispielformat (in README.md):
## Beispiele
### Beispiel 1: Dateien suchen
**Benutzereingabe:** „Finde alle JavaScript-Dateien in meinem Projekt"
**Erwartetes Verhalten:**
- Erweiterung durchsucht Workspace-Verzeichnis
- Gibt Liste von .js-Dateien mit Pfaden zurück
- Zeigt Dateianzahl in Zusammenfassung
### Beispiel 2: Dateiinhalt lesen
**Benutzereingabe:** „Zeige mir den Inhalt von config.json"
**Erwartetes Verhalten:**
- Erweiterung liest config.json
- Gibt formatierten JSON-Inhalt zurück
- Behandelt fehlende Datei elegant
### Beispiel 3: Neue Datei erstellen
**Benutzereingabe:** „Erstelle eine neue Datei namens notes.txt mit 'Hello World'"
**Erwartetes Verhalten:**
- Erweiterung erstellt notes.txt
- Schreibt Inhalt in Datei
- Bestätigt Erstellung mit Dateipfad
Was einzubeziehen ist:
Realistische Benutzereingaben (wie Benutzer interagieren werden)
Erwartete Tool-Aufrufe (was hinter den Kulissen passiert)
Erwartete Ausgaben (was Benutzer sehen werden)
Fehlerbehandlungsbeispiele (optional, aber empfohlen)
Anforderungen:
Mindestens 3 Beispiele (kein Maximum)
Abdeckung der Kernfunktionalität
Zeige verschiedene Tools/Fähigkeiten
Demonstriere Wertversprechen
Einbeziehung in README.md
Auswirkung: Eine häufige Quelle für Verzögerungen oder Ablehnungen - Reviewer benötigen vollständige Dokumentation, um Einreichungen ordnungsgemäß zu bewerten.
Muss ich Test-Anmeldedaten bereitstellen?
Wenn Ihr MCPB Authentifizierung oder Zugriff auf externe Dienste erfordert, dann JA.
Erforderlich wenn:
Ihr MCPB sich mit externen APIs verbindet
Authentifizierung für Funktionalität erforderlich ist
Der MCPB-Benutzer ein Konto haben muss, um Funktionen zu nutzen
Integration mit externem Dienst vorhanden ist
Nicht erforderlich wenn:
Rein lokaler MCPB (nur Dateisystemoperationen)
Keine externen Verbindungen
Keine Authentifizierung erforderlich
Vollständig in sich geschlossen
Was bereitzustellen ist:
Test-Kontoanmeldedaten (Benutzername/Passwort oder API-Schlüssel)
Beispieldaten im Konto (hilfreich für Funktionstests)
Setup-Anweisungen (wie Test-Konto konfiguriert und verwendet wird)
Zugriffsbeschränkungen oder Einschränkungen (falls vorhanden)
Ablaufdatum des Kontos (falls temporär)
Wie bereitzustellen ist:
In Einreichungsformular einbeziehen
Bei hochsensiblen Daten über sichere Methode senden
Sicherstellen, dass Konto während Überprüfungszeitraum aktiv bleibt
Ausreichende Zugriffsstufe für vollständige Tests bereitstellen
Best Practice: Erstellen Sie ein separates Test-Konto, das von der Produktion getrennt ist, um:
Produktionsdaten nicht freizulegen
Zu kontrollieren, worauf Reviewer zugreifen können
Zugriff nach Genehmigung leicht zu widerrufen
Test-Konto-Nutzung zu verfolgen
Auswirkung: Verzögert Überprüfungsprozess, wenn erforderlich und fehlend
Welche Dokumentation ist erforderlich?
Umfassende Dokumentation in README.md mit erforderlichen Mindestabschnitten.
Erforderliche Mindestabschnitte:
Beschreibung - Klare Erklärung, was Ihr MCPB tut
Funktionen - Wichtigste Fähigkeiten und Anwendungsfälle
Installation - Wie man installiert (typischerweise: „Installation aus Anthropic-Verzeichnis")
Konfiguration - Erforderliche Einstellungen und Setup-Schritte
Verwendungsbeispiele - Mindestens 3 Beispiele (siehe obigen Abschnitt)
Datenschutzrichtlinie - Link zu vollständiger Datenschutzrichtlinie
Support - Wie Benutzer Hilfe erhalten oder Probleme melden können
Beispiel README.md-Struktur:
# Meine MCPB-Erweiterung
## Beschreibung
Kurze Beschreibung, was diese Erweiterung tut und warum sie nützlich ist.
## Funktionen
- Funktion 1: [Beschreibung]
- Funktion 2: [Beschreibung]
- Funktion 3: [Beschreibung]
## Installation
Installation aus dem Anthropic-Verzeichnis in Claude Desktop-Einstellungen → Erweiterungen.
## Konfiguration
1. Öffnen Sie Einstellungen → Erweiterungen → [Erweiterungsname]
2. API-Schlüssel hinzufügen (falls erforderlich)
3. Workspace-Verzeichnis auswählen
4. Optionale Einstellungen konfigurieren
## Beispiele
[Siehe Mindestens 3 Beispiele-Abschnitt oben]
## Datenschutzrichtlinie
Siehe unsere Datenschutzrichtlinie: https://your-domain.com/privacy
## Support
Bei Problemen oder Fragen: [email protected]
GitHub Issues: https://github.com/your-username/your-extension/issues
Zusätzliche empfohlene Abschnitte:
Fehlerbehebung - Häufige Probleme und Lösungen
Versionskompatibilität - Welche Claude Desktop-Versionen unterstützt werden
Änderungsprotokoll - Versionsverlauf und Änderungen
Beitragen - Wie andere beitragen können (für Open Source)
Best Practices:
Klare, prägnante Schreibweise
Screenshots (optional, aber sehr hilfreich)
Schritt-für-Schritt-Anweisungen
Links zu zusätzlichen Ressourcen
3. Einreichungsprozess
Wie reiche ich im Verzeichnis ein?
Bevor Sie im Verzeichnis einreichen, führen Sie diesen schrittweisen Einreichungsprozess durch:
1. Checkliste vor der Einreichung:
Testen Sie Ihren MCPB:
Besteht alle 4 Testphasen (Entwicklung, saubere Umgebung, plattformübergreifend, Claude Desktop)
Funktioniert in sauberer Umgebung ohne Entwicklungstools
Portabel über macOS und Windows
Abhängigkeiten aktuell und gebündelt
Fehlermeldungen sind hilfreich und umsetzbar
Leistung ist akzeptabel
Überprüfen Sie obligatorische Anforderungen:
Alle Tools haben readOnlyHint ODER destructiveHint-Annotationen
Datenschutzrichtlinie in README.md vorhanden
Datenschutzrichtlinie in manifest.json privacy_policies-Array vorhanden
Verwenden Sie die neueste Manifest-Version für beste Kompatibilität
Mindestens 3 funktionierende Beispiele in README dokumentiert
Test-Anmeldedaten bereitgestellt (falls zutreffend)
Dokumentation vorbereiten:
README.md vollständig mit allen erforderlichen Abschnitten
LICENSE-Datei enthalten
Symbol enthalten (empfohlen, 512×512px PNG)
CHANGELOG.md (optional, aber empfohlen)
2. Endversion verpacken:
# Sauberer Build
rm -rf node_modules/.cache
npm install --production
# Verpacken
mcpb pack
# Paket überprüfen
mcpb info your-extension.mcpb
3. Über offizielles Formular einreichen:
Einreichungsformular: https://forms.gle/tyiAZvch1kDADKoP9
Erforderliche Informationen: Server-Details, Dokumentations-Links, Test-Anmeldedaten, Beispiele (mindestens 3) und Kontaktinformationen. Das Formular bietet eine vollständige Liste.