MCP-server til AI-agenter

Endpoint og protokol

• Forbrug: hvert vellykket tools/call tæller som ét kald, præcis som et REST-kald. initialize, tools/list, ping og værktøjskald, der fejler, faktureres ikke.
• Grænser: samme nøgle, burst-grænse og månedskvote som REST. Rammer agenten en grænse, svarer serveren HTTP 429 med Retry-After. Se Rate limits.
• Fejl: et værktøj, der fejler (ugyldigt argument, ukendt BFE, en kilde der er nede), svarer med isError: true og API’ets fejltekst i resultatet — ikke med en protokolfejl. Et ukendt værktøjsnavn er JSON-RPC-fejl -32601.
• Testnøgler virker også, så du kan bygge og teste en agent uden at blive faktureret.

Værktøjerne

Hvert værktøj svarer til et REST-endpoint og returnerer den samme JSON som tekst i content. tools/list returnerer den aktuelle liste med JSON Schema for argumenterne.

Agenten får kun offentlige registerdata i samme form som REST. Koordinater er WGS84 lon/lat og skal ligge i Danmark.

Opsætning

Claude Code

claude mcp add --transport http grundfast https://api.grundfast.dk/mcp \
  --header "Authorization: Bearer gf_live_..."

Claude Desktop

Claude Desktops konfigurationsfil tager lokale servere (en kommando), ikke en fjern-URL med headere. Brug broen mcp-remote, som kører lokalt via npx (kræver Node) og videresender til Grundfast med din nøgle:

{
  "mcpServers": {
    "grundfast": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.grundfast.dk/mcp",
        "--header",
        "Authorization:${GRUNDFAST_AUTH}"
      ],
      "env": {
        "GRUNDFAST_AUTH": "Bearer gf_live_..."
      }
    }
  }
}

Bemærk, at der ikke er mellemrum efter kolonet i Authorization:${GRUNDFAST_AUTH}; mellemrummet ligger i værdien af GRUNDFAST_AUTH. Det undgår, at argumentet bliver delt i to. Genstart Claude Desktop efter ændringen.

Cursor

{
  "mcpServers": {
    "grundfast": {
      "url": "https://api.grundfast.dk/mcp",
      "headers": { "Authorization": "Bearer gf_live_..." }
    }
  }
}

ChatGPT og OpenAI

ChatGPTs forbindelser til egne MCP-servere understøtter OAuth eller ingen godkendelse, ikke en fast Bearer-header, så Grundfast kan ikke tilføjes dér. Via OpenAI’s Responses API kan du derimod angive headeren på MCP-værktøjet:

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-4.1",
    tools=[
        {
            "type": "mcp",
            "server_label": "grundfast",
            "server_url": "https://api.grundfast.dk/mcp",
            "headers": {"Authorization": "Bearer gf_live_..."},
            "require_approval": "never",
        }
    ],
    input="Hvornår er hovedbygningen på BFE 5651067 opført, og hvad er taget lavet af?",
)
print(response.output_text)

Andre MCP-klienter, der understøtter Streamable HTTP med egne headere, forbindes på samme måde: URL’en ovenfor og Authorization-headeren.

Rå JSON-RPC

Vil du teste serveren uden en klient, kan du sende beskederne med curl. Hver besked er ét JSON-objekt; batches af flere beskeder understøttes ikke.

KEY="gf_test_..."

# 1. Håndtryk
curl -s https://api.grundfast.dk/mcp \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# 2. List værktøjerne
curl -s https://api.grundfast.dk/mcp \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. Kald et værktøj
curl -s https://api.grundfast.dk/mcp \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"bbr_ejendom","arguments":{"bfe":5651067}}}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": { "tools": {} },
    "serverInfo": { "name": "grundfast", "title": "Grundfast", "version": "1.0.0" }
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [{ "type": "text", "text": "{\"type\":\"ejendom\",\"bfe_nummer\":5651067, … }" }]
  }
}

Et værktøj, der fejler, svarer med "isError": true og fejlteksten i content. En notifikation (en besked uden id) besvares med 202 uden indhold, og GET på endpointet giver 405. Uden gyldig nøgle svarer serveren 401 med en WWW-Authenticate-header, der beskriver det forventede format.