Dieser Leitfaden hilft Ihnen beim Erstellen eines MCP-Bundles (.mcpb), um eine Desktop-Erweiterung für den internen Gebrauch, die private Verteilung oder als Grundlage für die Einreichung im Anthropic Connectors Directory zu erstellen.
1. Einführung
Was ist ein MCPB?
MCPB-Dateien (.mcpb) sind Zip-Archive, die einen lokalen MCP-Server und eine manifest.json enthalten. Sie ermöglichen die Installation mit einem Klick in Claude Desktop, ähnlich wie Browser-Erweiterungen.
Hauptmerkmale:
Läuft lokal auf dem Rechner des Benutzers
Kommuniziert über stdio-Transport
Bündelt alle Abhängigkeiten
Funktioniert offline
Kein OAuth erforderlich
Mehr erfahren:
MCPB Repository - Vollständige Spezifikation und Architektur
Desktop Extensions Blog-Beitrag - Überblick und Anwendungsfälle
Wann sollte ich einen lokalen Server (MCPB) vs. einen Remote-Server verwenden?
Wählen Sie einen lokalen Server (MCPB) für:
Interne Systeme und Sicherheit
Zugriff auf Systeme hinter Ihrer Firewall (JIRA, Confluence, interne Wikis, private Datenbanken)
Nahtlose Authentifizierung - Verwendet automatisch vorhandenes SSO und Browser-Sitzungen, keine Token-Verwaltung
Zero-Trust-Compliance - Arbeitet innerhalb Ihrer Unternehmensnetzwerkgrenzen, ohne interne Ressourcen öffentlich zugänglich zu machen
Lokale Ressourcen
Direkter Dateisystemzugriff für Code-Bearbeitung und Git-Operationen
Integration mit lokal installierten Tools (Docker, IDEs, Datenbanken)
Hardware-Integration und Desktop-Anwendungssteuerung
Datenschutzsensible Operationen, die den Rechner des Benutzers nicht verlassen sollten
Unternehmensbereitstellung
Installation mit einem Klick mit integrierter Node.js-Laufzeitumgebung (keine zu verwaltenden Abhängigkeiten)
Keine Cloud-Infrastruktur, VPN-Konfigurationen oder Firewall-Regeln erforderlich
Kontrollen auf Organisationsebene - Administratoren können benutzerdefinierte Erweiterungen hochladen und den Zugriff über Zulassungslisten verwalten
Vollständige Kontrolle über Authentifizierung, Autorisierung und Audit-Protokolle
Wählen Sie einen Remote-Connector für:
Cloud-Dienste und öffentliche APIs, die eine zentralisierte Infrastruktur erfordern
Verteilung über Claude im Web, auf Mobilgeräten und Desktop
Dienste, die zentralisierte Updates für alle Benutzer benötigen
OAuth-Flows, die serverseitige Token-Verwaltung erfordern
Öffentlich zugängliche Integrationen, die von mehreren Organisationen genutzt werden
Hauptunterschied: MCPBs laufen auf dem Rechner des Benutzers über stdio-Transport mit Zugriff auf lokale und interne Ressourcen. Remote-Connectors laufen auf Ihren Servern über HTTPS und werden über die Infrastruktur von Anthropic aufgerufen.
Praxiseinsatz: Organisationen erstellen MCPBs als sichere Proxys zu internen MCP-Servern, für den Zugriff auf interne Dokumentation und zur Verbindung von Entwicklungstools unter Beibehaltung ihrer Sicherheitsarchitektur.
Für Remote-Connector-Anleitungen: Siehe MCP Partner FAQ für vollständige Remote-Connector-Dokumentation.
2. Erste Schritte
Welche Programmiersprache sollte ich verwenden?
Node.js wird dringend empfohlen, weil:
Es mit Claude für macOS und Windows ausgeliefert wird (keine Installationsreibung für Benutzer)
Benutzer keine separate Laufzeitumgebung installieren müssen
Beste Kompatibilität und Zuverlässigkeit mit Claude Desktop
Umfangreiche MCP SDK-Unterstützung
Welche Plattformen sollte ich unterstützen?
Claude Desktop läuft auf:
macOS (darwin)
Windows (win32)
Geben Sie die unterstützten Plattformen im Kompatibilitätsabschnitt Ihrer manifest.json an.
Best Practice: Testen Sie auf beiden Plattformen, auch wenn Sie hauptsächlich auf einer entwickeln.
Details zur Plattformkompatibilität: Siehe MCPB Manifest Spec - Compatibility für Plattformspezifikation und Laufzeitanforderungen.
Wie erstelle ich mein erstes MCPB?
Folgen Sie diesem fünfstufigen Prozess:
1. MCPB CLI installieren: npm install -g @anthropic-ai/mcpb
2. Erstellen Sie Ihren MCP-Server (siehe MCP SDK)
3. Führen Sie mcpb init aus, um manifest.json zu erstellen
4. Führen Sie mcpb
