Zum Hauptinhalt springen

Desktop-Erweiterungen mit MCPB erstellen

Diese Woche aktualisiert

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:


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

Hat dies deine Frage beantwortet?