# MCP-klienter

> Forbind VS Code eller en anden MCP-klient med Registeropslag over Streamable HTTP med en personlig API-nøgle, uden at nøglen havner i en fil.

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](https://developers.komplai.dk/da/tools/register-lookup) 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

1. Åbn **Registeropslag** (`/modules/mcp`) i hubben. Siden viser adressen og konfigurationen til dit miljø.
2. Vælg **Opret nøgle til Registeropslag**. Det åbner **API-nøgler** med Registeropslag valgt.
3. Giv nøglen et navn, fx efter klienten og computeren, og vælg, hvor længe den skal gælde.
4. Se under **Kontrollér adgangen**, at `mcp:read` er valgt, og vælg **Opret API-nøgle**.
5. 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

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

```json
{
  "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](https://code.visualstudio.com/docs/agents/reference/mcp-configuration).

## 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`:

```bash
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](https://developers.komplai.dk/da/errors/api_key_required). Sæt `KOMPLAI_MCP_SESSION_ID` til `Mcp-Session-Id` fra svaret, og luk sessionen igen med samme nøgle:

```bash
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.

---

https://developers.komplai.dk/da/guides/mcp-clients