Tools
Aktionen, die ein Client nach Nutzerfreigabe aufrufen kann.
Entwickler-Guide · aktualisiert 31.07.2026
MCP Server bauen: von der Idee bis zu Claude Code
Ein MCP Server macht eigene APIs, Dateien und Automationen für kompatible KI-Clients nutzbar. Hier bekommst du die kurze Entscheidungslogik für Python und TypeScript, die wichtigsten Sicherheitsgrenzen und eine Test-Checkliste.
Resources
Lesbare Datenquellen wie Dateien, Dokumente oder API-Antworten.
Prompts
Wiederverwendbare Vorlagen für klar definierte Arbeitsabläufe.
Die 5-Schritte-Checkliste
- 01
Use-Case und Vertrauensgrenze definieren
Schreibe zuerst auf, welche Daten gelesen und welche Aktionen ausgeführt werden dürfen. Ein kleines, klar begrenztes Tool ist sicherer und für Modelle verständlicher als ein universeller Admin-Zugang.
- 02
SDK und Projektstruktur wählen
Lege Python mit dem offiziellen MCP-Paket oder TypeScript mit dem offiziellen SDK an. Trenne Transport, Tool-Handler, Validierung und Konfiguration, damit der Server später leichter getestet und ausgetauscht werden kann.
- 03
Tools mit strikten Schemas beschreiben
Jedes Tool braucht einen eindeutigen Namen, eine konkrete Beschreibung und validierte Eingaben. Fehlermeldungen müssen für den Client verständlich sein und dürfen keine Geheimnisse enthalten.
- 04
Transport lokal oder remote wählen
Starte lokal mit stdio. Für einen Remote-Dienst nutze Streamable HTTP und plane Authentifizierung, HTTPS, Rate Limits, Timeout-Handling und Audit-Logs von Anfang an ein.
- 05
Mit Inspector und echtem Client testen
Teste Tool-Auflistung, gültige und ungültige Eingaben sowie Abbrüche. Verbinde erst danach Claude Code oder einen anderen MCP-Client und dokumentiere die Konfiguration für dein Team.
Python oder TypeScript?
Nimm Python, wenn deine Tools Datenverarbeitung, Skripte oder ML-Workflows verbinden. Nimm TypeScript, wenn dein Server eng an Node.js, Web-APIs oder eine bestehende JavaScript-Plattform gekoppelt ist. Der Transport ist eine Laufzeitentscheidung, kein Qualitätsmerkmal.
Sicherheits-Minimum
Keine freien Shell-Befehle, keine ungeprüften URLs und keine Secrets in Tool-Beschreibungen. Eingaben validieren, minimale Berechtigungen vergeben, Logs nach stderr oder in eine sichere Ablage schreiben und jede schreibende Aktion sichtbar bestätigen.
MCP, Automationen und Agenten gemeinsam bauen
In der FlowKI-Community diskutieren Entwickler ihre Server- Architektur, testen Tool-Schemas und verbinden MCP mit n8n, Claude Code und eigenen Automationen. Der Austausch ist kostenlos.
Häufige Fragen
Was ist ein MCP Server?
Ein MCP Server stellt einem kompatiblen KI-Client standardisierte Tools, Ressourcen oder Prompt-Vorlagen bereit. So kann ein Modell kontrolliert mit APIs, Dateien oder eigenen Automationen arbeiten.
Soll ich einen MCP Server mit Python oder TypeScript bauen?
Python ist ein guter Einstieg für Daten-, Automations- und API-Projekte. TypeScript passt besonders gut zu Node.js-Backends und bestehenden JavaScript-Toolchains. Beide offiziellen SDKs unterstützen die zentralen MCP-Konzepte.
Was ist der Unterschied zwischen stdio und Streamable HTTP?
stdio eignet sich für lokale Server, die ein Desktop- oder Coding-Tool direkt startet. Streamable HTTP ist für erreichbare Dienste und mehrere Clients gedacht. Für Produktion kommen zusätzlich Authentifizierung, Rate Limits und Logging hinzu.
Wie teste ich einen MCP Server?
Nutze den MCP Inspector, prüfe zuerst die Tool-Schemas und teste anschließend Fehlerfälle, Berechtigungen und ungültige Eingaben. Erst danach sollte der Server in Claude Code, Claude Desktop oder einen anderen Client eingetragen werden.