Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Beschreibung und erlaubte Werkzeuge

Lektion 5 von 12 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Zwei optionale Hebel, zwei sehr unterschiedliche Wirkungen
  2. server_description: Kontext für das Modell bereitstellen
  3. allowed_tools: den Umfang eingrenzen
  4. Warum einschränken, wenn alles funktioniert?
  5. Beide Parameter zusammenwirken lassen
  6. Kernaussagen

Zwei optionale Hebel, zwei sehr unterschiedliche Wirkungen

Die URL und das Label reichen aus, um die Verbindung herzustellen, geben dem Grok-Modell jedoch nicht vor, wie es den Server verwenden soll. Zwei optionale Parameter schließen diese Lücke und ergänzen sich: server_description erläutert, wofür der Server dient, während allowed_tools – oder allowed_tool_names, je nach SDK – entscheidet, was der Server berühren darf. Der erste lenkt, der zweite begrenzt.

server_description: Kontext für das Modell bereitstellen

Dieser Parameter liefert dem Grok eine Beschreibung der Serverfähigkeiten in natürlicher Sprache. Das Modell nutzt diese Information zur Abwägung: Soll es diesen Server abfragen, einen anderen oder gar keinen?

mcp(
    server_url="https://api.example.com/mcp",
    server_label="docs",
    server_description="Technischer Dokumentations-Server. Ermöglicht die Suche nach Artikeln, die Konsultation von Guides und die Bereitstellung von Codebeispielen für die interne API."
)

Ohne diese Beschreibung verfügt das Grok nur über die einzelnen Namen und Beschreibungen der exponierten Werkzeuge. Es funktioniert, doch das Modell arbeitet ohne einen großen Überblick: Es sieht eine Sammlung von Werkzeugen, ohne zu wissen, was sie kollektiv bilden. Eine gute Beschreibung vermittelt dem Modell drei Dinge, die ein Werkzeugname nicht transportieren kann: wann dieser Server relevant ist, anstatt eines anderen; die Art der Anfragen, die dort geroutet werden sollen; und – oft übersehen, aber entscheidend –, was der Server nicht tut, was Fehlschläge vermeidet.

Schreiben Sie diese Beschreibung so, als würden Sie den Service einem Kollegen erklären, der dem Projekt beitritt. Seien Sie spezifisch: “Datenbank technischer Produkt-Dokumentation” ist nützlicher als nur “Dokumentation”. Nennen Sie die tatsächlich möglichen Aktionen, wie “Ermöglicht die Suche, das Lesen und das Aktualisieren von Tickets”. Und wenn der Umfang eingeschränkt ist, stellen Sie dies klar: “Nur Lesezugriff, keine Änderungen” spart dem Modell einen gescheiterten Versuch.

allowed_tools: den Umfang eingrenzen

Standardmäßig werden beim Verbinden von Grok mit einem MCP-Server alle Werkzeuge, die der Server exponiert, ohne Ausnahme in den Kontext des Modells injiziert. Bei einem CRM bedeutet dies, dass das Erstellen, Ändern und Löschen von Kontakten genauso zugänglich ist wie die Suche.

mcp(server_url="https://api.example.com/mcp",
    server_label="crm")
# Grok sieht ALLE Werkzeuge: create_contact, update_contact,
# delete_contact, search_contacts, export_data, etc.

Der Parameter allowed_tool_names kehrt dieses Verhalten um, indem er eine explizite Whitelist festlegt. Alles, was nicht darauf steht, bleibt für das Modell unsichtbar.

mcp(server_url="https://api.example.com/mcp",
    server_label="crm",
    allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok sieht nur search_contacts und get_contact_details

Warum einschränken, wenn alles funktioniert?

Der erste Grund ist Sicherheit und folgt dem Prinzip der geringsten Rechte. Wenn Ihre Anwendung nur lesen muss, sollten Sie Werkzeuge zur Änderung oder zum Löschen nicht innerhalb der Reichweite des Modells belassen. Eine erfolgreiche Prompt-Injection – eine bösartige Anweisung, die in ein von Grok analysiertes Dokument eingeschleust wird – kann kein delete_contact auslösen, das nie exponiert wurde. Die Whitelist verwandelt ein potenzielles Vorfall in ein Nichtereignis.

# Nur Lesezugriff für einen öffentlichen Chatbot
allowed_tool_names=["search_database", "get_record", "format_data"]

Der zweite Grund ist die Leistung. Jedes exponierte Werkzeug beansprucht Platz im Kontextfenster, da sein Name, seine Beschreibung und sein Parameterschema dort Platz finden müssen. Ein MCP-Server, der fünfzig Werkzeuge veröffentlicht, verbraucht ein beträchtliches Volumen, bevor der Nutzer selbst seine Frage stellt. Indem Sie auf fünf wirklich nützliche Werkzeuge reduzieren, gewinnen Sie diesen Raum für das Wesentliche zurück: den eigentlichen Dialog.

Der dritte Grund ist Präzision. Je umfangreicher der Katalog, desto mehr zögert das Modell zwischen ähnlichen Werkzeugen – und zwei Werkzeuge mit ähnlichen Beschreibungen führen zu instabilen Entscheidungen von einer Ausführung zur nächsten. Ein Katalog, der auf Ihren Anwendungsfall zugeschnitten ist, macht die Auswahl deutlich zuverlässiger.

Beide Parameter zusammenwirken lassen

Das Ergebnis wird wirklich sauber, wenn Sie beide Parameter kombinieren, sofern sie dieselbe Geschichte erzählen.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="crm",
    server_description="Nur Lesezugriff CRM. Suche und Anzeige von Kontakten und Unternehmen.",
    allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)

Hier verkündet die Beschreibung den Lesezugriff, und die Whitelist garantiert dies technisch. Achten Sie auf die umgekehrte Situation, die öfter passiert, als man denkt: Eine Beschreibung, die von einer früheren Version übernommen wurde und Schreibzugriffe verspricht, die nun von der Whitelist entfernt wurden. Das Modell wird den Aufruf versuchen, scheitern, und Sie werden Zeit damit verbringen, nach einem Fehler zu suchen, der nicht existiert. Prüfen Sie diese beiden Parameter immer gemeinsam, niemals getrennt.

Kernaussagen

  • server_description hilft dem Grok zu verstehen, wann es diesen MCP-Server verwenden soll
  • Ohne allowed_tools werden alle Server-Werkzeuge in den Kontext injiziert
  • Das Einschränken von Werkzeugen stärkt Sicherheit, Leistung und Präzision
  • Kombinieren Sie Beschreibung und Einschränkung für optimale Kontrolle
  • Schreiben Sie die Beschreibung als natürliche Spracherklärung der Serverfähigkeiten