Zo voeg je een MCP-server toe aan een AI-assistent

Een externe server: de URL toevoegen

Assistenten die externe MCP-servers accepteren, doen dat meestal via hun instellingen, onder een naam als connectors, integraties, apps of tools; bij team- en zakelijke abonnementen moet een beheerder dit soms eerst toestaan. Je voegt een server toe door een naam en de endpoint-URL op te geven - het Streamable HTTP- of SSE-adres op de pagina van de server.

Als de server inloggen vereist, opent de assistent de eigen inlogpagina van de dienst en bewaart de toegang die je daar verleent. Als de registervermelding een header opgeeft, zoals Authorization met een API-sleutel, heeft de client een veld voor aangepaste headers nodig. Na het verbinden ziet de assistent de tools van de server en kan hij ze in een gesprek aanroepen, meestal met een vraag om bevestiging vóór een actie die iets wijzigt.

Een lokale server: de opdracht toevoegen

Desktop-apps, code-editors en opdrachtregelagents die lokale servers draaien, lezen een configuratie met per server de opdracht, de argumenten en de omgevingsvariabelen. Een gangbare vorm is een JSON-bestand met een mcpServers-object; opdrachtregelagents hebben vaak een opdracht die dezelfde vermelding voor je wegschrijft. De client start elk programma wanneer dat nodig is en stopt het bij het afsluiten.

Voorbeeld (fictieve namen):

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "example-mcp-server@1.2.0"],
      "env": { "EXAMPLE_API_KEY": "<your key>" }
    }
  }
}

Als de verbinding mislukt

De meeste clients tonen per server de status en de lijst met tools. Als een lokale server niet start, voer de opdracht dan uit in een terminal: een ontbrekende runtime (Node.js, uv, Docker) of een ontbrekende omgevingsvariabele is de gebruikelijke oorzaak. Als een externe server wordt geweigerd, controleer dan of de client het transport ondersteunt en of er een header of inloggen nodig is.