server_url und server_label
Auf dieser Seite
Aktualisiert am 3. November 2026 basierend auf der Seite Remote MCP Tools von xAI:
server_labelsetzt Tool-Aufrufe einem Präfix voraus, doch die Dokumentation gibt das genaue Format nicht vor; die Notationlabel__tool, die in diesem Kurs verwendet wird, ist eine Lesekonvention – überprüfen Sie das tatsächliche Format in Ihren API-Antworten. Quelle: Remote MCP Tools.
Die beiden Parameter, auf die Sie nicht verzichten können
Jede Verbindung zwischen Grok und einem entfernten MCP-Server stützt sich auf zwei Parameter: server_url und server_label. Sie sind unverhandelbar – ohne sie lehnt die API die Anfrage ab, bevor sie überhaupt etwas versucht. Alle weiteren Parameter, die Sie später antreffen, verfeinern lediglich dieses Fundament; sie ersetzen es nie.
server_url: Die exakte Endpunkt-Adresse
Der Parameter server_url enthält die vollständige URL des MCP-Servers, zu dem Grok sich verbinden muss, und diese URL unterliegt strengen Regeln.
Die erste Regel lautet HTTPS. Die URL muss mit https://, beginnen, und xAI lehnt jede unverschlüsselte HTTP-Verbindung ab. Der Grund ist einfach: Der Austausch zwischen Grok und dem MCP-Server enthält die Anfragen Ihrer Nutzer, die Ergebnisse der Tools und manchmal sogar den Authentifizierungstoken selbst. Dass dies im Klartext zirkuliert, wäre nicht vertretbar.
# Korrekt
mcp(server_url="https://mcp.deepwiki.com/mcp")
# Von der API abgelehnt
mcp(server_url="http://mcp.deepwiki.com/mcp")
Die zweite Regel betrifft die Präzision des Pfades. Die URL muss auf den MCP-Endpunkt verweisen, nicht auf die Wurzel der Domain. Fast alle Server stellen ihren Endpunkt auf einem dedizierten Pfad bereit, und die Konvention variiert von Server zu Server. Hier sind drei gültige Formen, die Sie antreffen werden:
https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp
Die dritte Regel ergibt sich aus den beiden vorherigen: localhost und private IP-Adressen sind ausgeschlossen. Der Server muss von der Infrastruktur von xAI aus erreichbar sein, auf einer öffentlichen Domain mit einem gültigen SSL-Zertifikat. Dies wirft eine konkrete Frage während der Entwicklung auf, da der MCP-Server, den Sie schreiben, auf Ihrem eigenen Gerät läuft. Die übliche Lösung besteht darin, einen Tunnel zu verwenden – beispielsweise ngrok oder Cloudflare Tunnel –, der Ihre lokale Instanz während Ihrer Tests hinter einer öffentlichen HTTPS-URL ausstellt.
server_label: Die Identität des Servers im Gespräch
Der server_label ist ein kurzer Identifikator, den Grok verwendet, um Tool-Aufrufe von diesem Server voranzustellen. Seine Rolle ist zweifach: Spuren lesbar zu machen und Mehrdeutigkeiten zu beseitigen, wenn mehrere Server gleichzeitig bestehen.
Die Dokumentation von xAI besagt, dass das Label Tool-Aufrufe von diesem Server voranstellt, ohne das genaue Format vorzuschreiben. In diesem Kurs bezeichnen wir ein Tool search_docs vom Server deepwiki als deepwiki__search_docs zur besseren Lesbarkeit: überprüfen Sie das tatsächliche Format in den API-Antworten, bevor Sie darauf aufbauende Logik erstellen.
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
# Tool-Aufrufe von diesem Server werden mit "deepwiki" vorangestellt
Drei Kriterien leiten die Wahl eines guten Labels. Es muss kurz sein, da es zu jedem Aufrufnamen hinzugefügt wird und ein umständliches Label Ihre Protokolle unnötig aufbläht. Es muss beschreibend sein, damit die Herkunft eines Aufrufs auf einen Blick lesbar ist, ohne die Konfiguration konsultieren zu müssen. Es muss in Ihrer Konfiguration eindeutig sein, andernfalls können Sie zwischen zwei Servern nicht unterscheiden. Die folgenden Beispiele erfüllen diese drei Anforderungen:
server_label="deepwiki" # GitHub-Dokumentation
server_label="crm" # Kundenmanagementsystem
server_label="jira" # Ticketverfolgung
server_label="search" # Internes Suchsystem
Dies wird viel greifbarer, sobald Sie mehrere Server mit derselben Sitzung verbinden. Nehmen Sie an, Ihre interne Dokumentation und DeepWiki stellen beide ein Tool namens search bereit. Ohne eindeutige Labels kollidieren die Tool-Namen, und Grok hat keine Möglichkeit, zu erkennen, welches Ziel es ansteuern soll. Mit Labels werden die beiden Tools unterschiedlich vorangestellt – hier als deepwiki__search und internal-docs__search notiert – und die Verwirrung verschwindet. Auf diesen Punkt werden Sie in der Lektion zu mehreren Servern zurückkommen.
Minimale Konfiguration in beiden SDKs
Zusammen sind diese beiden Parameter ausreichend, um einen öffentlichen MCP-Server zum Laufen zu bringen. Mit dem nativen xAI SDK:
from xai_sdk.tools import mcp
tools = [
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
]
Und das exakte Äquivalent mit der Responses API im OpenAI-Format:
tools = [{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
}]
Kernaussagen
server_urlundserver_labelsind die einzigen beiden erforderlichen Parameter- Die URL muss HTTPS mit einem gültigen SSL-Zertifikat sein, kein localhost
- Das Label stellt alle Tool-Aufrufe von diesem Server voran (das genaue Format ist nicht dokumentiert; dieser Kurs notiert es als
label__tool) - Wählen Sie Labels, die kurz, beschreibend und pro Server eindeutig sind
- Das Label ist für mehrere Server unerlässlich, um Namenskonflikte zu vermeiden