Ga naar hoofdinhoud

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​

KoppelingPadWat je krijgt
Samen/mcp/userJouw AI regisseert; zwaar werk kun je overdragen aan platformagents
Solo/mcp/soloAlles 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:

{
  "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:

claude mcp add --transport http plainwater https://app.plainwater.ai/mcp/user
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.

Lees verder