Diese Anleitung hilft Ihnen beim Erstellen eines MCP Bundle (.mcpb), um eine Desktop-Erweiterung für die interne Nutzung, private Verteilung oder als Grundlage für die Einreichung bei Anthropic's Connectors Directory zu erstellen.

1. Einführung

Was ist ein MCPB?

MCPB (.mcpb) Dateien sind ZIP-Archive, die einen lokalen MCP-Server und manifest.json enthalten. Sie ermöglichen die Installation mit einem Klick in Claude Desktop, ähnlich wie Browser-Erweiterungen.

Wichtigste Merkmale:

Läuft lokal auf dem Computer des Benutzers
Kommuniziert über stdio-Transport
Bündelt alle Abhängigkeiten
Funktioniert offline
Kein OAuth erforderlich

Weitere Informationen:

MCPB Repository - Vollständige Spezifikation und Architektur
Desktop Extensions Blog Post - Übersicht und Anwendungsfälle

Wann sollte ich einen lokalen Server (MCPB) statt eines Remote-Servers 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 - Nutzt automatisch vorhandene SSO und Browser-Sitzungen, keine Token-Verwaltung erforderlich
Zero-Trust-Compliance - Läuft innerhalb Ihrer Unternehmensnetzwerkgrenzen, ohne interne Ressourcen öffentlich freizulegen

Lokale Ressourcen

Direkter Dateisystem-Zugriff für Code-Bearbeitung und Git-Operationen
Integration mit lokal installierten Tools (Docker, IDEs, Datenbanken)
Hardware-Integration und Desktop-Anwendungssteuerung
Datenschutzsensitive Operationen, die den Computer des Benutzers nicht verlassen sollten

Enterprise-Bereitstellung

Installation mit einem Klick mit integrierter Node.js-Laufzeit (keine Abhängigkeiten zu verwalten)
Keine Cloud-Infrastruktur, VPN-Konfigurationen oder Firewall-Regeln erforderlich
Kontrollen auf Organisationsebene - Administratoren können benutzerdefinierte Erweiterungen hochladen und den Zugriff über Allowlists verwalten
Vollständige Kontrolle über Authentifizierung, Autorisierung und Audit-Protokolle

Wählen Sie einen Remote-Connector für:

Cloud-Services und öffentliche APIs, die zentrale Infrastruktur erfordern
Verteilung über Claude im Web, auf Mobilgeräten und Desktop
Services, die zentrale Updates für alle Benutzer benötigen
OAuth-Flows, die serverseitige Token-Verwaltung erfordern
Öffentlich zugängliche Integrationen, die von mehreren Organisationen verwendet werden

Wichtiger Unterschied: MCPBs laufen auf dem Computer des Benutzers über stdio-Transport mit Zugriff auf lokale und interne Ressourcen. Remote-Connectors laufen auf Ihren Servern über HTTPS und werden über Anthropic's Infrastruktur aufgerufen.

Praktische Anwendung: Organisationen erstellen MCPBs als sichere Proxys zu internen MCP-Servern, für Zugriff auf interne Dokumentation und zum Verbinden von Entwicklungstools, während sie ihre Sicherheitsarchitektur beibehalten.

Für Remote-Connector-Anleitung: 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:

Mit Claude für macOS und Windows ausgeliefert wird (keine Installationshürden für Benutzer)
Benutzer keine separate Laufzeit-Installation benötigen
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 unterstützte 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. Installieren Sie MCPB CLI: 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 pack aus, um zu bündeln

5. Installieren und testen Sie in Claude Desktop

Für detaillierte Implementierungsanleitung:

MCPB Repository - Vollständige Anleitung für erste Schritte, CLI-Verwendung und Spezifikationen
MCPB Examples - Funktionierende Referenzimplementierungen einschließlich "Hello World"
MCP SDK - Kern-Protokollimplementierung

Für umfassende Anleitung zu Entwicklung, Tests und Best Practices siehe den Abschnitt "For Bundle Developers" in der MCPB README.

Wichtig: Bevor Sie Ihr MCPB verteilen, überprüfen Sie die Test- und Best-Practice-Anleitung in der MCPB README, um Qualität zu gewährleisten.

3. Konfiguration

Was ist manifest.json?

Die manifest.json Datei ist erforderliche Metadaten, die Ihr MCPB beschreiben - was es tut, wie es ausgeführt wird, welche Tools es bereitstellt und welche Konfiguration es benötigt.

Für die aktuellsten Informationen beachten Sie bitte die offizielle MCPB-Spezifikation.

MCPB Manifest Spec - Vollständiges Schema mit allen Feldern
Example Manifests - Praktische Implementierungen
CLI Documentation - Befehlsreferenz

Wie füge ich ein Symbol hinzu?

Symbole sind optional, aber für ein professionelles Aussehen empfohlen.

Grundlegender Ansatz: Fügen Sie eine icon.png Datei in Ihr Bundle-Stammverzeichnis ein und referenzieren Sie sie in manifest.json.

Anforderungen:

Dateiname: icon.png (oder benutzerdefinierter Pfad)
Größe: 512×512px empfohlen (Minimum 256×256px)
Format: PNG mit Transparenzunterstützung
Speicherort: Bundle-Stammverzeichnis oder angegebener Pfad

Erweiterte Optionen: Mehrere Symbol-Varianten für verschiedene Größen und Designs (Unterstützung für Hell-/Dunkelmodus).

Implementierungsdetails: Siehe MCPB Manifest Spec - Icons für:

Icon-Feldkonfiguration
Syntax für mehrere Symbol-Varianten
Größen- und Design-Spezifikationen
Best Practices und Anforderungen

Wie konfigurieren Benutzer mein MCPB?

Definieren Sie den Abschnitt user_config in manifest.json. Claude Desktop erstellt automatisch eine Einstellungs-UI, in der Benutzer Ihre Erweiterung konfigurieren können.

Siehe MCPB Manifest Spec - User Configuration für die vollständige Implementierung:

Vollständiges Schema und Beispiele
Alle Konfigurationstypen und Eigenschaften
Validierungsbeschränkungen
Umgang mit sensiblen Daten
Multi-Select-Muster

Wie installieren Benutzer mein MCPB?

Es gibt drei verschiedene Installationsmethoden:

Doppelklick - Laden Sie die .mcpb Datei herunter und doppelklicken Sie, um sie zu öffnen
Drag-and-Drop - Ziehen Sie die .mcpb Datei in das Claude Desktop Fenster
Dateimenü - Entwickler → Erweiterungen → Erweiterung installieren → .mcpb Datei auswählen

Alle Methoden öffnen die Installations-UI, in der Benutzer können:

Erweiterungsdetails und Berechtigungen überprüfen
Erforderliche Einstellungen konfigurieren
Notwendige Berechtigungen erteilen
Installation abschließen

Installationsumfang: Pro-Benutzer-Installation - jeder Benutzer muss separat auf seinem eigenen System installieren.

Benutzererfahrung und Admin-Kontrollen: Für detaillierte Informationen über die End-Benutzer-Installationserfahrung und Enterprise-Admin-Kontrollen (einschließlich Team-/Enterprise-Organisationsverwaltung und Richtlinienkonfiguration) siehe:

Getting Started with Local MCP Servers on Claude Desktop - Vollständiger Benutzerhandbuch mit Verzeichnisbrowsing, Installations-UI, Fehlerbehebung und Admin-Kontrollen.

4. Ressourcen

Offizielle Dokumentation

MCPB Framework:

MCPB Repository - Vollständige Spezifikation und Tools
MCPB Manifest Spec - Vollständiges Manifest-Schema
MCPB CLI Documentation - Befehlszeilentool-Referenz
MCPB Examples - Referenzimplementierungen

MCP Protokoll:

MCP Specification - Protokolldokumentation
MCP Quickstart - Anleitung für erste Schritte
TypeScript SDK - Node.js Implementierung
Python SDK - Python Implementierung

Claude Desktop:

Release Notes - Versionsaktualisierungen
Desktop Extensions Blog - Architekturübersicht

Hilfe erhalten

Support-Kanäle:

MCPB GitHub Issues - Fehlerberichte und Feature-Anfragen
MCP Specification - Protokollfragen
Claude Support - Allgemeiner Claude Desktop Support

Community-Ressourcen:

Überprüfen Sie Repository-Diskussionen für Community-Q&A
Folgen Sie Release Notes für die neuesten Updates
Überprüfen Sie Beispiele für Implementierungsmuster

Bereit für öffentliche Verteilung?

Wenn Sie ein funktionierendes MCPB erstellt haben und es im Anthropic Directory zur breiteren Verteilung und Auffindbarkeit einreichen möchten, siehe unseren Begleitleitfaden: Submitting to Anthropic Directory.

Der Directory-Leitfaden behandelt zusätzliche Anforderungen, einschließlich: