Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Integrieren Sie einen benutzerdefinierten Server in Vibe

Lektion 13 von 14 Aktualisiert am 2. November 2026 Entwickler
Auf dieser Seite
  1. Verbinden Sie Ihren MCP-Server mit Vibe
  2. Den Connector hinzufügen
  3. Was passiert im Gespräch
  4. Wenn es nicht funktioniert
  5. Der MCP Inspector: Nutzen Sie ihn vor Vibe
  6. Leben mit mehreren Servern
  7. Kernaussagen

Update vom 2. November 2026 — Le Chat ist nun Vibe. Seit dem 28. Mai 2026 wurde Le Chat in Vibe umbenannt (nach wie vor unter chat.mistral.ai): ein einzelner Agent für Arbeit und Code, der Ihre Gespräche, Einstellungen und Abonnements übernimmt. Die klassische Le Chat-Erfahrung bleibt im Chat-Modus zugänglich; im Work-Modus sind Agenten zu Fähigkeiten geworden (über @ aufrufbar), Erinnerungen wurden zur Wissensbasis und die tiefe Suche zur Fähigkeit Deep Research. Pläne werden nun als Mistral Free, Pro, Team und Enterprise bezeichnet. Diese Lektion verwendet den Namen Vibe; beachten Sie, dass einige hier beschriebene Menüs andere Namen oder Standorte haben können.

Verbinden Sie Ihren MCP-Server mit Vibe

Ihr Server ist bereitgestellt und reagiert über HTTPS an einer stabilen Adresse. Nun kommt der Schritt, der all Ihrer bisherigen Arbeit Bedeutung verleiht: die Nutzbarkeit für Ihr beabsichtigtes Publikum in Gesprächen, einschließlich solcher Personen, die niemals ein Terminal öffnen werden. Vibe akzeptiert jeden konformen MCP-Server als benutzerdefinierten Connector. Diese Lektion behandelt das Hinzufügen des Connectors, den Ablauf von Aufrufen im Gespräch und die Diagnose von Fehlern – denn der erste Versuch schlägt oft fehl.

Den Connector hinzufügen

Öffnen Sie Vibe unter chat.mistral.ai und navigieren Sie zum Tab Connectors (Verbinder) in der Seitenleiste. Sie werden zwei distincte Bereiche finden: hervorgehobene Verbinder, die von Mistral vorab konfiguriert wurden (GitHub, Notion und andere), sowie Ihre eigenen benutzerdefinierten Verbinder, die zunächst leer sind. Klicken Sie auf Add Custom Connector (Benutzerdefinierten Verbinder hinzufügen) und füllen Sie die Felder aus:

  1. Name: Ein beschreibender Name (z. B. “Task Manager”)
  2. Server URL: Die vollständige URL Ihres MCP-Endpunkts (z. B. https://my-server.com/tasks/mcp)
  3. Beschreibung: Was Ihr Server tut (optional, aber empfohlen)

Wählen Sie als Nächstes Ihre Authentifizierungsmethode: Keine Authentifizierung für einen öffentlichen Server, Token, wenn Sie Ihren API-Token einfügen, oder OAuth 2.0 für einen vollständigen Einwilligungsablauf. Das Klicken auf Connect (Verbinden) löst die Entdeckung aus: Im Erfolgsfall zeigt Vibe die Liste der auf Ihrem Server gefundenen Tools an, wobei Name und Beschreibung jedes Tools angezeigt werden. Dies ist Ihr erstes echtes Feedback zur Qualität Ihrer Docstrings – Sie lesen sie hier genau so, wie das Modell sie erhält.

Was passiert im Gespräch

Sobald verbunden, erscheint Ihr Server im Abschnitt Tools der Chat-Seitenleiste, markiert durch ein Icon, das die Verfügbarkeit externer Tools anzeigt. Der Nutzer formuliert seine Anfrage in natürlicher Sprache, und das Modell übersetzt:

User: Create a high-priority task to prepare the MCP demo

Vibe: [Calling create_task with the following arguments]
  - title: "Prepare the MCP demo"
  - priority: "high"

  → Do you want to authorize this tool call?

User: [Authorize]

Vibe: The task "Prepare the MCP demo" has been successfully created
with high priority. Its ID is abc123.

Dieser Bestätigungsaufforderung entspricht das Standardverhalten. Sie können diese ad hoc genehmigen oder ein Tool auf permanente Autorisierung umstellen. Lassen Sie sich nicht verführen, dies für jeden Server zu tun, den Sie nicht besitzen. Die Bestätigung schützt nicht nur vor Fehlern; sie ist Ihre einzige Verteidigung gegen Prompt-Injection-Angriffe, bei denen in von einem Tool zurückgegebenen Daten versteckte Anweisungen das Modell dazu bringen, Aufrufe durchzuführen, die niemand angefordert hat. Das Sehen der Argumente, bevor sie validiert werden, ermöglicht es Ihnen, die Anomalie zu erkennen.

Wenn es nicht funktioniert

Die Meldung “Unable to connect” (Verbindung nicht möglich) stammt fast immer aus einem dieser vier Gründe: Die URL ist von außen nicht erreichbar, das Protokoll ist kein HTTPS (was Vibe erfordert), der Server läuft einfach nicht, oder CORS ist nicht konfiguriert, obwohl Vibe Anfragen aus einem Browser sendet. Der folgende Befehl unterscheidet in Sekunden zwischen den ersten beiden Hypothesen:

# Test accessibility
curl -X POST https://your-url/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Wenn die Verbindung erfolgreich ist, aber keine Tools erscheinen, verfolgen Sie die Kette auf der Server-Seite zurück: Stellen Sie sicher, dass der @app.tool()-Decorator auf jeder Funktion vorhanden ist, dass keine Docstrings fehlen und dass der MCP-Server auf dem Route-Mount liegt, das Sie erwarten. Verwenden Sie den MCP Inspector vor jeder anderen Untersuchung.

Der verwirrendste Fall ist, wenn alles funktioniert, das Modell aber das falsche Tool aufruft oder keines überhaupt. Das Problem ist dann nicht technisch: Das Modell wählt basierend auf Beschreibungen, und wenn zwei Tools ähnlich aussehen oder eines vage bleibt, wählt es schlecht. Nutzen Sie drei Hebel in dieser Reihenfolge: Machen Sie die Beschreibung spezifischerer, indem Sie den Anwendungsfall klären, benennen Sie das Tool um, um Mehrdeutigkeiten zu beseitigen, und reduzieren Sie die Anzahl der gleichzeitig aktiven Tools. Schließlich, wenn ein Tool einen Fehler zurückgibt, prüfen Sie die Server-Logs, spielen Sie den Aufruf manuell im Inspector nach und stellen Sie sicher, dass Umgebungsvariablen gesetzt sind und dass der Token oder OAuth-Berechtigungen die erwarteten Berechtigungen gewähren.

Der MCP Inspector: Nutzen Sie ihn vor Vibe

Der Inspector testet Ihre Tools, ohne das Modell einzubeziehen, und isoliert damit die Hälfte der Variablen im Problem:

npx @modelcontextprotocol/inspector

Er öffnet eine Benutzeroberfläche, in der Sie sich über die URL Ihres Remote-Servers verbinden, alle Tools mit ihren Beschreibungen und Parametern auflisten, ein Tool mit beliebigen Argumenten ausführen und die rohe Serverantwort lesen. Machen Sie es zur Gewohnheit, diese Prüfung systematisch durchzuführen, bevor Sie einen Server in Vibe hinzufügen, da er Ihnen eine sofortige Diagnose liefert: Wenn ein Tool im Inspector korrekt reagiert, aber in Vibe fehlschlägt, liegt der Server nicht am Problem, und das Problem liegt bei der Beschreibung oder dem Prompt.

Leben mit mehreren Servern

Sobald Sie mehrere Verbinder installiert haben, wird Disziplin zum primären Faktor für die Qualität. Vibe ermöglicht es Ihnen, jeden Verbinder umzuschalten: Aktivieren Sie nur die Tools, die für die aktuelle Aufgabe notwendig sind, da ein Modell, das in fünfzig Tools ertrinkt, weniger genau wählt und langsamer reagiert. Diese Hygiene stützt sich auf die Domänen-Trennung aus Lektion 10 – ein Server für Projektmanagement, einer für Monitoring, einer für interne Tools – da Sie dann nur den einen aktivieren müssen, der zur aktuellen Konversation passt.

Passen Sie schließlich Ihre Prompts an die tatsächlich exponierten Fähigkeiten an:

# Good: reflects tool capabilities
"Create a high-priority task titled 'Prepare the demo'"

# Bad: too vague, the model doesn't know which tool to use
"Manage my project"

Ein letzter Punkt, den Sie vor dem Design Ihrer Server kennen sollten: In Vibe konfigurierte MCP-Verbinder bleiben auch in der mobilen App verfügbar. Ihre internen Tools werden somit von einem Telefon aus zugänglich, was Einsatzszenarien im Feld eröffnet, die Sie möglicherweise nicht bedenken, wenn Sie auf einem Desktop entwickeln.

Kernaussagen

  • Das Hinzufügen eines benutzerdefinierten Connectors in Vibe erfordert 3 Schritte: Name, URL, Authentifizierung
  • Halten Sie die manuelle Bestätigung von Tool-Aufrufen für die Sicherheit aktiv
  • Nutzen Sie den MCP Inspector, um zu testen und zu debuggen, bevor Sie in Vibe integrieren
  • Verbessern Sie die Tool-Beschreibungen, wenn das Modell sie nicht korrekt verwendet
  • Aktivieren Sie nur die Tools, die für die aktuelle Aufgabe notwendig sind
  • Ihre MCP-Server sind auch auf Mobilgeräten zugänglich