4 Der Lotse 5 Fast-Architekt 6 Refactorer ~9 Min

MCP für den Agenten: Was das ist und wie du Tools anschließt

Stecker rein - und der Agent hat Hände in der echten Welt

MCP einfach erklärt: ein einziger Stecker, über den ein KI-Agent Tools, Daten und Vorlagen bekommt. Warum das für Vibecoder wichtig ist, wie du einen Server anschließt und dabei kein Unglück erlebst.

ECC-Skills in dieser Lektion: mcp-server-patterns

MCP einfach erklärt: Steckdosen in der Küche des Agenten

Erinnerst du dich an die Analogie aus den letzten Kapiteln? Das Modell ist ein genialer Koch, und wir bauen drumherum eine Küche (das Harness). Genau hier kommt es: MCP sind die Standard-Steckdosen in dieser Küche. Steck den Mixer in die Steckdose - der Koch kann Smoothies. Steck den Fleischwolf rein - er kann Hackfleisch. Und der Koch selbst hat sich kein Gramm verändert. Er hat einfach ein neues Gerät dazubekommen.

Jetzt mal schlau ausgedrückt. MCP ist das Protokoll, über das sich ein KI-Agent mit externen Fähigkeiten verbindet: ein Tool aufrufen, Daten lesen, eine fertige Befehlsvorlage nehmen. Der ganze Clou steckt in einem Wort - standardisiert. Früher wurde jede Integration von Hand gebaut, von null, jedes Mal aufs Neue. Jetzt ist die Steckerform einheitlich. Und in sie passen Hunderte fertiger „Geräte“.

Roboter-Agent, der statt einer Hand einen USB-Anschluss hat, an den verschiedene Werkzeug-Aufsätze angeschlossen werden
Das Modell ist dasselbe. Es hat jetzt einfach einen universellen Stecker für neue Fähigkeiten.

Warum MCP für Vibecoder wichtig ist

Du bist Vibecoder. Den Server musst du nicht von Hand schreiben - auch wenn wir am Ende der Lektion mal reinschauen, wie er von innen aufgebaut ist. Aber MCP zu verstehen ist wichtig. Genau darüber klettert der Agent aus dem Chat raus in die echte Welt.

  • Du willst, dass der Agent selbst Mails liest und sie ordentlich einsortiert? Du schließt das MCP für Mail an.
  • Du willst, dass er frische Daten aus dem Internet zieht, statt sich was auszudenken? Du schließt das MCP für Suche an.
  • Du willst, dass er mit deinem Projekt, deiner Datenbank, deinem Design arbeitet? Für all das gibt es schon fertige Server.

Der Unterschied zwischen „der Agent quatscht im Chat schön daher“ und „der Agent erledigt wirklich Sachen für mich“ sind fast immer richtig angeschlossene MCP-Server. Da ist sie, die Superkraft aus dem Kapiteltitel.

Was in MCP drinsteckt: Tools, Ressourcen, Prompts

Jeder Server gibt dem Agenten drei Arten von „Fähigkeiten“. Merk sie dir - und dann hast du quasi das ganze MCP-Vokabular in der Tasche.

Tools - der Agent FÜHRT eine Aktion aus

Tools sind die Verben. „Schick eine Mail“, „starte die Tests“, „finde den Kunden in der Datenbank“, „leg eine Aufgabe an“. Der Agent entscheidet selbst, wann er das passende Tool ruft, gibt ihm Daten mit und bekommt das Ergebnis zurück.

Ein gutes Tool ist wie ein guter Knopf auf der Fernbedienung: enger Name, eine klare Aufgabe. Ein schlechtes ist ein „Mega-Knopf für alles“, nach dem sich der Agent am Kopf kratzt und gar nicht versteht, was eigentlich passiert ist.

Ressourcen - der Agent LIEST Daten

Ressourcen sind die Substantive. Daten nur zum Lesen: der Inhalt einer Datei, die Antwort einer API, Zeilen aus einer Tabelle. Der Agent fasst sie nicht an. Er schaut nur rein, um den Kontext zu verstehen. Normalerweise hat eine Ressource ihre eigene Adresse (uri) - wie ein Link, über den der Agent das passende Stück rauszieht.

Prompts - fertige Befehlsvorlagen

Prompts in MCP sind vorgefertigte Anfrage-Vorlagen mit Lücken für Parameter. Grob gesagt: „erstelle den Bericht für Monat X zum Projekt Y“. Der Client (zum Beispiel deine App) zeigt dir so eine Vorlage, du setzt die Werte ein - und tippst nicht hundertmal denselben langen Befehl.

Drei Kisten mit Beschriftungen: Tools (Hammer), Ressourcen (Buch), Prompts (Formular mit Lücken)
Das ganze MCP sind drei Kisten: was der Agent tut, was er liest und welche Vorlagen er nutzt.

Lokaler und Remote-MCP-Server: wohin den Stecker rein

Ein MCP-Server kann an zwei Orten leben. Der Unterschied ist hier einfach.

  • Lokal - läuft direkt auf deinem Computer. Die Verbindung geht über stdio - zwei Programme werfen sich einfach Text hin und her. So verbindet man zum Beispiel den Agenten mit Claude Desktop.
  • Remote - lebt irgendwo in der Cloud, und der Agent geht über das Internet per HTTP zu ihm. Der moderne Standard dafür ist Streamable HTTP: eine saubere Webadresse für den ganzen Server. Den alten Weg über SSE behält man nur noch aus Kompatibilitätsgründen.

Wie du ein gutes MCP-Tool von einem schlechten unterscheidest

Wenn du ein MCP auswählst oder einrichtest - so erkennst du auf einen Blick einen vernünftigen Server vom qualvollen. Das sind direkte Regeln aus der Praxis der MCP-Server-Entwicklung.

Gutes Tool
  • Enger Name, eine Aufgabe: „Mail senden“, „Bestellung finden“. Sofort klar, was es tut.
  • Es gibt ein Eingabe-Schema: klar beschrieben, welche Daten es annimmt und was es zurückgibt.
  • In der Antwort - ein verständliches Ergebnis und ein Hinweis „was kommt als Nächstes“, kein roher technischer Müll.
  • Hat keine Angst vor Wiederholungen: zweimal aufgerufen - nichts kaputt, nichts doppelt.
Schlechtes Tool
  • Ein „Mega-Tool für alles“ - der Agent verheddert sich, was er wann rufen soll.
  • Stürzt stillschweigend ab oder spuckt einen Fehler-Stack aus, aus dem der Agent nicht versteht, was zu reparieren ist.
  • Keine Parameter-Beschreibung - der Agent rät im Kaffeesatz, was er reinpacken soll.
  • Ruft eine kostenpflichtige externe API ganz ohne Limits - hallo, unerwartete Rechnung.

Beispiel: der Agent liest Mails über MCP

Du bittest den Agenten: „schau mal, was mir heute die Kunden geschrieben haben, und mach eine kurze Zusammenfassung“. Im normalen Chat hebt der Agent ehrlich die Hände: „ich habe keinen Zugriff auf deine Mail“. Sackgasse.

Und jetzt schließen wir den MCP-Server für Mail an - und dieselbe Anfrage wird zu Magie. Der Agent öffnet selbst den Posteingang (das ist eine Ressource - lesen), holt die heutigen Mails raus, macht eine Zusammenfassung, und wenn du fragst - schreibt er für dich einen Antwortentwurf (das ist schon ein Tool - eine Aktion).

Damit die Magie nicht zur Katastrophe wird, kommandiere ihn so.

Prompt - kopieren und ausprobieren

Du hast über MCP Zugriff auf meine Mail. Mach Folgendes:

  1. Lies nur die Mails von heute. Lösche und sende nichts ohne meine Erlaubnis.
  2. Gruppiere sie nach Themen und gib eine kurze Zusammenfassung: von wem, worum es geht, wie dringend.
  3. Für die zwei dringendsten bereite einen Antwortentwurf vor, aber sende ihn NICHT - zeig ihn mir erst.
  4. Wenn ein Tool fehlt oder der Zugriff nicht klappt - sag das ehrlich, erfinde keinen Mail-Inhalt.

Wie ein MCP-Server von innen aufgebaut ist (ein kurzer Blick)

Von Hand wirst du das nicht schreiben müssen, aber es ist nützlich zu sehen, dass „Magie“ ganz normaler Code ist. Ein MCP-Server in TypeScript ist buchstäblich in ein paar Zeilen aufgesetzt:

  • du installierst das Paket: npm install @modelcontextprotocol/sdk zod;
  • du erstellst einen Server mit Name und Version;
  • du registrierst Tools und Ressourcen, beschreibst ihre Eingabe über Zod - das ist einfach der „Türsteher am Eingang“: er prüft, dass der Agent Daten der richtigen Art übergeben hat und nicht irgendwas.
Meme: Ein Vibecoder schließt den zehnten zweifelhaften MCP-Server an mit den Worten „was kann da schon schiefgehen“
Erst anschließen. Dann lesen, welche Rechte du gerade vergeben hast.

Häufige Anfängerfehler mit MCP

  • Alles wahllos anschließen. Jeder Server sieht deine Daten. Installiere nur die, denen du vertraust, und lies, welche Rechte sie verlangen.
  • Maximale Rechte geben „damit es auf jeden Fall läuft“. Gib das Minimum: muss er nur Mails lesen - vergib kein Recht zum Löschen und Senden.
  • Erwarten, dass MCP das Modell klüger macht. Es gibt Fähigkeiten und Zugriff, keine Intelligenz. Eine krumme Aufgabe macht der Agent auch über MCP krumm, nur schneller.
  • Ein einziges „Mega-Tool für alles“. Der Agent verheddert sich. Besser mehrere enge Tools mit klaren Namen.
  • Glauben, dass der Agent garantiert alles erledigt hat. Wenn ein Tool stillschweigend abstürzt, kann der Agent die Antwort „dazumalen“. Bitte ihn, Fehler ehrlich zu melden, und prüf Wichtiges selbst nach.
  • Einen Server von null schreiben, wenn es schon einen fertigen gibt. Such erst nach einem vorhandenen MCP für die Aufgabe - höchstwahrscheinlich hat ihn schon jemand geschrieben und sauber gemacht.

TL;DR - если коротко

  • MCP ist der „USB-Stecker“ für den Agenten. Server reingesteckt - und der Agent kann Mails lesen, in die Datenbank gehen, googeln.
  • Drinnen stecken drei Dinge: Tools (der Agent handelt), Ressourcen (der Agent liest) und Prompts (fertige Befehlsvorlagen).
  • Den Server gibt es lokal (auf deinem Rechner, über stdio) und remote (in der Cloud, über HTTP). In der Cloud ist der Standard Streamable HTTP.
  • Ein gutes Tool hat: einen engen Namen, eine Aufgabe, eine klare Antwort. Ein einziges „Mega-Tool für alles“ ist der pure Schmerz.
  • MCP ist Zugriff auf deine Daten. Schließ nur das an, dem du vertraust, und gib so wenig Rechte wie möglich.
  • Einen Server selbst zu schreiben musst du fast nie - den passenden hat schon jemand vor dir gebaut.

Wiki durchsuchen

Esc zum Schließen drücken

Geben Sie einen Suchbegriff ein, um alle Lektionen und Kurse zu durchsuchen.