Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Een aangepaste server integreren in Vibe

Les 13 van 14 Bijgewerkt op 2 november 2026 Ontwikkelaar
Op deze pagina
  1. Uw MCP-server verbinden met Vibe
  2. De connector toevoegen
  3. Wat er gebeurt in conversatie
  4. Wanneer het niet werkt
  5. De MCP Inspector: gebruik deze vóór Vibe
  6. Omgaan met meerdere servers
  7. Belangrijkste punten

Update 2 november 2026 — Le Chat is nu Vibe. Sinds 28 mei 2026 is Le Chat omgedoopt tot Vibe (nog steeds op chat.mistral.ai): een enkele agent voor werk en code, die uw gesprekken, instellingen en abonnementen overneemt. De legacy-ervaring van Le Chat blijft toegankelijk in de modus Chat; in de modus Work zijn agents vaardigheden geworden (aan te roepen met @), zijn herinneringen de kennisbank geworden en is diep zoeken de vaardigheid Deep Research geworden. Abonnementen heten nu Mistral Free, Pro, Team en Enterprise. Deze les gebruikt de naam Vibe; houd er rekening mee dat sommige hier beschreven menu’s van naam of locatie veranderd kunnen zijn.

Uw MCP-server verbinden met Vibe

Uw server is geïmplementeerd en reageert via HTTPS op een stabiel adres. Nu volgt de stap die al uw eerdere werk betekenis geeft: het bruikbaar maken in conversatie voor uw beoogde publiek, inclusief diejenigen die nooit een terminal zullen openen. Vibe accepteert elke conformerende MCP-server als een aangepaste connector. Deze les behandelt het toevoegen van de connector, het doorlopen van oproepstromen in conversatie en het diagnosticeren van fouten—want de eerste poging mislukt vaak.

De connector toevoegen

Open Vibe op chat.mistral.ai en navigeer naar het tabblad Connectors in de zijbalk. U vindt twee verschillende secties: uitgelichte connectors, vooraf geconfigureerd door Mistral (GitHub, Notion en anderen), en uw eigen aangepaste connectors, in eerste instantie leeg. Klik op Add Custom Connector en vul de velden in:

  1. Name: Een beschrijvende naam (bijv. “Task Manager”)
  2. Server URL: De volledige URL van uw MCP-eindpunt (bijv. https://my-server.com/tasks/mcp)
  3. Description: Wat uw server doet (optioneel maar aanbevolen)

Kies vervolgens uw authenticatiemethode: No authentication voor een openbare server, Token als u uw API-token plakt, of OAuth 2.0 voor een volledige toestemmingsstroom. Door op Connect te klikken, start de detectie: als dit slaagt, toont Vibe de lijst met tools die op uw server zijn gevonden, inclusief de naam en beschrijving van elk. Dit is uw eerste echte feedback over de kwaliteit van uw docstrings—u leest ze hier precies zoals het model ze zal ontvangen.

Wat er gebeurt in conversatie

Zodra de verbinding tot stand is gebracht, verschijnt uw server in de sectie Tools van de chat-zijbalk, gemarkeerd met een pictogram dat de beschikbaarheid van externe tools aangeeft. De gebruiker formuleert zijn verzoek in natuurlijke taal en het model vertaalt dit:

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.

Deze bevestigingsprompt is het standaardgedrag. U kunt dit ad hoc goedkeuren of een tool overschakelen naar permanente autorisatie. Verzet u tegen de verleiding om dit te doen voor elke server die u niet zelf bezit. Bevestiging beschermt niet alleen tegen bugs; het is uw enige verdediging tegen prompt-injecties, waarbij instructies die verborgen zijn in gegevens die door een tool worden geretourneerd, het model sturen naar oproepen die niemand heeft gevraagd. Het zien van de argumenten die langs scrollen voordat validatie plaatsvindt, is wat u in staat stelt de anomalie op te sporen.

Wanneer het niet werkt

Het bericht “Unable to connect” komt bijna altijd voort uit een van deze vier oorzaken: de URL is niet bereikbaar van buitenaf, het protocol is geen HTTPS (wat Vibe vereist), de server draait simpelweg niet, of CORS is niet geconfigureerd terwijl Vibe verzoeken vanuit een browser verzendt. Het volgende commando onderscheidt binnen enkele seconden tussen de eerste twee hypothesen:

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

Als de verbinding slaagt maar er geen tools verschijnen, traceer dan de keten terug aan de serverzijde: verifieer dat de decorator @app.tool() aanwezig is op elke functie, dat er geen docstrings ontbreken en dat de MCP-server is gemount op de route waarvan u denkt dat het zo is. Gebruik MCP Inspector voordat u enige andere investigatie start.

Het meest verwarrende geval is wanneer alles werkt, maar het model de verkeerde tool oproept of helemaal geen. Het probleem is dan niet technisch: het model kiest op basis van beschrijvingen, en als twee tools op elkaar lijken of als er één vaag blijft, kiest het slecht. Gebruik drie hefbomen, in deze volgorde: maak de beschrijving specifieker door de use-case te verduidelijken, hernoem de tool om ambiguïteit weg te nemen en verminder het aantal gelijktijdig actieve tools. Tot slot, als een tool een fout retourneert, controleer dan de serverlogs, speel de oproep handmatig af in de inspector en verifieer dat omgevingsvariabelen zijn ingesteld en dat het token of de OAuth-scopes de verwachte rechten verlenen.

De MCP Inspector: gebruik deze vóór Vibe

De inspector test uw tools zonder het model te betrekken, waardoor de helft van de variabelen in het probleem wordt geïsoleerd:

npx @modelcontextprotocol/inspector

Het opent een webinterface waarin u verbinding maakt met uw externe server via de URL, alle tools met hun beschrijvingen en parameters opsomt, een tool uitvoert met argumenten naar keuze en het ruwe serverantwoord leest. Maak er een gewoonte van om deze controle systematisch uit te voeren voordat u een server aan Vibe toevoegt, omdat dit u een onmiddellijke diagnose geeft: als een tool correct reageert in de inspector maar faalt in Vibe, ligt de fout niet bij de server en ligt het probleem bij de beschrijving of de prompt.

Omgaan met meerdere servers

Zodra u meerdere connectors hebt geïnstalleerd, wordt discipline de primaire factor voor kwaliteit. Met Vibe kunt u elke connector in- en uitschakelen: houd alleen de tools actief die nodig zijn voor de huidige taak, omdat een model dat verdrinkt in vijftig tools minder nauwkeurig kiest en langzamer reageert. Deze hygiëne steunt op de domeinscheiding die aan bod kwam in Les 10—één server voor projectbeheer, één voor monitoring, één voor interne tools—omdat u dan alleen diegene hoeft te activeren die overeenkomt met het huidige gesprek.

Pas ten slotte uw prompts aan aan de daadwerkelijk blootgestelde mogelijkheden:

# 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"

Nog één punt dat het weten waard is voordat u uw servers ontwerpt: MCP-connectors die in Vibe zijn geconfigureerd, blijven beschikbaar in de mobiele app. Uw interne tools worden zo toegankelijk vanaf een telefoon, wat gebruiksscenario’s in het veld opent waar u misschien niet aan denkt tijdens het ontwikkelen op een desktop.

Belangrijkste punten

  • Het toevoegen van een aangepaste connector in Vibe kost 3 stappen: naam, URL, auth
  • Houd handmatige bevestiging van tool-oproepen ingeschakeld voor veiligheid
  • Gebruik de MCP Inspector om te testen en fouten op te sporen voordat u integreert in Vibe
  • Verbeter de beschrijvingen van tools als het model ze niet correct gebruikt
  • Houd alleen de tools nodig voor de huidige taak actief
  • Uw MCP-servers zijn ook toegankelijk op mobiel