<!-- Eigen MCP-servers koppelen -->
<!-- canonical: https://plainwater.ai/nl/wiki/bronnen/eigen-mcp-servers -->
# Eigen MCP-servers koppelen

Veel organisaties hebben eigen MCP-servers, en er zijn publieke MCP-servers met documentatie die voor iedereen nuttig
zijn. Plainwater AI kan zulke servers koppelen. De agent praat daarbij niet rechtstreeks met de externe server: het
platform is de tussenpersoon en elke aanroep gaat door dezelfde poort als de eigen tools.

## Waarom via het platform

Als een agent rechtstreeks met een externe server zou praten, zou hij daarvoor een token of wachtwoord nodig hebben, en
zou niemand bijhouden wat er heen en weer gaat. Via het platform:

- krijgt de agent nooit een credential;
- worden namen in argumenten en resultaten net zo behandeld als bij de eigen tools;
- staat elke aanroep in de audit;
- gelden de datatoegangsregels van klant en bron.

## Drie bereiken

| Bereik | Voorbeeld | Wie zet het aan |
| --- | --- | --- |
| **Platform** | Een publieke documentatieserver | Per klant aan te zetten |
| **Klant** | De interne MCP-server van de klant | Voor die ene klant |
| **Bron** | Een MCP-server die bij één bron hoort | Volgt de bronnen van de opdracht |

## De serververklaring

Voordat een externe server actief wordt, legt een mens een **verklaring** vast:

- welk soort data de tools teruggeven (alleen metrics, of ook waarden);
- de classificatie (bijvoorbeeld klantdata);
- een reden;
- een verantwoordelijke.

De effectieve stand is de strengste van drie: de spelregels van de klant, de stand van de bron en de verklaring. Een
server die klantdata teruggeeft, kan alleen draaien met actieve pseudonimisering.

:::warning Wat het platform niet kan weten
Pseudonimisering werkt op namen die het platform kent. Een externe server kan iets teruggeven wat het platform nooit
eerder heeft gezien. Dat restrisico is precies waarom de verklaring een besluit van een mens is, met een naam erbij.
:::

## Goedkeuring per tool

Elke tool van een externe server wordt apart goedgekeurd. Bij goedkeuring legt het platform een vingerafdruk vast van de
beschrijving en het schema van de tool. Verandert de server die beschrijving later, dan wordt de tool onzichtbaar en
geweigerd tot iemand hem opnieuw goedkeurt. Zo kan een externe server niet ongemerkt een tool van betekenis laten
veranderen.

## Schrijftools

Een tool die iets wijzigt, voert de agent niet zelf uit. De aanroep wordt een **voorstel**. Een mens ziet wat er zou
gebeuren en keurt goed of af. Pas na goedkeuring voert het platform de aanroep uit.

## Hoe je een server koppelt

1. Voer het adres van de MCP-server in en kies het bereik.
2. Stel de aanmelding in. Het geheim wordt versleuteld opgeslagen en de agent krijgt het nooit te zien.
3. Het platform haalt de lijst met tools op.
4. Leg de verklaring vast.
5. Keur de tools goed die agents mogen gebruiken.
6. Zet de server aan.

## Voorbeeld

Een bank heeft een interne MCP-server die het datawoordenboek ontsluit: definities van begrippen en eigenaren per
tabel. De beheerder koppelt die als klantserver met de verklaring "alleen metadata, geen klantdata", keurt de leestools
goed en laat de tool die definities wijzigt uit. Agents die voor deze bank werken, kunnen nu bij elke analyse de
officiële definitie van "actieve klant" opzoeken, en die aanroepen staan in de audit.

:::tip Lees verder
- [Bronnen en connectoren](https://plainwater.ai/nl/wiki/bronnen/overzicht)
- [Veiligheidsgaranties](https://plainwater.ai/nl/wiki/veiligheid/garanties)
:::