MCP-server

Het endpoint#

Tools#

Elke tool leest alleen en wijzigt niets. Argumenten worden precies zo gevalideerd als de bijbehorende route haar parameters valideert.

Het argument company toont de gebruikelijke eigenschappen (postcode, gewest, grootte, werknemers, omzet, balanstotaal, NACE-codes, rechtsvorm, oprichtingsdatum, de-minimissteun) en aanvaardt elke eigenschap van een matchrequest. Een resultaat komt terug als tekst (opgemaakte JSON) en als structuredContent. Een tool die faalt (een ongeldig argument, een plan dat de sleutel niet heeft, een opgebruikte hoeveelheid) geeft een resultaat met isError: true en de API-fout in structuredContent.error, zodat het model kan lezen wat er misging; alleen een misvormd bericht is een JSON-RPC-fout.

Een client koppelen#

Claude Code

$ claude mcp add --transport http subsido https://api.subsido.be/mcp \  --header "Authorization: Bearer sb_live_..."

Of in de .mcp.json van een project, met de sleutel uit de omgeving zodat hij niet mee gecommit wordt:

{
  "mcpServers": {
    "subsido": {
      "type": "http",
      "url": "https://api.subsido.be/mcp",
      "headers": {
        "Authorization": "Bearer ${SUBSIDY_API_KEY}"
      }
    }
  }
}

Claude Desktop

Claude Desktop start lokale servers vanuit zijn configuratiebestand, dus een externe server met een sleutel loopt via de brug mcp-remote (die Node.js nodig heeft). In claude_desktop_config.json (Settings, Developer, Edit config):

{
  "mcpServers": {
    "subsido": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.subsido.be/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sb_live_..."
      }
    }
  }
}

De header gaat via een omgevingsvariabele omdat sommige systemen argumenten splitsen op de spatie in Bearer …. Herstart Claude Desktop na de wijziging.

Andere clients

Elke client die Streamable HTTP spreekt en een header kan meesturen, werkt: geef hem de URL en de header Authorization. Veel clients (Cursor, VS Code, Windsurf) nemen een JSON-blok van deze vorm:

{
  "mcpServers": {
    "subsido": {
      "url": "https://api.subsido.be/mcp",
      "headers": {
        "Authorization": "Bearer sb_live_..."
      }
    }
  }
}

Een client die alleen lokale servers draait, kan de brug mcp-remote gebruiken zoals hierboven.

Met de hand#

Omdat de server stateless is, is curl een volwaardige client. Vraag de tools op en roep er dan een aan:

$ curl -X POST "https://api.subsido.be/mcp" \  -H "Authorization: Bearer sb_live_..." \  -H "Content-Type: application/json" \  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

$ curl -X POST "https://api.subsido.be/mcp" \  -H "Authorization: Bearer sb_live_..." \  -H "Content-Type: application/json" \  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "match_company", "arguments": {"company": {"postcode": "4000", "employees": 8, "legal_form": "srl"}, "project": {"topics": ["digitalisation"], "budget_eur": 15000}, "language": "fr", "limit": 5}}}'

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"matches\": [ … ],\n  \"matched\": 9,\n  …\n}"
      }
    ],
    "structuredContent": {
      "matches": [
        "…"
      ],
      "matched": 9,
      "missing_information": [
        "…"
      ],
      "disclaimer": "Independent service. Not affiliated with, endorsed by, or operated by any government or public authority. Eligibility and awards are decided by the competent authority."
    },
    "isError": false
  }
}

• Fouten van het protocol zelf: -32700 voor een body die geen JSON is (met HTTP 400), -32600 als jsonrpc niet "2.0" is, -32601 voor een onbekende methode.
• Zonder geldige sleutel antwoordt het endpoint 401, en met een sleutel van een account zonder plan 402 subscription_required, in de gewone foutstructuur van de API, nog voor er JSON-RPC gelezen wordt. Zie authenticatie.