Der Moment, in dem MCP klickt: Nicht mehr Daten zu Claude tragen, sondern Claude zu den Daten lassen. Ein eigener Server dafür ist kleiner, als der Name vermuten lässt – im Kern sind es ein paar Funktionen mit einer Beschreibung.
Was am Ende läuft
Du fragst im Chat „Welche Tickets im Projekt X sind seit über zwei Wochen offen?” und bekommst eine Antwort aus eurem System. Kein CSV-Export, kein Kopieren, keine Daten bei einem Dritten.
Schritt 1 – Eine Frage, nicht zehn
Der häufigste Fehler ist, gleich eine ganze API abzubilden. Fang mit einer Frage an, die du oft stellst. Der Server bekommt genau ein Werkzeug dafür.
Ein Werkzeug, das gut funktioniert, ist mehr wert als zwölf, die halb funktionieren – und es zeigt dir in einer Stunde, ob der Weg trägt.
Schritt 2 – Die Beschreibung ist der eigentliche Code
Bei MCP entscheidet nicht die Funktion, ob Claude sie richtig nutzt, sondern ihre Beschreibung. Sie ist das, was das Modell liest.
Schlecht: "Holt Tickets."
Gut: "Liefert offene Tickets eines Projekts, sortiert nach Alter.
Nutze dies für Fragen nach Rückständen oder Liegezeiten.
Nicht geeignet für geschlossene Tickets — dafür gibt es
ticket_history."Der Satz, wofür ein Werkzeug nicht gedacht ist, verhindert die meisten Fehlgriffe. Er kostet zehn Sekunden und spart eine Stunde Verwunderung.
Schritt 3 – Erst im Inspector, dann in Claude
Prüfe den Server mit dem MCP Inspector, bevor du ihn einbindest. Wenn dort etwas nicht funktioniert, siehst du den Fehler direkt – im Claude-Fenster siehst du nur, dass „es nicht klappt”.
Schritt 4 – Rechte klein halten
Der Server läuft mit deinen Zugangsdaten. Gib ihm ein Konto mit Lesezugriff auf das Nötige, nicht deinen Admin-Zugang. Was der Server nicht darf, kann auch nicht schiefgehen.
Woran es meistens scheitert
- Zu viele Werkzeuge auf einmal. Jedes kostet Kontext, und Claude wählt schlechter, je ähnlicher sie sich sind.
- Beschreibungen aus der API-Doku kopiert. Die erklären Entwicklern die Technik, nicht dem Modell die Absicht.
- Schreibrechte ohne Not. Ein Werkzeug, das nur liest, kann nichts kaputt machen – fang so an.
