Serveur MCP

L’endpoint#

Outils#

Chaque outil est en lecture seule. Les arguments sont validés exactement comme la route correspondante valide ses paramètres.

L’argument company annonce les propriétés courantes (code postal, région, taille, effectif, chiffre d’affaires, total du bilan, codes NACE, forme juridique, date de création, aides de minimis) et accepte toutes les propriétés d’une requête de matching. Un résultat revient à la fois en texte (JSON mis en forme) et en structuredContent. Un outil qui échoue (argument invalide, formule que la clé n’a pas, quota épuisé) renvoie un résultat avec isError: true et l’erreur de l’API dans structuredContent.error, pour que le modèle puisse lire ce qui s’est mal passé ; seul un message mal formé donne une erreur JSON-RPC.

Connecter un client#

Claude Code

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

Ou dans le .mcp.json d’un projet, en lisant la clé depuis l’environnement pour qu’elle ne soit pas versionnée :

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

Claude Desktop

Claude Desktop lance des serveurs locaux depuis son fichier de configuration : un serveur distant avec une clé passe donc par le pont mcp-remote (qui demande Node.js). Dans 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_..."
      }
    }
  }
}

L’en-tête passe par une variable d’environnement, car certains systèmes découpent les arguments sur l’espace de Bearer …. Redémarrez Claude Desktop après la modification.

Autres clients

Tout client qui parle Streamable HTTP et sait envoyer un en-tête fonctionne : donnez-lui l’URL et l’en-tête Authorization. Beaucoup (Cursor, VS Code, Windsurf) acceptent un bloc JSON de cette forme :

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

Un client qui ne lance que des serveurs locaux peut utiliser le pont mcp-remote comme ci-dessus.

À la main#

Comme le serveur est sans état, curl est un client complet. Listez les outils, puis appelez-en un :

$ 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
  }
}

• Erreurs du protocole lui-même : -32700 pour un corps qui n’est pas du JSON (avec HTTP 400), -32600 quand jsonrpc ne vaut pas "2.0", -32601 pour une méthode inconnue.
• Sans clé valide, l’endpoint répond 401, et avec la clé d’un compte sans formule 402 subscription_required, dans la structure d’erreur habituelle de l’API, avant toute lecture du JSON-RPC. Voir authentification.