Passer au contenu principal
Locus expose ses capacités comme outils MCP curés pour les agents LLM. Les outils sont définis à la main (un par capacité) et pointent vers le même moteur que l’API REST — ce n’est pas un miroir 1:1 des routes HTTP. Endpoint : https://mcp.locusmedical.fr/mcp · Transport : Streamable HTTP

​
Connecter un client

Locus s’authentifie avec un jeton bearer statique lsk_… (OAuth est sur la roadmap, pas encore disponible). La configuration dépend de la capacité de votre client à envoyer un en-tête Authorization personnalisé.

​
Clients qui supportent les en-têtes personnalisés

Cursor, Cline, VS Code, Windsurf et la plupart des clients MCP par fichier de config peuvent appeler l’endpoint directement. Pointez-les sur l’URL avec votre clé en bearer : 
{
  "mcpServers": {
    "locus": {
      "url": "https://mcp.locusmedical.fr/mcp",
      "headers": { "Authorization": "Bearer ${LOCUS_API_KEY}" }
    }
  }
}

​
Claude (Desktop / claude.ai)

Les connecteurs natifs de Claude attendent OAuth 2.1, que Locus n’implémente pas encore. Utilisez le pont mcp-remote — un petit proxy local qui injecte votre en-tête Authorization — dans claude_desktop_config.json : 
{
  "mcpServers": {
    "locus": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.locusmedical.fr/mcp",
        "--header", "Authorization: Bearer ${LOCUS_API_KEY}"
      ]
    }
  }
}
Utilisez la forme URL + en-têtes pour les clients qui gèrent les en-têtes ; utilisez mcp-remote pour Claude tant qu’OAuth natif n’est pas disponible.

​
Authentification

Chaque appel d’outil est authentifié avec la même clé lsk_… que l’API REST (voir Authentification). Le bearer voyage dans les en-têtes de la requête ; une clé manquante ou invalide fait renvoyer une erreur à l’outil. OAuth 2.1 est sur la roadmap ; en attendant, l’auth par clé API (en-tête direct, ou via mcp-remote pour Claude) est la voie supportée.

​
JSON-RPC brut

Vous pouvez aussi piloter le serveur directement. Lister les outils : 
curl -X POST https://mcp.locusmedical.fr/mcp \
  -H "Authorization: Bearer $LOCUS_API_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Appeler un outil : 
curl -X POST https://mcp.locusmedical.fr/mcp \
  -H "Authorization: Bearer $LOCUS_API_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search","arguments":{"query":"HTA gravidique","limit":5}}}'

​
Ce que renvoient les outils

Chaque outil renvoie à la fois :
  • content — un résumé texte lisible, pour les clients qui affichent du texte.
  • structuredContent — le JSON complet, typé par un schéma de sortie annoncé.
Voir le catalogue d’outils pour le routage et le détail par outil.