<!-- Je eigen AI-tool koppelen via MCP -->
<!-- canonical: https://plainwater.ai/nl/wiki/eigen-ai/mcp-koppelen -->
# Je eigen AI-tool koppelen via MCP

Plainwater AI heeft een MCP-server voor mensen. Daarmee koppel je je eigen AI-tool aan het platform: Claude Code, Codex,
of een andere tool die MCP spreekt, zoals GitHub Copilot in VS Code of Cursor. Je meldt je aan met OAuth; er is geen
API-sleutel die je ergens moet plakken.

## Twee koppelingen

| Koppeling | Pad | Wat je krijgt |
| --- | --- | --- |
| **Samen** | `/mcp/user` | Jouw AI regisseert; zwaar werk kun je overdragen aan platformagents |
| **Solo** | `/mcp/solo` | Alles in jouw AI; het platform maakt geen modelkosten |

Het verschil zit in de toollijst. Een AI-tool vraagt de lijst met tools één keer per verbinding op. Daarom zijn het twee
koppelingen en niet één koppeling met een schakelaar. Een token werkt alleen op het pad waarvoor het is uitgegeven.

## Voorwaarden

- Je hebt een account met toegang tot de klant waarvoor je wilt werken.
- De klant staat lokale sessies toe. Dat staat standaard **uit** en wordt per klant aangezet in de spelregels.
- Je AI-tool ondersteunt MCP over HTTP met OAuth.

## Configuratievoorbeeld

Een generiek voorbeeld voor een MCP-client die een JSON-configuratie leest:

```json
{
  "mcpServers": {
    "plainwater": {
      "type": "http",
      "url": "https://app.plainwater.ai/mcp/user"
    },
    "plainwater-solo": {
      "type": "http",
      "url": "https://app.plainwater.ai/mcp/solo"
    }
  }
}
```

Voor Claude Code kan het ook met één commando:

```bash
claude mcp add --transport http plainwater https://app.plainwater.ai/mcp/user
```

:::warning Controleer de URL in de app
De adressen hierboven zijn voorbeelden. De exacte URL voor jouw omgeving staat in de webapp, bij je profiel onder de
instructies voor lokale sessies.
:::

## Aanmelden

1. Voeg de server toe aan je AI-tool.
2. Bij de eerste aanroep opent je tool een browservenster.
3. Je logt in met je organisatieaccount (Microsoft Entra ID).
4. Je geeft toestemming. De tool krijgt een kortlevend toegangstoken dat alleen voor deze koppeling geldt, plus een
   vernieuwingstoken dat bij elk gebruik roteert.

Het token draagt zelf geen rechten. Bij elke aanroep leest het platform opnieuw uit de database wie je bent en wat je
mag. Trekt een beheerder je rechten in, dan geldt dat bij je volgende aanroep.

## Een sessie starten

Na het koppelen werkt je AI binnen een **sessie** op een opdracht:

1. Je AI vraagt de lijst met jouw opdrachten op, of maakt een nieuwe.
2. Hij start een sessie op die opdracht.
3. Hij kiest de bronnen die bij de opdracht horen, en daarbinnen de bron waarop hij werkt.
4. Hij gebruikt de tools: metadata, kwaliteit, performance, sandbox, en (als de bron dat toestaat) SQL.
5. Hij sluit de sessie af, of draagt het werk over aan het platform.

Per autorisatie loopt er één actieve sessie tegelijk.

## Wat je AI te zien krijgt

Je AI krijgt hetzelfde als een platformagent: namen als pseudoniem bij een klant met echte data, waarden volgens de
stand van de bron, tellingen onder tien als "<10". Je AI ziet van een bron alleen een label dat de beheerder heeft
gekozen, nooit de technische naam.

## Voorbeeld

Een ontwikkelaar voegt `plainwater` toe aan Claude Code en logt in. Hij vraagt: "Welke opdrachten staan er voor klant X
open?" Claude Code toont de lijst, start een sessie op de opdracht "trage nachtelijke laad" en kiest de bron
*warehouse-prod*. Het haalt de zwaarste queries en de ontbrekende indexen op, stelt een index voor en test die in een
wegwerpkopie. Het resultaat staat daarna als oplevering op de opdracht in de webapp.

:::tip Lees verder
- [Drie werkwijzen vergeleken](https://plainwater.ai/nl/wiki/eigen-ai/werkwijzen)
- [Solo](https://plainwater.ai/nl/wiki/eigen-ai/solo)
- [Spelregels per klant](https://plainwater.ai/nl/wiki/beheer/spelregels)
:::