Verbind een MCP-client

Met MCP (Model Context Protocol) laat je een AI-assistent rechtstreeks je eigen cijfers lezen. De assistent krijgt drie read-only tools: tabellen opsommen, een tabel beschrijven, en een SELECT-query uitvoeren.

Er wordt niets geschreven, en de assistent ziet uitsluitend de tabellen waar jouw account toegang toe heeft.

Het endpoint

https://mcp.custodea.eu/mcp

Eén endpoint voor alle klanten. Je organisatie wordt afgeleid uit je token, niet uit de URL, en niet uit iets dat de client meestuurt.

Kies een methode

Custom connector (aanbevolen)API-sleutel

Voor Claude.ai en andere clients die OAuth ondersteunen. Je logt in met je gewone Custodea-account; er is geen sleutel om te bewaren.

1. Open in Claude.ai Settings → Connectors → Add custom connector.
2. Vul als URL https://mcp.custodea.eu/mcp in.
3. Je wordt doorgestuurd naar Custodea. Log in en bevestig de toegang.
4. Klaar. De connector verschijnt in je lijst.

Toegang intrekken doe je in het dashboard onder Instellingen → Verbonden apps.

Voor clients zonder OAuth, of voor scripts. Iedereen kan zelf een sleutel aanmaken; je hoeft geen beheerder te zijn.

1. Ga naar Dashboard → Instellingen → MCP API-sleutels.
2. Klik Sleutel aanmaken en geef een herkenbaar label.
3. Kopieer de sleutel meteen: hij wordt één keer getoond.

claude_desktop_config.json

{
  "mcpServers": {
    "custodea": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.custodea.eu/mcp",
        "--header", "Authorization: Bearer dfk_live_..."
      ]
    }
  }
}

Een sleutel werkt als jou

Wie deze sleutel gebruikt, ziet precies wat jij ziet. Hij draagt jouw toegang, niet die van hen. Deel 'm dus niet; een collega kan op dezelfde plek een eigen sleutel aanmaken.

Wat de assistent kan

Tool	Wat het doet
list_tables	Alle tabellen in je lake, met rijaantallen
describe_table	Kolommen, types en drie voorbeeldwaarden
query_sql	Eén read-only SELECT, maximaal 10.000 rijen

Alleen SELECT, WITH en UNION worden geaccepteerd. Elke tabelverwijzing moet met het lake-schema beginnen, bijvoorbeeld lake.exact_online_invoices_11111.

Sleutels beheren

Sleutels blijven geldig tot je ze intrekt; er is geen vervaldatum. Roteren doe je door een nieuwe sleutel aan te maken, je client om te zetten, en de oude in te trekken.

De lijst toont je eigen sleutels. Beheerders en eigenaren zien elke sleutel in de organisatie en kunnen die allemaal intrekken.

Bij uitdiensttreding

Trek de sleutels van een vertrekkende medewerker handmatig in, en verwijder diegene uit alle groepen. Alleen het account op inactief zetten is niet genoeg.

Veelvoorkomende fouten

unauthorized bij elke aanroep

De sleutel is ingetrokken, of je gebruikt een testsleutel (dfk_test_) tegen de productieomgeving. Sleutels zijn niet uitwisselbaar tussen omgevingen.

your workspace data access is still being set up

Je persoonlijke data-identiteit wordt aangemaakt. Dit duurt normaal een paar seconden; probeer het opnieuw.

rate limit exceeded

Er geldt een limiet per organisatie en per sleutel. De Retry-After-header geeft aan hoelang je moet wachten.