Tools sind die Hände eines Agents. MCP ist der Stecker. Skills sind vorbereitete Werkzeuggürtel. Wer das versteht, weiß warum ein Agent etwas Reales tun kann und warum er manchmal scheitert. Diese Tafel zeigt das Innere des Werkzeugkastens.
Tools are an agent’s hands. MCP is the connector. Skills are pre-prepared tool belts. Understanding this reveals why an agent can do real things and why it sometimes fails. This article shows the inside of the toolbox.
Ein Tool ist eine Funktion mit klarem Namen, klaren Eingaben und einer klaren Antwort. Nicht mehr, nicht weniger. Der Agent liest die Beschreibung, entscheidet wann er es ruft, und nutzt das Ergebnis im nächsten Gedanken.
A tool is a function with a clear name, clear inputs, and a clear response. Nothing more, nothing less. The agent reads the description, decides when to call it, and uses the result in the next thought.
Jedes Tool hat einen Namen, eine kurze Beschreibung in natürlicher Sprache und ein Schema für die Parameter. Mehr braucht es nicht. Der Agent versteht aus dem Schema, was hineinpasst und was nicht.
Every tool has a name, a short natural-language description, and a schema for its parameters. Nothing else is needed. The agent understands from the schema what fits and what doesn’t.
FORMEL
NAME ┌──→ SCHEMA ┌──→ FUNKTION
Die Beschreibung ist wichtiger als der Code. Sie ist das, was der Agent liest. Schlechte Beschreibung, schlechte Wahl.
The description matters more than the code. It’s what the agent reads. Bad description, bad choice.
EIN TOOL · IM SCHEMAONE TOOL · IN THE SCHEMA
Vereinfacht. Reale Schemas folgen JSON-Schema-Konventionen.Simplified. Real schemas follow JSON Schema conventions.
Tools fallen in drei klare Familien, je nachdem, was sie mit der Welt machen. Die Unterscheidung ist nicht akademisch. Sie entscheidet darüber, welches Risiko bei einem falschen Aufruf entsteht und wie viel Aufsicht ein Agent braucht.
Tools fall into three clear families, depending on what they do to the world. The distinction isn’t academic. It determines what risk a wrong call creates and how much oversight an agent needs.
| DIMENSIONDIMENSION | READ | WRITE | ACTION |
|---|---|---|---|
| Tut wasDoes what | Holt InformationFetches information | Verändert DatenChanges data | Bewegt RealesMoves real things |
| BeispieleExamples | web_search, db_query, calendar_read | db_update, doc_edit, file_save | send_email, payment_run, deploy_release |
| Risiko bei FehlerRisk if wrong | Falsche AntwortWrong answer | Beschädigte DatenCorrupted data | Echte Konsequenz draußenReal consequence outside |
| Empfohlene AufsichtRecommended oversight | StichprobeSpot check | Diff-Vorschau, UndoDiff preview, undo | Approval-Gate, Rate-LimitApproval gate, rate limit |
| ReversibelReversible | Ja, immerYes, always | Meist, mit UndoUsually, with undo | Selten, oft gar nichtRarely, often not at all |
┌──→ EINE FAUSTREGEL: JE WEITER RECHTS, DESTO STRENGER DIE GUARDRAIL.┌──→ A RULE OF THUMB: THE FURTHER RIGHT, THE STRICTER THE GUARDRAIL.
Bevor MCP da war, schrieb jedes Team eigene Adapter, jeder Hersteller eigenes Schema, jeder Agent eigene Konventionen. Heute gibt es einen offenen Standard, der das alles eindampft. Model Context Protocol. Stell es dir wie USB für AI vor.
Before MCP existed, every team wrote its own adapters, every vendor its own schema, every agent its own conventions. Today there’s an open standard that distills it all. Model Context Protocol. Think of it like USB for AI.
MCP · ARCHITEKTURARCHITECTURE
01 · ENTDECKUNG01 · DISCOVERY
Der Agent fragt einen Server: was kannst du? Der Server antwortet mit einer Liste seiner Tools, mitsamt Beschreibung und Schema.
The agent asks a server: what can you do? The server responds with a list of its tools, including description and schema.
02 · AUFRUF02 · CALL
Der Agent ruft ein Tool mit den geforderten Parametern. Der Server führt aus, antwortet mit Ergebnis oder Fehler. Immer im selben Format.
The agent calls a tool with the required parameters. The server executes, responds with result or error. Always in the same format.
03 · KONTEXT / CONTEXT
Server können Dateien, Prompts oder Wissen mitgeben. Nicht nur Tools, auch Kontext fließt durch denselben Stecker.
Servers can provide files, prompts, or knowledge. Not just tools, context also flows through the same connector.
04 · OFFEN04 · OPEN
Spec ist offen, Implementierungen sind frei. Wer einen Server schreibt, ist sofort kompatibel mit jedem Client am Markt.
The spec is open, implementations are free. Anyone who writes a server is immediately compatible with every client on the market.
Fünf Phasen, ein einziger Tool-Call. Klick durch und sieh, was zwischen Agent und Server tatsächlich hin und her läuft. Die JSON-Beispiele entsprechen einem realen MCP-Aufruf, gekürzt für die Lesbarkeit.
Five phases, one single tool call. Click through and see what actually passes back and forth between agent and server. The JSON examples correspond to a real MCP call, shortened for readability.
SIMULATION · VEREINFACHTER MCP-AUFRUF.SIMULATION · SIMPLIFIED MCP CALL.
Ein einzelnes Tool ist eine Funktion. Ein Skill ist ein vorbereiteter Workflow: mehrere Tools, Reihenfolge, Tonalität, Beispiele. Plugins gehen einen Schritt weiter und liefern fertige Skill-Pakete für ganze Berufsfelder. So musst du nicht jedes Mal von vorn anfangen.
A single tool is a function. A skill is a prepared workflow: multiple tools, sequence, tone, examples. Plugins go a step further and deliver ready-made skill packages for entire domains. So you don’t have to start from scratch every time.
Ein Aufruf, eine Antwort. Beispiel: send_email. Das kleinste Bauteil im Werkzeugkasten.
One call, one response. Example: send_email. The smallest building block in the toolbox.
Ein Server bündelt verwandte Tools eines Anbieters. Beispiel: Gmail-Server mit lesen, suchen, senden, archivieren.
A server bundles related tools from one provider. Example: Gmail server with read, search, send, archive.
Ein Skill ist ein dokumentierter Workflow plus die Tools, die er braucht. Beispiel: „Wettbewerber-Report bauen“, inkl. Reihenfolge und Tonalität.
A skill is a documented workflow plus the tools it needs. Example: “Build competitor report”, including sequence and tone.
Ein Plugin liefert mehrere Skills plus Server, die zusammen einen Use-Case abdecken. Beispiel: Sales-Plugin mit Recherche, Outreach, Pipeline-Sicht.
A plugin delivers multiple skills plus servers that together cover a use case. Example: sales plugin with research, outreach, pipeline view.
VERVIERFACHUNG · TYPISCHER EFFEKTQUADRUPLICATION · TYPICAL EFFECT
Ein Skill, der drei bis fünf Tools sinnvoll kombiniert, liefert in der Praxis das Vier- bis Fünffache an verlässlichem Output gegenüber rohem Tool-Use. Der Grund ist nicht das Modell, sondern die Anleitung.
A skill that meaningfully combines three to five tools delivers in practice four to five times the reliable output compared to raw tool use. The reason isn’t the model, it’s the instructions.
Ein Tool, das mehr darf als nötig, ist eine offene Tür. Drei Mechanismen kommen in jedem ernsthaften Setup zum Einsatz, oft kombiniert: Scopes, Approval-Gates, Audit-Trails.
A tool that can do more than necessary is an open door. Three mechanisms are used in every serious setup, often combined: scopes, approval gates, audit trails.
A · SCOPES
Ein Tool bekommt nur die Rechte, die es wirklich braucht. Lesen reicht für eine Recherche, Schreibrechte sind tabu. Wer Scopes weit zieht, baut sich ein Loch.
A tool gets only the permissions it actually needs. Read access suffices for research, write permissions are off-limits. Setting scopes wide builds in a vulnerability.
B · APPROVAL-GATES
Bei Action-Tools wartet der Agent auf eine Freigabe. Du siehst, was er tun will, prüfst kurz, drückst Ja oder Nein. Maximal zwei Klicks.
For action tools, the agent waits for approval. You see what it wants to do, review briefly, press yes or no. Maximum two clicks.
C · AUDIT-TRAIL
Jeder Tool-Call landet im Log. Wer hat was wann gerufen, mit welchen Parametern, mit welchem Ergebnis. Im Zweifel forensisch nachvollziehbar.
Every tool call lands in the log. Who called what when, with which parameters, with which result. Forensically traceable if needed.
FAUSTREGEL · SICHERHEITRULE OF THUMB · SECURITY
Drei Fragen vor jedem neuen Tool: Was darf es lesen? Was darf es ändern? Wer bekommt eine Benachrichtigung, wenn es ausschlägt? Wer eine davon nicht beantworten kann, sollte das Tool nicht verbinden.
Three questions before each new tool: What can it read? What can it change? Who gets notified when it fires? Anyone who can’t answer one of them shouldn’t connect the tool.
04
Wo Agents schiefgehen, wie du sie absicherst, wann der Mensch im Loop bleiben muss. Mit Checkliste für eigene Setups.
Where agents go wrong, how to secure them, when humans must stay in the loop. With checklist for your own setups.
05
Vom Anwendungsfall bis zum Prototyp. Welche Schritte, welche Werkzeuge, welche Stolperfallen.
From use case to prototype. What steps, what tools, what pitfalls.
06
Mehrere Agents, die zusammen arbeiten. Rollen, Übergaben, Orchestrierung. Wo das funktioniert und wo nicht.
Multiple agents working together. Roles, handoffs, orchestration. Where this works and where it doesn’t.