Weniger ist mehr: Wie aus einer API wenige, präzise MCP-Tools werden

Warum viele Werkzeuge einen Agenten schlechter machen

Es liegt nahe, einem Agenten möglichst viel zu geben: alle Endpunkte, alle Systeme, für alle Fälle. Das Gegenteil hilft ihm. Drei Gründe:

Context Rot

Alles, was ein Agent sieht, landet in seinem Kontextfenster, auch die Beschreibung jedes Werkzeugs, das er nie benutzt. Mit wachsendem Kontext arbeiten Sprachmodelle weniger verlässlich. Dieses Phänomen heißt Context Rot. Der Forschungsbericht „Context Rot: How Increasing Input Tokens Impacts LLM Performance“ von Chroma (Juli 2025) hat das an 18 Modellen gezeigt, schon bei bewusst einfachen Aufgaben. Werkzeuge, die der Agent nicht braucht, sind deshalb nicht neutral: Sie verdrängen Aufmerksamkeit, die der eigentlichen Aufgabe fehlt.

Auswahlfehler

Je mehr Werkzeuge ähnlich klingen, desto leichter greift der Agent daneben: Rechnung oder Beleg, Kontakt oder Kunde, lesen oder suchen. Jedes Werkzeug, das er nicht sieht, kann er auch nicht falsch wählen.

Token und Kosten

Werkzeugbeschreibungen werden bei jeder Anfrage mitgeschickt. Ein schmaler Werkzeugsatz hält jede Anfrage kleiner. Wie viel das spart, hängt von Modell, Client und Aufgabe ab. Eine feste Zahl nennen wir deshalb nicht.

Von der ganzen API zum Laser: vier Schnitte

Aus dem breiten Licht einer API wird ein gebündelter Strahl, ausgerichtet auf genau eine Aufgabe. Der Schnitt geschieht in vier Stationen.

1. Die ganze API

Eine moderne Geschäfts-API bietet Dutzende oder Hunderte Endpunkte. Sie ist für Programmierer gebaut, die genau wissen, was sie aufrufen. Ein Agent dagegen muss aus den Beschreibungen erraten, was er braucht.

2. Die Integration: nur beschriebene Werkzeuge

Der erste Schnitt legt fest, welche Endpunkte überhaupt zum Werkzeug werden, und beschreibt jedes so, dass der Agent es richtig einsetzt: Name, Zweck, Parameter mit erlaubten Werten. Was nicht beschrieben ist, gibt es für den Agenten nicht.

3. Der Zugang oder die Sicht: nur freigegebene Werkzeuge

Der zweite Schnitt gilt je Agent. Jeder Agent bekommt einen eigenen Zugang mit Rechten je Werkzeug. Was er nicht darf, sieht er nicht. Eine Sicht schneidet zusätzlich je Zweck zu, etwa einen eigenen Endpunkt nur für die Buchhaltung.

4. Der Agent: wenige, präzise MCP-Tools

Am Ende sieht der Agent die Handvoll Werkzeuge, die seine Aufgabe braucht. Feste Abläufe aus mehreren Aufrufen lassen sich zusätzlich zu einem einzigen Werkzeug bündeln. Dann muss der Agent die Schritte nicht selbst zusammensetzen.

Ein Beispiel aus der Buchhaltung

Beispiel zur Veranschaulichung, keine vollständige Liste einer bestimmten API.

Eine Buchhaltungs-API bietet unter anderem Endpunkte für Kontakte, Artikel, Angebote, Rechnungen, Gutschriften, Belege, Zahlungen, Dateien und Ereignisse, jeweils mit Lesen, Anlegen und Ändern.

Die Aufgabe lautet: „Erinnere freundlich an überfällige Rechnungen.“ Dafür braucht der Agent drei Werkzeuge: 1. Überfällige Rechnungen lesen 2. Kontakt zu einer Rechnung lesen 3. E-Mail-Entwurf anlegen, im Postfach, nicht in der Buchhaltung

Der Agent sieht nichts, womit er buchen, stornieren oder Stammdaten ändern könnte. Er kann sich nicht vergreifen, und sein Kontext bleibt frei für das, worauf es ankommt: den richtigen Ton und die richtige Rechnung. Ob die Erinnerung rausgeht, entscheidet ein Mensch, der den Entwurf liest.

Wo JanuaPort schneidet

JanuaPort ist die Schicht, in der der Zuschnitt passiert, zwischen Ihren Agenten und Ihren Systemen.

Zu den freigegebenen Werkzeugen kommen auf jedem Zugang wenige Basis-Werkzeuge, etwa für den Katalog und für Problemmeldungen.

Mehr dazu: Sichten und Bündelung · Rechte je Werkzeug · JanuaPort als MCP-Gateway

Prüffragen

1. Kann jeder Agent die Liste seiner Werkzeuge in einer Minute vorlesen?
2. Gibt es zwei Werkzeuge, die der Agent verwechseln könnte?
3. Sieht ein Agent, der nur liest, ein Werkzeug, das schreibt?
4. Wird ein fester Ablauf aus mehreren Aufrufen jedes Mal vom Agenten neu zusammengesetzt?
5. Wissen Sie, welche Werkzeugbeschreibungen bei jeder Anfrage mitgeschickt werden?