Een eigen MCP-server toevoegen
Met een eigen MCP-server verbind je AI-School met een eigen applicatie, databron of gespecialiseerde dienst. Kies eerst welk transport bij de plaats van gebruik past.
Kies het juiste transport
| Transport | Web | Mobiel | Desktop | Gebruik |
|---|---|---|---|---|
| Streamable HTTP | Ja | Ja | Ja | Aanbevolen voor gehoste servers |
| stdio | Nee | Nee | Ja | Lokale processen en desktopintegraties |
| SSE | Alleen bestaande configuraties | Alleen bestaande configuraties | Ja | Verouderd transport; kies voor nieuwe servers Streamable HTTP |
Vereisten voor Streamable HTTP
Gebruik het volledige publieke endpoint, inclusief het MCP-pad, bijvoorbeeld:
https://mcp.example.nl/mcp
Het endpoint moet:
- HTTPS gebruiken;
- zonder gebruikersnaam of wachtwoord in de URL werken;
- geen redirect nodig hebben;
- via publieke DNS bereikbaar zijn;
- een geldige MCP
initialize-handshake beantwoorden; - een expliciete set toegestane tools hebben.
Lokale adressen, private netwerkadressen en cloudmetadata-endpoints worden geblokkeerd. Daardoor kun je een server op localhost niet vanuit de webapp registreren.
Een server toevoegen
- Open Voorkeuren → Tools.
- Kies Tools toevoegen of MCP-server toevoegen.
- Bekijk eerst de beschikbare presets.
- Kies Zelf een MCP-server toevoegen.
- Vul naam, volledig endpoint en authenticatiemethode in.
- Sla de configuratie op en wacht op de verbindingscontrole.
- Zet de server aan voor je standaardtoolset.
Een beheerder kan via Beheer → AI-instellingen → Tools → MCP ook een server voor de hele omgeving registreren.
Authenticatie en secrets
AI-School ondersteunt connector-OAuth en statische secrets. OAuth-tokens, refresh tokens, API-sleutels en wachtwoorden staan in server-only opslag. Een chat ontvangt alleen de geregistreerde connectorId, nooit de geheime configuratie.
Bij een gewijzigde URL of authenticatie wordt de nieuwe configuratie eerst opnieuw gecontroleerd. Als die controle mislukt, kan een eerder goedgekeurde configuratie actief blijven totdat het probleem is opgelost.
Toolrechten
Geef alleen de tools vrij die gebruikers werkelijk nodig hebben. Een MCP-server kan lees- én schrijfacties aanbieden, zoals bestanden verwijderen, e-mail versturen of records wijzigen. AI-School filtert de ontdekte tools tegen de server-side allowlist, maar de serverbeheerder blijft verantwoordelijk voor passende scopes en autorisatie.
Lokaal testen
Een lokale stdio-server test je in de desktopapp. De renderer mag geen willekeurige shellcommando's starten: installatie verloopt via een goedgekeurde preset of de beveiligde desktopflow. Command, argumenten, environmentkeys en gevraagde toegang worden vóór installatie getoond.
Problemen oplossen
- Endpoint niet bereikbaar: controleer HTTPS, DNS, firewall en het volledige
/mcp-pad. - Opnieuw verbinden vereist: vernieuw OAuth-toestemming of het opgeslagen secret.
- Hoort bij een andere omgeving: registreer de connector opnieuw binnen de huidige omgeving.
- Geen tools zichtbaar: controleer de tool-allowlist, je MCP-toegang en of de server actief staat.
- Werkt alleen op desktop: waarschijnlijk gebruikt de server stdio of een lokaal adres.
