Met een MCP-verbinding kan je Hand tools op een andere server gebruiken. Een connector uit de catalogus heeft vaak al ingevulde servergegevens. Bij een eigen MCP-server voer je die zelf in. Verbind alleen een server die je kent en vertrouwt.
Voorbereiden
Zorg dat je een geschikte, beschikbare Hand hebt en het openbare HTTPS-adres van de MCP-server kent. Controleer bij de aanbieder welk protocol (Streamable HTTP of SSE) en welke aanmeldmethode nodig zijn. Een MCP-server kan om een account, bearer-token, API-sleutel of aangepaste headers vragen. Deel zulke geheimen niet in je chat of documentatie.
De verbinding instellen
- Open de Hands Console en selecteer de Hand waarvoor je toegang wilt geven.
- Ga naar Integraties → Connectors. Kies een aangeboden connector of druk op + om een aangepaste MCP-server toe te voegen.
- Vul bij een eigen server een herkenbare Verbindingsnaam en het Serveradres in. Kies het transport dat de server ondersteunt.
- Kies bij Authenticatie de vereiste methode: Geen, Bearer-token, API-sleutel of Aangepaste headers. Vul eventuele geheime waarden alleen in het daarvoor bestemde invoerveld in.
- Open Toegang en controleer de reikwijdte: Alleen lezen of Lezen en schrijven. Kies Alleen lezen als Hands de door de aanbieder gedocumenteerde leesacties kan verifiëren. Die mogelijkheid is niet altijd beschikbaar; het formulier kan standaard Lezen en schrijven tonen.
- Lees de bevestiging met de servernaam en gekozen toegang. Vink die uitsluitend aan als je de server vertrouwt. Kies Verifiëren en verbinden.
Controleer bij Lezen en schrijven na het koppelen meteen de actieregels: schrijfbare tools kunnen standaard op Automatisch staan.
De beschikbare velden kunnen verschillen bij een vooraf ingerichte catalogusconnector. Sommige aanbieders leiden je naar hun eigen aanmeldscherm.
Controleren en beheren
Een verbindingspoging kan meerdere stappen doorlopen. Zolang Verbinden… of een voortgangsstap zichtbaar is, is de verbinding nog niet gereed. Wacht op de actuele status in Connectors en controleer in Instellingen → Mogelijkheden hoeveel lees- en actietools beschikbaar zijn. Probeer vervolgens een veilige leesactie.
Bij een verbinding met schrijfrechten bepaal je in Actieregels per niet-leesactie of deze wordt geblokkeerd, ter goedkeuring voorgelegd of automatisch uitgevoerd. Zie MCP-acties goedkeuren of automatiseren. Die regels geven geen extra rechten boven de gekozen servertoegang.
Via Instellingen kun je een verbinding, afhankelijk van de status, Pauzeren, Vernieuwen, Inloggegevens intrekken of Ontkoppelen. Het intrekken van gegevens bij Hands trekt de toestemming niet noodzakelijk ook bij de externe aanbieder in. Bij een fout lees je Een defecte MCP-verbinding herstellen.
Beschikbaarheid: een bruikbaar serveradres, voldoende rechten, een compatibele Hand-runtime en een goedgekeurde verbinding zijn allemaal nodig. Een opgeslagen koppeling alleen bewijst niet dat de server op dit moment bereikbaar is.