Danske adresser i Claude, Cursor og andre AI-værktøjer med MCP

Model Context Protocol (MCP) er en standard, der lader en AI-assistent kalde værktøjer. Med @danadresse/mcp-server kan Claude, Cursor og andre MCP-klienter slå danske adresser op, rense dem, finde nærmeste adresse til en koordinat og hente administrative områder og ejendomsdata.

Serveren kører lokalt på din maskine via npx og kalder vores API med din nøgle. Du skal bruge Node 18.17 eller nyere. Vil du ikke installere noget, så brug den hostede server på https://api.danadresse.dk/mcp (se nedenfor).

1. Lav og test en nøgle#

Opret en live-nøgle under Nøgler. Brug ikke en testnøgle eller en domænelåst browsernøgle. Begge virker til adresseopslag, men værktøjerne til DAGI, ejendomsdata, afstand og kvalitetsscore kalder /api/v1/enrich/…, og der svarer de med 403 (sandbox_scope eller browser_key_scope).

Tjek nøglen, før du konfigurerer klienten:

curl -s "https://api.danadresse.dk/autocomplete?q=R%C3%A5dhuspladsen%201&per_side=1" \
  -H "X-Api-Key: $DANADRESSE_API_KEY"

2. Tilføj serveren til din klient#

Serveren læser tre miljøvariabler:

Claude Desktop#

Rediger claude_desktop_config.json. På macOS ligger den i ~/Library/Application Support/Claude/, på Windows i %APPDATA%\Claude\:

{
  "mcpServers": {
    "danadresse": {
      "command": "npx",
      "args": ["-y", "@danadresse/mcp-server"],
      "env": {
        "DANADRESSE_API_KEY": "dawa_live_din_nøgle"
      }
    }
  }
}

Genstart Claude Desktop. danadresse skal nu stå blandt værktøjerne.

Claude Code#

Tilføj serveren fra terminalen:

claude mcp add danadresse \
  --env DANADRESSE_API_KEY=dawa_live_din_nøgle \
  -- npx -y @danadresse/mcp-server

Vil du dele opsætningen med dit team via repoet, så læg en .mcp.json i projektets rod. Claude Code udfylder ${DANADRESSE_API_KEY} fra miljøet, så nøglen ikke havner i Git:

{
  "mcpServers": {
    "danadresse": {
      "command": "npx",
      "args": ["-y", "@danadresse/mcp-server"],
      "env": {
        "DANADRESSE_API_KEY": "${DANADRESSE_API_KEY}"
      }
    }
  }
}

Cursor#

Læg konfigurationen i ~/.cursor/mcp.json (for alle projekter) eller .cursor/mcp.json i et projekt:

{
  "mcpServers": {
    "danadresse": {
      "command": "npx",
      "args": ["-y", "@danadresse/mcp-server"],
      "env": {
        "DANADRESSE_API_KEY": "dawa_live_din_nøgle"
      }
    }
  }
}

Andre klienter, der understøtter MCP over stdio, virker på samme måde: kommandoen er npx -y @danadresse/mcp-server, og nøglen gives som miljøvariabel.

Hostet server uden installation#

Har du ikke Node, eller bruger du Claude.ai, ChatGPT eller n8n, så forbind klienten direkte til vores hostede MCP-server på https://api.danadresse.dk/mcp. Den bruger Streamable HTTP og svarer kun på POST. Log ind med din egen nøgle i X-Api-Key eller Authorization: Bearer. Klienter, der ikke kan sætte headere (connector-skærmene i Claude.ai og ChatGPT), kan sætte nøglen som ?api_key= i URL'en. Lav en separat nøgle til det, så du kan tilbagekalde den alene.

I Claude Code:

claude mcp add --transport http danadresse https://api.danadresse.dk/mcp \
  --header "X-Api-Key: $DANADRESSE_API_KEY"

Tjek, at serveren svarer med din nøgle. tools/list tæller ikke som et kald:

curl -s -X POST "https://api.danadresse.dk/mcp" \
  -H "X-Api-Key: $DANADRESSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Opsætningen til Claude.ai, ChatGPT, Cursor, VS Code og n8n står på AI-siden.

3. Kend værktøjerne#

Serveren giver assistenten elleve værktøjer. Den hostede server har de samme og et tolvte, quota_status, der viser månedens MCP- og API-forbrug for nøglen:

enrich_with_dagi, property_data og distance_between skal have id'er på adgangsadresser. Et forslag fra autocomplete_address er som regel en adresse (med etage og dør), og dens adgangsadresse-id står i data.adgangsadresseid. Assistenten finder normalt selv ud af det, men det hjælper at nævne det, hvis den får 404.

4. Kend MCP-kvoten#

Kald fra MCP-serveren har deres egen månedskvote, adskilt fra API-kvoten. Serveren sender en User-Agent, der starter med danadresse-mcp, og det er den, vi tæller på. Kald gennem den hostede server tæller i samme kvote:

På Hobby er MCP-kvoten et loft. Efter kvoten og en buffer på 20 % svarer API'et 429 quota_exceeded til næste måned, mens dine almindelige API-kald fortsætter. Én besked til assistenten kan give flere værktøjskald, fordi den ofte først søger og derefter slår op eller beriger.

Serveren prøver selv igen ved 429, 502, 503 og 504 med backoff. Får du stadig fejl, så se på forbruget i dashboardet.

5. Prøv det#

Eksempler på beskeder, der bruger værktøjerne:

Find adressen Rådhuspladsen 1 i København, og fortæl hvilket sogn og hvilken politikreds den hører til.

Hvad er den nærmeste adresse til GPS-punktet 55.6761, 12.5683?

Rens denne adresse fra et CRM: "Raadhuspladsn 1, 1550 Kbh V". Er den sikker nok til at gemme?

Hvor langt er der i luftlinje mellem Strandvejen 100, 2900 Hellerup og Rådhuspladsen 1, 1550 København V?

Hvilken by har postnummer 8000, og hvilken kommune hører kode 0751 til?

Assistenten vælger selv værktøjerne. I Claude Desktop og Claude Code kan du se hvert kald og dets svar, før det bliver brugt i svaret.

Næste skridt#

• Platformsiden for MCP: /integrationer/mcp.
• Hold øje med kvoten: Overvåg forbruget.
• Skift nøglen uden nedetid: Rotér API-nøgler.