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

Stand: 24. Oktober 2026

**Ein KI-Agent mit wenigen, gut beschriebenen MCP-Tools wählt öfter das richtige und braucht weniger Kontext als einer, der die ganze API sieht. Darum verbessert der Zuschnitt die Qualität eines Agenten und ist nicht nur eine Frage der Sicherheit. Ein Schnitt gibt ihm Leitplanke und Fokus zugleich.**

Dieser Artikel vertieft einen Baustein aus dem Überblick [Harness Engineering](/ratgeber/harness-engineering): die Werkzeuge.

## 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“](https://research.trychroma.com/context-rot) 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.

| Schnitt | Was JanuaPort tut | Stand |
| --- | --- | --- |
| Integration | Nur Werkzeuge, die in der Beschreibung einer Integration stehen, werden angeboten. Bei angebundenen MCP-Servern gilt eine Pflicht-Liste der durchgereichten Werkzeuge | Integrationen in vier Arten: REST-Connector, Datenbank, Datei (camt-Kontoauszüge lesen, Ablage lesen und beschreiben), Upstream-MCP: Gebaut |
| Zugang | Jeder Agent hat einen eigenen Zugang mit Rechten je Werkzeug, nach dem Prinzip „deny by default“. Was er nicht darf, sieht er nicht | Tokens je Abnehmer (Mensch, Agent, Bot, Skript) mit werkzeuggenauen Rechten, deny-by-default: Gebaut |
| Sicht | Eigene Endpunkte je Team oder Zweck mit einem zugeschnittenen Werkzeugsatz | Sichten: eigene Endpunkte je Team (/mcp/v/<name>), exklusive Integrationen: Gebaut |
| Bündeln | Der Skript-Läufer macht aus einem festen Ablauf ein einzelnes Werkzeug | Skripte sicher ausführen: der Beisteller „Skript-Läufer“ führt Skripte (z. B. Python) aus einem Git-Repo aus, festgelegt auf einen Commit, den der Admin freigibt, in einer Sandbox ohne Netz (gVisor oder gehärtetes runc). Jeder Lauf bekommt einen eigenen Zugang, der nie mehr darf als der Aufrufer und nur die deklarierten Werkzeuge; nie im Gateway selbst. Grenzen je Lauf (Wandzeit, Ausgabe, Werkzeugaufrufe) unter einer Obergrenze je Anlage; Python-Bibliotheken je Pin; Lauf-Protokoll an den Aufrufer, bereinigt: Gebaut ab Werk ausgeschaltet, auf unserer Showcase live erprobt |

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](/gateway/buendelung) · [Rechte je Werkzeug](/gateway/governance) · [JanuaPort als MCP-Gateway](/ratgeber/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?

## Häufige Fragen

### Wie viele MCP-Tools sollte ein KI-Agent haben?
So wenige, wie seine Aufgabe braucht. Eine feste Zahl gibt es nicht. Jedes Werkzeug, das der Agent nicht braucht, kostet Kontext und ist eine Gelegenheit, das falsche zu wählen.

### Was ist Context Rot?
Context Rot bezeichnet die Beobachtung, dass Sprachmodelle mit wachsendem Kontext weniger verlässlich arbeiten. Werkzeugbeschreibungen gehören zum Kontext. Ein schmaler Werkzeugsatz lässt mehr Platz für die eigentliche Aufgabe.

### Spart ein Zuschnitt Token?
Ja, weil weniger Werkzeugbeschreibungen mitgeschickt werden. Wie viel, hängt von Modell, Client und Aufgabe ab.

### Ist der Zuschnitt eine Sicherheitsmaßnahme?
Zum Teil. Die Sicherheitsgrenze ziehen die Rechte je Zugang: Was ein Agent nicht darf, sieht er nicht. Eine Sicht ist ein zusätzlicher Zuschnitt für den Fokus, aber keine Sicherheitsgrenze.