MCP

MCP Starter Kit Einstiegsleitfaden: Ihre Backend-API sicher mit AI-Agenten verbinden

MCP Starter Kit eignet sich am besten für Entwickler mit bestehender Backend-API, um schnell einen sicheren MCP-Server aufzubauen, den Claude oder ChatGPT aufrufen können – Voraussetzung sind TLS-Hosting sowie das eigenständige Ausfüllen von .env und die Implementierung der Tools.

Official source · GitHub - fdhhhdjd/MCP-STARTER-KIT: Build a secure, production-ready MCP server for any project

Install

npm install && npm run build

MCP Starter Kit ist ein projektagnostisches Scaffold, mit dem Sie für jedes Projekt einen sicheren, produktionsreifen MCP-Server (Model Context Protocol) aufbauen können: Jedes Tool wird auf einen Backend-Endpunkt abgebildet, die Authentifizierung erfolgt per API-Key + Scopes, und AI-Agenten (Claude Desktop/Web, ChatGPT oder selbstgebaute Agenten) werden mit Ihrer Backend-API verbunden. Wenn Sie lediglich fertige Tools ausprobieren möchten, ist es ungeeignet; es setzt eine eigene Backend-API, die Fähigkeit zum Hosting des Dienstes und die Bereitschaft voraus, den Build- und Deploy-Prozess zu durchlaufen.

Für wen geeignet

  • Entwickler, die ihre Backend-API sicher von Agenten wie Claude oder ChatGPT aufrufen lassen möchten.
  • Teams, die für jeden Endpunkt ein Tool benötigen und Berechtigungen per API-Key + Scopes steuern wollen; standardmäßig nur lesend, sofern kein Schreib-Scope explizit hinzugefügt wird.
  • Szenarien, die sowohl Online-Zugriff (Streamable HTTP, mehrere Clients) als auch Claude Desktop (stdio) benötigen, oder die zwischen zustandsloser OAuth 2.0 (PKCE S256) und Header-API-Key als Authentifizierung wählen möchten.
  • Nicht geeignet für: Nutzer ohne eigene Backend-API, ohne TLS-Hosting-Möglichkeiten oder ohne Bereitschaft, Code und Konfiguration anzupassen. Die offiziellen Quellen nennen keine Details zu Hosting-Kosten oder Laufzeitanforderungen – diese Unklarheiten müssen Sie selbst klären.

Erster Versuch in 3 Minuten

Für den ersten Versuch empfiehlt es sich, mit dem Build des Scaffolds selbst zu beginnen und die Verbindung herzustellen (der echte Endpunktaufruf erfolgt erst, nachdem Sie Ihre Tools konfiguriert haben):

  1. Voraussetzungen: Node/npm ist installiert; bereiten Sie eine TLS-fähige Domain vor (der Dienst muss hinter TLS gehostet werden, Pfad: /mcp).
  2. Folgen Sie dem Template-Pfad im README: Wechseln Sie in templates/, benennen Sie gitignore in .gitignore um, ersetzen Sie __PROJECT__ durch Ihren Projektnamen, füllen Sie .env aus und fügen Sie Ihre Tools in src/server.ts hinzu.
  3. Führen Sie den offiziell angegebenen Build-Befehl aus:
npm install && npm run build
  1. Hosten Sie den Dienst hinter TLS (Pfad /mcp), verbinden Sie sich dann per mcp-remote von Claude Desktop aus und verifizieren Sie einmal (die Verbindungsinitialisierung ist eine risikoarme Aktion; der Key wird beim initialize gegenüber dem Backend geprüft):
npx -y mcp-remote https://<domain>/mcp --header "Authorization: Bearer <key>"

Erfolgssignal: Der Client schließt initialize ab und die Key-Prüfung am Backend ist bestanden (laut offizieller Dokumentation werden nicht authentifizierte Anfragen bereits bei der Initialisierung blockiert). Für Claude Web verwenden Sie einen Custom Connector mit der URL /mcp und dem Header x-api-key. Hinweis: <domain> und <key> in den obigen Befehlen sind Platzhalter, die Sie durch echte Werte ersetzen müssen; das Eintragen von Schlüsseln in .env ist ein lokaler Schreibvorgang und keine nur-lesende Operation.

Anwendungsfälle

  1. Nur-lesende Backend-Endpunkte per Claude Desktop aufrufen: Nach Build und TLS-Hosting wie im Hauptpfad oben verbinden Sie sich in Claude Desktop über mcp-remote mit einem Bearer-Key zu /mcp. Da standardmäßig nur gelesen wird, lösen Aufrufe keine Schreibvorgänge im Backend aus, sofern Sie keinen Schreib-Scope explizit hinzufügen – dies ist das offiziell deklarierte Verhalten, bedeutet aber nicht null Risiko; der Key wird weiterhin gegenüber dem Backend geprüft und über mcp-remote übermittelt.
  2. Denselben Dienst über einen Claude Web Custom Connector einbinden: Konfigurieren Sie in Claude Web einen Custom Connector mit der URL /mcp und dem Header x-api-key. Bis zum Verbindungsaufbau lässt sich dies bestätigen; das konkrete Ausgabeformat eines Tools hängt davon ab, wie Sie es in src/server.ts implementieren – die offiziellen Quellen liefern kein konkretes Tool-Beispiel, eine weitergehende Vorhersage ist daher nicht möglich.

Nutzungsgrenzen

  • Lese-/Schreibverhalten: Das Template ist standardmäßig nur lesend; Schreibfähigkeit erfordert einen explizit hinzugefügten Scope. Schreibvorgänge sind Remote-Schreiboperationen – prüfen Sie vor der Ausführung die Nebenwirkungen.
  • Zugangsdaten: Die Authentifizierung erfolgt per API-Key (oder optional zustandslosem OAuth 2.0 PKCE S256); die Konfiguration wird in .env eingetragen und stellt lokale, sensible Daten dar.
  • Logging: Audit-Logs werden auf stderr ausgegeben, stdout bleibt für JSON-RPC reserviert – achten Sie beim Debuggen auf den Unterschied zwischen den Kanälen.
  • Grenzen der Sicherheitsmechanismen: Der Key wird beim initialize geprüft, um nicht authentifizierten Missbrauch zu blockieren; das Nur-Lese-Standardverhalten und die initialize-Prüfung bedeuten nur, dass keine Schreibvorgänge ausgeführt und Schlüssel geprüft werden – sie bedeuten nicht, dass keine Netzwerkzugriffe erfolgen oder andere Datenschutzgrenzen entfallen.
  • Unbestätigte Informationen: Die offiziellen Quellen beschreiben weder das genaue Konfigurationsdateiformat der einzelnen Clients noch die Hosting-Plattformanforderungen oder konkrete Beispiele für Endpunkt-/Tool-Implementierungen; dies müssen Sie vor der ersten Nutzung selbst im Repository nachschlagen und verifizieren.