MCP-klienter

Med Registeropslag Beta kan en MCP-klient slå op i CVR, Retsinformation, Danmarks Statistik og Folketinget. Klienten forbinder til https://mcp.komplai.dk/mcp over Streamable HTTP og sender din personlige API-nøgle som Bearer-header ved hver forespørgsel. Registeropslag beskriver værktøjerne.

Før du går i gang

Organisationens aftale omfatter Registeropslag, og en administrator har givet dig adgang til det.
API-adgangen til Registeropslag er slået til for din konto, så du kan oprette en nøgle med mcp:read. Er den ikke det, står det i Registeropslag i hubben.
Registeropslag er kun godkendt til testdata.

Opret en nøgle

Åbn Registeropslag (/modules/mcp) i hubben. Siden viser adressen og konfigurationen til dit miljø.
Vælg Opret nøgle til Registeropslag. Det åbner API-nøgler med Registeropslag valgt.
Giv nøglen et navn, fx efter klienten og computeren, og vælg, hvor længe den skal gælde.
Se under Kontrollér adgangen, at mcp:read er valgt, og vælg Opret API-nøgle.
Kopiér nøglen. Den vises kun én gang.

Nøglen starter med kp_live_ og er bundet til dig og organisationen. Den giver kun adgang til det, du selv har adgang til.

Forbind VS Code

Kør MCP: Open User Configuration fra kommandopaletten i VS Code.
Flet konfigurationen herunder ind i dine eksisterende indstillinger.
Start serveren komplai. VS Code spørger efter nøglen i et skjult felt, så den ikke havner i en fil.

VS Code-konfiguration

{
  "inputs": [
    {
      "type": "promptString",
      "id": "komplai-api-key",
      "description": "komplai personal API key (mcp:read)",
      "password": true
    }
  ],
  "servers": {
    "komplai": {
      "type": "http",
      "url": "https://mcp.komplai.dk/mcp",
      "headers": {
        "Authorization": "Bearer ${input:komplai-api-key}"
      }
    }
  }
}

Det er den konfiguration, Registeropslag i hubben laver. Den indeholder ingen nøgle. Den virker i VS Codes extension host, ikke i Agent Host-sessioner. Se VS Codes konfigurationsreference for MCP.

Andre klienter

En anden MCP-klient virker, hvis den understøtter Streamable HTTP og kan sende en fast Authorization: Bearer-header med din personlige API-nøgle. Nøgler accepteres aldrig i adressen. Hold nøglen ude af delt konfiguration og kommandohistorik: brug klientens lager til hemmeligheder eller en miljøvariabel.

Du kan kontrollere nøglen og forbindelsen uden en klient ved at starte en session med initialize:

Shell

curl -i https://mcp.komplai.dk/mcp \
  -H "Authorization: Bearer $KOMPLAI_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"connection-check","version":"1"}}}'

En nøgle, der virker, giver initialize-svaret og en Mcp-Session-Id-header. Uden nøgle svarer serveren 401 api_key_required. Sæt KOMPLAI_MCP_SESSION_ID til Mcp-Session-Id fra svaret, og luk sessionen igen med samme nøgle:

Shell

curl -X DELETE https://mcp.komplai.dk/mcp \
  -H "Authorization: Bearer $KOMPLAI_TOKEN" \
  -H "Mcp-Session-Id: $KOMPLAI_MCP_SESSION_ID" \
  -H "MCP-Protocol-Version: 2025-03-26"

Når du lukker en session, bliver nøglen ikke tilbagekaldt.

Sessioner og grænser

En session er bundet til organisationen, til dig og til nøglen. En anden nøgle eller en tilbagekaldt nøgle kan ikke bruge den.
En nøgle kan have 5 sessioner ad gangen. En session slutter efter 30 minutter uden aktivitet.
En forespørgsel må højst fylde 4 MiB.
Adgangen kontrolleres igen ved hver forespørgsel og hvert kald af et værktøj, så en tilbagekaldt eller udløbet nøgle eller en fjernet tildeling holder op med at virke med det samme.
Opslag følger din kontos grænser for forespørgsler.

Pseudonymisér tekst fra klienten

Klienten viser også værktøjer til at finde personoplysninger, pseudonymisere tekst og sætte de oprindelige oplysninger tilbage; de virker kun, når samme nøgle har redact:detect, og du har adgang til Redact. De bruger kun regex og finder ikke navne.

Hvor data sendes hen

Søgeoplysningerne sendes til det register, du slår op i.
Registeropslag kører på komplais EU-infrastruktur i Tyskland.
Opslag og regex bruger ingen AI og tæller ikke med i AI-forbruget eller i organisationens loft for AI-forbrug.
komplai gemmer ikke tekst, forespørgsler eller lister over betegnelser i hændelsesloggen. Metadata om adgang og forbrug registreres.

Tilbagekald adgangen

Tilbagekald nøglen under API-nøgler (/api-access) i hubben. Klientens sessioner holder op med at virke med det samme.