Leveranciers werden het niet eens over het woord. Connector, app, eigen app, plug-in, MCP-server. In het Nederlands zoek je op MCP koppeling. Het object is hetzelfde: een host haakt een server aan die MCP spreekt.
MCP is het woordenboek. MCP uitgelegd voor ondernemers is het plafond. Deze pagina is de stekker.
Wat een koppeling werkelijk is
De host (Claude Desktop, ChatGPT, Grok, Gemini CLI, VS Code, de eigen tools van deze site) maakt één client per server. De server biedt tools (handelingen), resources (leesacties) en prompts (sjablonen) aan.
Twee transporten doen ertoe in dagelijks werk:
- Lokaal stdio. De host start een proces op jouw machine en praat JSON-RPC over de standaardinvoer en -uitvoer daarvan. Het
claude_desktop_config.jsonvan Claude Desktop is het bekendste voorbeeld. Geen netwerk en geen publieke URL. De bestanden die het ziet, zijn de bestanden op die machine, draaiend als jouw gebruiker. - HTTPS op afstand. Streamable HTTP of SSE. Een host in de cloud kan erbij. Een eigen MCP-server in ChatGPT heeft dit nodig (of de Secure MCP Tunnel van OpenAI). Eigen connectors in Grok weigeren localhost; dan tunnel je. Beheerde agents in Gemini haken een
mcp_server-URL op afstand aan.
Die ene scheiding beslist bijna elke “waarom wil dit niet verbinden”-vraag:
| Host | Lokaal stdio | HTTPS op afstand | Waar je het instelt |
|---|---|---|---|
| Claude Desktop | Ja | Ja | claude_desktop_config.json, of beoordeelde Extensions |
| ChatGPT (eigen MCP) | Nee | Ja, verplicht | Developer mode, daarna een publieke HTTPS-URL of de tunnel van OpenAI |
| Grok (connectors op grok.com) | Nee, localhost wordt geweigerd | Ja, verplicht | Connectorinstellingen, publieke URL of een tunnel van xAI |
| Grok CLI | Ja | Ja | grok mcp add |
| Gemini (beheerde agents, CLI) | Alleen CLI | Ja | Agentconfiguratie of CLI-instellingen, Google-credentials of een API-sleutel |
Begint de installatie met npx en zonder publieke URL, dan ziet ChatGPT hem niet totdat je ertussen gaat zitten. Dat is geen fout in je JSON. Dat is de regel dat het alleen op afstand werkt.
Makkelijke koppelingen, vier hosts
Menu’s verschuiven. Controleer de eerstelijnslink voordat je een pad als wet behandelt. De scheiding hierboven is het duurzame deel.
Claude. Desktop kan beoordeelde Extensions installeren, of je plakt een lokale server in claude_desktop_config.json en sluit de app volledig af. De officiële MCP-walkthrough en het helpartikel van Anthropic gebruiken allebei een filesystem-server: npx -y @modelcontextprotocol/server-filesystem plus de mappen die je vrijgeeft. Dat is de makkelijkste echte koppeling: één map, dan een herstart. Let op wat die argumentenlijst doet. De toegestane mappen bepalen de bestandsgrens. Schrijftools hebben nog steeds een review nodig.
ChatGPT. Ingebouwde apps (OpenAI zegt ook nog steeds connectors) zijn kant-en-klare integraties: Gmail, Drive en soortgelijke, aanklikken en inloggen. Eigen MCP is iets anders: developer mode, daarna een app of connector maken die naar een publieke HTTPS MCP-URL wijst, de tools scannen, authenticeren. OpenAI documenteert die verbindingsstroom en beschrijft volledige MCP met schrijfrechten als beta voor Business, Enterprise en Edu. Abonnement en beheerdersbeleid van de werkruimte gelden nog steeds. Plak geen npx-stdio-commando in ChatGPT en verwacht niet dat het opstart.
Gemini. Beheerde agents in de Gemini API kunnen tijdens een interactie een mcp_server-tool op afstand meekrijgen (de agentupdate van Google uit juli 2026). Gemini CLI en Cloud Agent Platform spreken MCP over HTTP met Google-credentials of een API-sleutel. De labels in de consumenten-chat van Gemini veranderen; gebruik de actuele documentatie van Google, geen schermafbeelding uit een verzamelblog.
Grok. Eigen connectors op grok.com hebben een publieke HTTPS-URL nodig. De tunneldocumentatie van xAI stelt dat localhost en RFC1918-adressen worden geweigerd. De Grok CLI kan wel lokaal stdio toevoegen (grok mcp add filesystem -- npx …) of HTTP op afstand. Hetzelfde contract, twee oppervlakken.
Het MCP Registry somt gepubliceerde servers op. Het is een catalogus, geen veiligheidskeuring. De officiële referentieservers (filesystem, fetch, git, memory, time, sequential thinking, everything) leren je het protocol. Ze zijn educatief, niet productieklaar. De ReasonKit van deze site is een gespecialiseerde redeneerserver, geen officiële referentie.
Wanneer hij niet verbindt
De fouten zijn saai en ze herhalen zich. Werk ze in deze volgorde af voordat je het model de schuld geeft.
De server verschijnt niet nadat je de configuratie hebt aangepast. Sluit de desktop-app volledig af, niet alleen het venster. Op macOS blijft de app draaien wanneer je het venster sluit. Valideer daarna de JSON. Een komma te veel is een gangbare oorzaak van een configuratie die de app stil negeert.
De server verschijnt en sterft direct. Draai het exacte commando uit de configuratie in een terminal, als dezelfde gebruiker. Gangbare oorzaken zijn een binary die ontbreekt in de PATH van de app (de app erft je shellprofiel niet) en een relatief pad dat ergens onverwachts uitkomt. Gebruik absolute paden in de configuratie.
Een lokale server verbindt en gedraagt zich daarna vreemd. Bij stdio is de standaarduitvoer het transport. Alles wat een server daar afdrukt en geen geldig protocolbericht is, vervuilt de stroom. Logs gaan naar stderr. Schreef je de server zelf, controleer dan eerst op een vergeten print.
Een server op afstand geeft een 404 of blijft hangen. Bevestig dat de URL het MCP-endpoint is en niet de marketingpagina, en dat hij van buiten je netwerk bereikbaar is. Een verlopen tunnel ziet er precies uit als een kapotte server.
Authenticatielussen. Connectors op afstand met OAuth hebben een callback nodig die de host werkelijk kan bereiken, en een token waarvan het publiek die server is. Een token dat voor iets anders is uitgegeven, is geen vervanging.
Tools staan in de lijst maar worden nooit aangeroepen. Dat is geen verbindingsfout. Controleer de allowlist van de host, daarna de toolnamen en -beschrijvingen. Repareer die voordat je de prompt herschrijft.
Voordat je andermans server aanhaakt
Een koppeling op afstand is een integratie met de infrastructuur van iemand anders, die credentials vasthoudt die jij hebt uitgegeven.
Vijf vragen, op papier, voordat je op verbinden klikt:
- Wie beheert hem? Een bedrijf of onderhouder met een naam, geen GitHub-handle uit een thread.
- Wiens credentials houdt hij vast, en met welke rechten? Eén credential per server. Nooit een gedeeld beheerderstoken.
- Wat logt hij, en krijg je je eigen spoor eruit?
- Lezen of schrijven? Haak altijd eerst de alleen-lezen variant aan, ook wanneer de schrijfvariant één vinkje verderop zit.
- Wat gebeurt er wanneer je hem om 17:00 intrekt? Weet niemand dat, dan heb je geen tool aangehaakt. Dan heb je een afhankelijkheid genomen.
Nog iets dat wordt overgeslagen. Toolbeschrijvingen en tooluitvoer zijn onvertrouwde invoer. Een server beschrijft zijn eigen tools, en een opgehaalde pagina kan tekst bevatten die op een instructie lijkt. De specificatie zegt dat clients toolannotaties niet moeten vertrouwen tenzij de server zelf vertrouwd is, en dezelfde logica loopt door: wat een tool teruggeeft is data, geen opdracht. Een koppeling die het open web leest en ook ergens kan schrijven, is de vorm van het probleem, niet een gemak.
Dagelijkse werkwijze zonder gat
- Beslis lezen of schrijven. Haak eerst een alleen-lezen koppeling aan.
- Wijs een eigenaar aan in de repo of in de notitie bij de instellingen.
- Vul de drie leesacties in: zichtbaarheid, mutatie, log. Kun je dinsdag niet reconstrueren, zet versturen dan niet aan.
- Beoordeel de eerste tien schrijfaanroepen volledig. Gebruik daarna de log om te bepalen of een omkeerbare poort losser kan. Onomkeerbare schrijfacties blijven bewaakt.
- Herlees het helpartikel van de host wanneer de instellingenboom verschuift. Dat gebeurt.
Een koppeling die “gewoon werkt” met schrijfrechten is een junior met rootrechten. De stekker is makkelijk. Het plafond is het werk.