MCP-Antwort zu groß? Vorschau und Detailabruf nutzen

Große MCP-Antworten belasten den Kontext, obwohl der KI-Assistent für den nächsten Schritt oft nur wenige Angaben benötigt. Ein größeres Kontextfenster verschiebt dieses Problem, ändert aber nicht den Zuschnitt des Tools.

Ein belastbarer Fix ist eine zweistufige Antwort: Eine Suche oder Liste liefert eine kompakte Vorschau mit stabilen IDs. Vollständige Inhalte ruft der Assistent anschließend gezielt über ein zweites Tool ab. So bleibt die erste Antwort übersichtlich, ohne dass benötigte Details verloren gehen.

Zu große MCP-Antworten vermischen Auswahl und Verarbeitung

MCP steht für Model Context Protocol und ermöglicht es KI-Anwendungen, definierte Tools und Datenquellen anzusprechen. Ein typischer Fehler entsteht, wenn ein einzelnes Tool gleichzeitig suchen, auswählen und vollständige Inhalte liefern soll.

Ein Tool zur Suche in Supportfällen könnte beispielsweise für jeden Treffer den Titel, den Status, die vollständige Beschreibung, sämtliche Nachrichten, interne Notizen und Informationen zu Anhängen zurückgeben. Für die Auswahl eines passenden Falls reichen zunächst jedoch meist Titel, Status, Änderungszeitpunkt und eine kurze Zusammenfassung.

Die vollständigen Verläufe helfen erst, nachdem ein konkreter Fall ausgewählt wurde. Werden sie schon bei der Suche übertragen, muss der Assistent viel Material verarbeiten, das er wahrscheinlich nicht verwendet. Abhängig vom KI-Client und Modell können relevante Treffer zwischen Nebendetails untergehen oder Antworten abgeschnitten werden.

Die entscheidende Frage für die Gestaltung einer Tool-Antwort lautet deshalb: Welche Angaben braucht der Assistent für seine unmittelbar nächste Entscheidung? Alles Weitere gehört in einen gezielten Detailabruf.

Der Fix besteht aus zwei klaren Tools

Teile die bisherige Funktion gedanklich in Auswahl und Bearbeitung. Im Beispiel eines internen Supports könnten daraus diese beiden Tools entstehen:

• search_support_cases sucht passende Fälle und liefert eine kompakte Trefferliste.
• get_support_case lädt die benötigten Details zu einer ausgewählten Fall-ID.

Die Suchantwort enthält pro Treffer nur Felder, die eine Auswahl ermöglichen:

• eine stabile Fall-ID,
• einen kurzen Titel,
• den Bearbeitungsstatus,
• den Zeitpunkt der letzten Änderung,
• eine knappe, sachliche Zusammenfassung.

Zusätzlich sollte die Antwort erkennen lassen, ob weitere Treffer existieren. Dafür eignet sich ein Cursor: ein technischer Verweis, mit dem das Tool die nächste Ergebnisseite laden kann. Der Assistent muss dadurch weder alle Treffer auf einmal anfordern noch selbst Seitenzahlen aus dem Datenbestand ableiten.

Der Detailabruf akzeptiert anschließend die stabile ID. Er kann die vollständige Beschreibung, relevante Nachrichten und weitere erlaubte Felder liefern. Anhangsinhalte solltest du weiterhin nur dann übertragen, wenn sie für die konkrete Aufgabe benötigt werden. Eine Dateiliste mit Name, Typ und ID reicht zunächst häufig aus.

Eine gute Vorschau beantwortet genau eine Auswahlfrage

Eine Vorschau ist keine wahllos gekürzte Vollantwort. Ihre Felder müssen dem Assistenten ermöglichen, den richtigen Datensatz auszuwählen. Welche Felder dafür nötig sind, hängt vom Arbeitsablauf ab.

Bei Supportfällen sind Status und Änderungszeitpunkt oft hilfreich. Bei Produkten könnten es Artikelnummer, Bezeichnung, Verfügbarkeit und Variante sein. Bei Dokumenten eignen sich Titel, Dokumenttyp, Gültigkeitsdatum und eine kurze Inhaltsangabe. Vollständige Texte, große HTML-Fragmente oder binäre Inhalte gehören gewöhnlich nicht in eine Trefferliste.

Prüfe jedes Feld mit zwei Fragen:

• Kann der Assistent ohne dieses Feld den passenden Treffer noch zuverlässig auswählen?
• Wird dieses Feld bei fast jedem Treffer tatsächlich für die Auswahl verwendet?

Wenn beide Antworten gegen das Feld sprechen, gehört es wahrscheinlich in den Detailabruf. Ein möglicher späterer Nutzen ist kein ausreichendes Auswahlkriterium.

Begrenze nicht nur die Textlänge

Ein hartes Zeichenlimit auf der bestehenden Vollantwort wirkt zunächst bequem. Es kann jedoch genau den Abschnitt abschneiden, der für die Aufgabe relevant ist. Außerdem bleibt für den Assistenten unklar, ob das Ergebnis vollständig ist.

Begrenze stattdessen die Struktur der Antwort:

• Nutze eine kleine Standardanzahl von Treffern.
• Erlaube nur einen kontrollierten Höchstwert für das angeforderte Limit.
• Definiere eine feste Auswahl erlaubter Vorschaufelder.
• Liefere einen Cursor, wenn weitere Treffer vorhanden sind.
• Kennzeichne ausdrücklich, wenn Inhalte ausgelassen oder gekürzt wurden.

Eine gekürzte Zusammenfassung darf nicht wie der vollständige Originaltext aussehen. Benenne das Feld beispielsweise als summary statt als content. So kann der Assistent erkennen, dass ein weiterer Abruf nötig sein kann.

Auch die Beschreibung des MCP-Tools sollte diesen Ablauf deutlich machen. Das Such-Tool dient der Auswahl, das Detail-Tool der inhaltlichen Bearbeitung. Diese Trennung ist verlässlicher als eine allgemeine Anweisung wie „Antworte möglichst kurz“, weil die Begrenzung bereits an der Datenquelle greift.

Pagination allein löst die Datenflut nicht

Eine paginierte Vollantwort kann weiterhin unnötig groß sein. Wenn bereits jeder einzelne Treffer einen kompletten Nachrichtenverlauf enthält, reduziert eine kleinere Seite lediglich die Anzahl gleichzeitig übertragener Volltexte.

Pagination und kompakte Vorschauen erfüllen unterschiedliche Aufgaben. Die Vorschau reduziert den Umfang jedes Treffers. Pagination begrenzt die Anzahl der Treffer pro Abruf. Für größere Datenbestände brauchst du in der Regel beides.

Der Cursor sollte vom Server erzeugt und vom Client unverändert zurückgegeben werden. Der Assistent muss seine interne Bedeutung nicht kennen. Wird der zugrunde liegende Datenbestand zwischen zwei Abrufen verändert, sollte dein Tool ein nachvollziehbares Ergebnis liefern oder einen ungültigen Cursor klar melden. Ein stillschweigender Sprung zu einer beliebigen Seite erschwert die Fehlersuche.

Wenn du kein zweites Tool ergänzen kannst

Manchmal lässt sich die vorhandene MCP-Schnittstelle nicht kurzfristig aufteilen. Dann kannst du denselben Grundgedanken innerhalb eines Tools umsetzen. Verwende eine kompakte Antwort als Standard und ergänze einen ausdrücklich wählbaren Detailmodus.

Ein solcher Übergangsfix sollte mindestens diese Regeln haben:

• Der Standardmodus liefert nur Vorschaufelder.
• Ein Parameter wie detail_level schaltet kontrolliert auf zusätzliche Inhalte um.
• Eine Feldliste akzeptiert ausschließlich bekannte, erlaubte Felder.
• Ein serverseitiges Maximum verhindert unbegrenzt große Antworten.
• Die Antwort zeigt an, ob weitere Details verfügbar sind.

Dieser Ansatz ist weniger eindeutig als zwei getrennte Tools. Ein KI-Assistent kann versehentlich den umfangreichen Modus für eine breite Suche verwenden. Als kurzfristige Korrektur ist er dennoch besser als eine Vollantwort ohne Begrenzung.

Fehlerfälle gehören ebenfalls in die Antwortstruktur

Der Detailabruf sollte nicht nur im Idealfall verständlich reagieren. Eine stabile ID kann veraltet sein, ein Datensatz kann gelöscht worden sein oder dem aufrufenden Benutzer können die nötigen Rechte fehlen.

Gib solche Zustände strukturiert und unterscheidbar zurück. „Kein Ergebnis“ ist etwas anderes als „Zugriff nicht erlaubt“. Ebenso sollte eine leere Suche als erfolgreiche Antwort mit leerer Trefferliste erscheinen und nicht wie ein technischer Fehler.

Für die Praxis reichen klar benannte Zustände, etwa:

• keine passenden Treffer,
• unbekannte oder nicht mehr gültige ID,
• fehlende Berechtigung,
• ungültiger Cursor,
• vorübergehend nicht verfügbare Datenquelle.

Der Assistent kann nur sinnvoll reagieren, wenn das Tool diese Fälle auseinanderhält. Lange Fehlermeldungen helfen dabei weniger als eine klare Kennung und eine kurze Erklärung.

So prüfst du den Fix mit wenigen gezielten Fällen

Nach der Umstellung musst du keine umfangreiche Testsuite erfinden, um die grundlegende Wirkung zu prüfen. Verwende einige Eingaben, die unterschiedliche Antwortgrößen und Auswahlprobleme sichtbar machen:

• Eine breite Suche mit vielen Treffern muss kompakt bleiben und einen Cursor liefern.
• Eine enge Suche sollte wenige eindeutige Vorschauen zurückgeben.
• Ähnliche Titel müssen durch ID und zusätzliche Auswahlfelder unterscheidbar sein.
• Ein Detailabruf muss genau den ausgewählten Datensatz laden.
• Eine fehlende Berechtigung darf keine geschützten Vorschau- oder Detaildaten preisgeben.
• Ein nicht mehr vorhandener Datensatz muss einen eindeutigen Zustand zurückgeben.

Betrachte dabei nicht nur die reine Zeichenmenge. Prüfe, ob der Assistent anhand der Vorschau den richtigen nächsten Abruf wählen kann. Eine extrem kurze Trefferliste ist nutzlos, wenn alle Einträge gleich aussehen.

Fazit: Das MCP-Tool sollte Informationen schrittweise freigeben

Eine zu große MCP-Antwort ist meist kein Kapazitätsproblem, sondern ein Zuschnittsproblem. Das Tool beantwortet mehrere Arbeitsschritte auf einmal und überträgt Details, bevor feststeht, ob sie gebraucht werden.

Mit einer kompakten Vorschau, stabilen IDs, einem begrenzten Trefferumfang und einem separaten Detailabruf löst du das Problem an der Quelle. Der KI-Assistent erhält zunächst genug Informationen für die Auswahl und danach genau die Daten für die Bearbeitung. Ein größeres Kontextfenster kann weiterhin nützlich sein, ersetzt aber keine passend zugeschnittene Tool-Antwort.