Een aangepaste MCP-connector toevoegen
Op deze pagina
Bijgewerkt op 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 behoudt. De legacy Le Chat-ervaring blijft beschikbaar in de modus Chat; in de modus Work zijn agents nu vaardigheden (aangeroepen met
@), dienen herinneringen als kennisbank en is diep zoeken de vaardigheid Deep Research. Abonnementen heten nu Mistral Free, Pro, Team en Enterprise. Deze les gebruikt de naam Vibe; sommige hier beschreven menu’s kunnen van naam of locatie zijn veranderd.
Voorbij de officiële directory
Ingebouwde connectors dekken veel use-cases, maar uw organisatie maakt waarschijnlijk gebruik van interne tools, propriëtaire API’s of nichediensten die ontbreken in de Vibe-directory. Hier komen aangepaste connectors van pas: u kunt elke externe MCP-server aan Vibe toevoegen door simpelweg de URL op te geven. Die interne CRM die zes jaar geleden is gebouwd, wordt zo bruikbaar in een gesprek, net als GitHub of Notion.
Het toevoegproces
Het toevoegen van een connector kost slechts een paar klikken in de interface. Open het tabblad Connectors, klik onderaan de lijst op Add a custom connector en vul de vereiste gegevens in:
- Name: Een beschrijvende naam om de connector te identificeren (bijvoorbeeld “Internal CRM” of “Weather API”)
- Server URL: Het openbare adres van uw MCP-server, inclusief het
/mcp-endpoint (bijvoorbeeldhttps://mon-serveur.example.com/mcp) - Description: Een korte uitleg over wat de connector doet (optioneel maar aanbevolen)
- Authentication method: None, Token of OAuth 2.0
Klik ten slotte op Create om de connector op te slaan. Vibe vraagt de server automatisch af om beschikbare tools te ontdekken: de lijst met blootgestelde functies verschijnt en u kunt ze direct in uw gesprekken gebruiken.
Dit ontdekkingverzoek retourneert de naam, de tekstuele beschrijving, de verwachte parameters (met hun naam, type en beschrijving) en het return type voor elke tool. Dit zijn de enige details die het Mistral-model gebruikt om te beslissen wanneer en hoe het elke tool aanroept. Daarom richt de volgende les zich sterk op de kwaliteit van de beschrijving. Een goed geschreven tool met een slechte beschrijving blijft onzichtbaar voor het model.
Authenticatiemethoden
De eenvoudigste casus is geen authenticatie: uw MCP-server is toegankelijk voor iedereen die de URL kent. Dit werkt voor openbare tools die geen gevoelige gegevens verwerken, voor prototypes, demo’s en MCP-servers die openbare API’s wrappers. Token-authenticatie houdt in dat u een sleutel opgeeft die bij elk verzoek naar de server wordt meegestuurd; Vibe slaat de token veilig op. Kies hiervoor voor interne API’s die beveiligd zijn met een API-sleutel, servers die de beller moeten identificeren en elk scenario waarin u de toegang wilt beperken. Tot slot is er OAuth 2.0, de volledige flow met omleiding naar de autorisatiepagina van de dienst: dit is het veiligste mechanisme, maar ook het meest complex om serverzijde te implementeren. Dit wordt diepgaand behandeld in toekomstige gidsen van Mistral AI.
Vereisten voor uw MCP-server
- Toegankelijk via een openbare URL (geen localhost)
- Biedt een endpoint in Streamable HTTP-indeling (
/mcp) - Reageert op verzoeken voor tool discovery in standaard MCP JSON-indeling
- Verwerkt tool calls correct en retourneert resultaten in de verwachte indeling
De vereiste van een openbare URL lijkt lokale ontwikkeling in de weg te staan, maar er is een workaround tijdens de debugfase. Als u op uw machine ontwikkelt en met Vibe wilt testen voordat u deployt, opent u een tunnel naar uw lokale server met ngrok:
ngrok http 8000
ngrok geeft u een tijdelijke openbare URL die u als connector-URL in Vibe kunt gebruiken. Deze aanpak is ideaal voor ontwikkeling en testen: u wijzigt uw code, start opnieuw op en Vibe ziet direct de nieuwe versie zonder enige deployment.
Testen met de MCP Inspector
Voordat u uw server aan Vibe toevoegt, test u deze met de MCP Inspector, een open-source tool die verifieert of uw server correct reageert op ontdekkingverzoeken, beschikbare tools met hun beschrijvingen en parameters opsomt, tool calls handmatig uitvoert om resultaten te controleren en helpt bij het debuggen van indelings- of typefouten. Start deze met een eenvoudig npx-commando:
npx @modelcontextprotocol/inspector
De Inspector opent een lokale webinterface waarmee u verbinding maakt met uw MCP-server en elke tool individueel test. Deze stap is niet louter formaliteit: het bespaart u conversatieberichten die u aan debugging zou verspillen en isoleert serverfouten duidelijk van interpretatiefouten van het model.
Organisatiebeheer
Als u deel uitmaakt van een organisatie op Vibe, houd er dan rekening mee dat aangepaste connectors die u toevoegt, zichtbaar zijn voor andere leden. Een beheerder kan elke connector voor de hele organisatie uitschakelen als deze ongepast of onveilig wordt geacht. Elke gebruiker moet echter zijn eigen inloggegevens – token of OAuth – opgeven voor connectors die authenticatie vereisen: het delen van een connector betekent nooit het delen van toegangsgegevens.
Beveiliging van aangepaste connectors
In tegenstelling tot officiële connectors die door Mistral AI zijn gevalideerd, kan een aangepaste connector willekeurige code serverzijde uitvoeren en garandeert de tekstbeschrijving die u ziet niets over wat de server daadwerkelijk doet. Houd het bij servers die u zelf hebt ontwikkeld, die van vertrouwde collega’s of partners, en open-source servers waarvan u de code hebt geverifieerd. Zelfs bij uw eigen connectors houdt u menselijke validatie ingeschakeld tijdens de hele debugfase; zodra u zeker weet dat alles werkt, kunt u overwegen read-only tools in te stellen op “Always Allow”.
Belangrijkste punten
- U kunt elke externe MCP-server als aangepaste connector aan Vibe toevoegen
- De server moet toegankelijk zijn via een openbare URL met een
/mcp-endpoint - Drie authenticatiemethoden worden ondersteund: none, token en OAuth 2.0
- Gebruik ngrok om uw lokale server met Vibe te testen voordat u deployt
- De MCP Inspector is essentieel om uw server te debuggen voordat u deze integreert
- Voeg alleen connectors toe van vertrouwde bronnen en houd menselijke validatie ingeschakeld