MCP Server bauen mit Claude Code: Eigene Tools für KI 2026
Model Context Protocol: Eigene MCP-Server entwickeln, Tools definieren, Ressourcen bereitstellen —
KI-Agenten mit eigenen Datenbankzugriffen, APIs und internen Systemen ausstatten.
6. Mai 2026•11 min Lesezeit•Claude Code Mastery
Wer ernsthaft mit KI-Agenten arbeitet, stößt schnell an eine Grenze: Die Modelle wissen vieles,
aber sie kennen deine interne Datenbank nicht. Dein Monitoring-System. Deine Jira-Tickets. Deine proprietären APIs.
Genau hier setzt das Model Context Protocol (MCP) an — ein offener Standard, mit dem du
Claude und andere KI-Agenten mit eigenen Tools und Datenquellen ausstatten kannst.
In diesem Guide lernst du, wie du eigene MCP-Server mit TypeScript und dem offiziellen
@modelcontextprotocol/sdk baust und direkt in Claude Code integrierst. Wir gehen von
den Grundlagen bis zu produktionsreifen Patterns für Datenbankzugriffe, GitHub-Integration und interne Tools.
1. MCP Grundlagen & Architektur
Das Model Context Protocol wurde von Anthropic entwickelt und im November 2024 als Open-Source-Standard
veröffentlicht. Die Idee ist elegant: Anstatt jede KI-Anwendung mit eigenen API-Wrappern zu bauen,
gibt es ein standardisiertes Protokoll für die Kommunikation zwischen KI-Modellen und externen Systemen.
MCP ARCHITEKTUR
Claude Code (Host)
↔
MCP Client
↔
MCP Server (dein Code)
↓ stdio / HTTP+SSE Transport ↓
DatenbankExterne APIDateisystemInterne Tools
Die drei Kernkonzepte: Tools, Resources, Prompts
Ein MCP-Server kann drei Arten von Fähigkeiten bereitstellen. Je nach Anwendungsfall nutzt du
eine oder eine Kombination davon:
Tool Tools — Aktionen ausführen
Tools sind Funktionen, die Claude aufrufen kann, um Aktionen in der Welt durchzuführen.
Datenbankabfragen, API-Aufrufe, Dateien schreiben, Code ausführen. Das Modell übergibt
Parameter, der MCP-Server führt die Aktion aus und gibt das Ergebnis zurück.
Datenbankabfragen (SELECT, INSERT, UPDATE)
REST-API-Aufrufe (GitHub, Jira, Stripe, ...)
Shell-Befehle und Skripte ausführen
E-Mails senden, Kalendereinträge erstellen
Resource Resources — Daten bereitstellen
Resources sind Datenquellen, die Claude lesen kann — ähnlich wie GET-Endpunkte in einer REST-API.
Sie haben URIs wie db://users/123 oder file://config.yaml und liefern
Inhalte, die Claude in seinen Kontext laden kann.
Datenbankeinträge und Tabellenschemas
Konfigurationsdateien und Dokumentation
Logs und Monitoring-Daten
Produktkataloge und interne Wissensdatenbanken
Prompt Prompts — Wiederverwendbare Templates
Prompts sind vordefinierte Prompt-Templates mit Parametern, die Claude nutzen kann.
Sie ermöglichen konsistente Workflows für wiederkehrende Aufgaben.
Code-Review-Templates für bestimmte Sprachen
Commit-Message-Generierung nach eigenem Standard
Incident-Analyse-Workflows
Onboarding-Sequenzen für neue Mitarbeiter
stdio vs. HTTP Transport
Eigenschaft
stdio Transport
HTTP+SSE Transport
Einsatz
Lokale Development-Tools
Remote-Services, Teams
Deployment
Als lokaler Prozess
Als Web-Service
Latenz
Sehr gering (lokal)
Netzwerk-abhängig
Multi-User
Nur ein Client
Mehrere Clients
Sicherheit
Kein Netzwerk
HTTPS + Auth nötig
Einstieg
Sehr einfach
Mehr Aufwand
Empfehlung für den Start: Beginne immer mit stdio Transport. Du kannst später
auf HTTP wechseln, wenn du den Server im Team teilen oder remote betreiben möchtest.
Für die meisten Entwickler-Workflows reicht stdio vollkommen aus.
2. Erster MCP Server in TypeScript
Der schnellste Weg zum ersten MCP-Server. Wir brauchen nur das offizielle SDK und ein paar Zeilen TypeScript.
Die Lernkurve ist überraschend flach — in 15 Minuten läuft dein erster Server.
# TypeScript kompilieren
npm run build
# Manueller Test: JSON-RPC-Request per stdin senden
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node dist/index.js
Erwartete Ausgabe: Du siehst eine JSON-Antwort mit dem echo-Tool in der Liste.
Das bedeutet: Dein Server läuft und kommuniziert korrekt über stdio.
3. Tools definieren mit Zod-Schemas
Einfache Tools sind der Einstieg — aber in echten Projekten brauchst du komplexere Input-Validierung,
Fehlerbehandlung und mehrere Tools in einem Server. Zod ist hier das Werkzeug der Wahl:
Es liefert TypeScript-Typen und Runtime-Validierung in einem.
Claude entscheidet anhand der Beschreibungen, welches Tool für welche Aufgabe geeignet ist.
Schlechte Beschreibungen führen zu falschem Tool-Einsatz. Jeder Parameter braucht ein
.describe() mit konkreter Erklärung.
❌ Don't: Fehler werfen
Tools sollten niemals unkontrolliert Errors werfen. Nutze immer
{ content: [...], isError: true } als Rückgabewert.
So kann Claude den Fehler lesen und sinnvoll reagieren, anstatt abzubrechen.
4. Ressourcen bereitstellen
Während Tools Aktionen ausführen, stellen Resources Daten bereit, die Claude in seinen
Kontext laden kann. Das ist ideal für Datenbankschemas, Dokumentation oder Konfigurationen,
die Claude kennen muss, um sinnvolle Tool-Aufrufe zu machen.
Der fertige MCP-Server nützt nichts, solange er nicht in Claude Code eingebunden ist. Das geht
über die Datei .claude/settings.json im Projektverzeichnis — oder global
für alle Projekte.
# MCP-Server zu Claude Code hinzufügen (lokal, für das Projekt)
claude mcp add mein-mcp-server -- node /pfad/zu/dist/index.js
# Global hinzufügen (-s user)
claude mcp add -s user mein-mcp-server -- node /pfad/zu/dist/index.js
# Mit Umgebungsvariablen
claude mcp add mein-mcp-server \
-e DATABASE_URL=postgresql://localhost/mydb \
-- node /pfad/zu/dist/index.js
# Liste aller konfigurierten MCP-Server
claude mcp list
# Status prüfen
claude mcp get mein-mcp-server
Test in Claude Code
Sobald Claude Code neu gestartet wird, stehen die Tools zur Verfügung. Du kannst
direkt in natürlicher Sprache testen:
💬 Beispiel-Prompts zum Testen
“Suche alle aktiven Benutzer mit der E-Mail @example.com”
“Erstelle einen neuen Benutzer: Max Muster, max@example.com, Rolle: admin”
“Lies das Datenbankschema und erkläre die Tabellenstruktur”
“Führe ein Security-Review für diese TypeScript-Datei durch”
Wichtig: Nach jeder Änderung am MCP-Server-Code muss der Server neu kompiliert
(npm run build) und Claude Code neu gestartet werden. Der Server-Prozess wird bei
jedem Claude-Code-Start frisch gestartet.
6. Praktische Beispiele & Patterns
Hier sind vier produktionsreife MCP-Server-Patterns, die in realen Projekten bewährt sind.
Jedes Lösungsmuster zeigt die Kernlogik — die Integration in die Server-Instanz funktioniert
wie in den Abschnitten zuvor beschrieben.
Direkt per node dist/index.js gestartet. Claude Code managed den Prozess automatisch.
Kein Netzwerk nötig, maximale Performance.
2
npm-Package — Team-Distribution
MCP-Server als privates npm-Package veröffentlichen. Andere Entwickler nutzen dann
npx @company/mcp-server als Command in ihrer Claude-Code-Konfiguration.
3
Docker + HTTP — Produktion
MCP-Server als HTTP-Service deployen. Mehrere Entwickler teilen sich eine Instanz.
Ideal für Datenbankzugriffe mit Connection-Pooling.
4
Cloudflare Workers — Serverless
HTTP-MCP-Server als Cloudflare Worker deployen. Kein eigener Server nötig,
globale Verteilung, kostenloser Tier für kleine Teams.
Praxis-Tipp: Starte immer lokal (stdio), bis du den Server produktiv nutzt.
Die Umstellung auf HTTP ist später mit dem @modelcontextprotocol/sdk-HTTP-Adapter
möglich, ohne die Tool-Definitionen zu ändern. Nur der Transport wechselt.
Fazit: MCP als Multiplikator für KI-Produktivität
MCP-Server sind kein akademisches Konzept — sie sind der praktische Weg, Claude von einem
allgemeinen Assistenten zu einem Experten für dein spezifisches System zu machen. Ein gut
entwickelter MCP-Server, der auf deine Datenbankstruktur, deine APIs und deine internen Workflows
zugeschnitten ist, multipliziert die Produktivität von Entwicklern sprunghaft.
Die Einstiegskosten sind gering: Das @modelcontextprotocol/sdk ist ausgezeichnet
dokumentiert, Zod macht Typ-Sicherheit einfach, und die Integration in Claude Code geht in wenigen
Minuten. Die wichtigsten Lernpunkte aus diesem Guide:
Tools für Aktionen, Resources für Daten, Prompts für Workflows — jedes Konzept hat seinen Platz
Fehler nie werfen — immer isError: true mit erklärendem Text zurückgeben
Zod-Validierung ist sowohl Dokumentation als auch Sicherheits-Layer
Beschreibungen sind entscheidend — Claude wählt Tools anhand der Beschreibung
stdio first — einfachster Einstieg, später auf HTTP migrieren wenn nötig
KI-Agenten mit eigenen Tools ausstatten?
Starte mit SpockyMagicAI — entdecke, wie KI-Automatisierung dein Team
mit mageschneiderten MCP-Servern, Claude Code und modernen Agentic-Workflows voranbringt.