Een eigen MCP-server toevoegen
Met een eigen MCP-server verbindt u AI-Public met een zaaksysteem, archief, databron of andere 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.organisatie.nl/mcp
Het endpoint moet HTTPS gebruiken, zonder redirect via publieke DNS bereikbaar zijn en een geldige MCP initialize-handshake beantwoorden. Gebruikersnamen en wachtwoorden horen niet in de URL. Lokale adressen, private netwerkadressen en cloudmetadata-endpoints worden geblokkeerd.
Een server toevoegen
- Open Voorkeuren → Tools.
- Kies Tools toevoegen of MCP-server toevoegen.
- Bekijk 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 uw standaardtoolset.
Een beheerder kan via Beheer → Tools → MCP een server voor de hele omgeving registreren.
Authenticatie en secrets
AI-Public 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 en informatiebeveiliging
Geef alleen tools vrij die gebruikers werkelijk nodig hebben. Een MCP-server kan lees- én schrijfacties aanbieden. AI-Public filtert ontdekte tools tegen een server-side allowlist en controleert omgeving, eigenaar en rol bij ieder gebruik. De organisatie blijft verantwoordelijk voor passende scopes, logging, bewaartermijnen en autorisatie in het bronsysteem.
Lokale desktopservers
Een lokale stdio-server installeert u in de desktopapp. Command, argumenten, environmentkeys en gevraagde toegang worden begrensd en vóór goedkeuring getoond. Secrets worden lokaal versleuteld.
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 allowlist, roltoegang en actieve status.
- Werkt alleen op desktop: waarschijnlijk gebruikt de server stdio of een lokaal adres.
