Serveur MCP : connecter Rankion à Claude et aux agents IA

Rankion exploite son propre serveur MCP (Model Context Protocol). Chaque appel d'outil passe par l'endpoint correspondant de l'API REST v1. L'accès à l'équipe, la validation et les crédits fonctionnent donc comme pour un appel direct à l'API.

Créez le token dans Rankion sous Paramètres, section API-Tokens (https://rankion.ai/settings). Voir aussi Authentification.

Configuration dans Claude Code

claude mcp add --transport http rankion https://rankion.ai/mcp \
  --header "Authorization: Bearer <TOKEN>"

Remplacez <TOKEN> par votre token. claude mcp list affiche ensuite le serveur comme connecté. Avec un token incorrect ou révoqué, le serveur répond 401 et la connexion échoue.

Configuration pour Managed Agents

Managed Agents est l'API d'agents de la Claude Developer Platform. La configuration comporte deux parties : l'agent nomme le serveur, et le token est conservé à part dans un vault.

1. Déclarer le serveur sur l'agent. Chaque entrée de mcp_servers doit avoir son mcp_toolset :

{
  "mcp_servers": [
    { "type": "url", "name": "rankion", "url": "https://rankion.ai/mcp" }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "rankion" }
  ]
}

2. Enregistrer le token comme credential de vault de type static_bearer :

{
  "display_name": "Rankion",
  "auth": {
    "type": "static_bearer",
    "mcp_server_url": "https://rankion.ai/mcp",
    "token": "<TOKEN>"
  }
}

3. Indiquer le vault au démarrage de la session : "vault_ids": ["<VAULT_ID>"].

L'association se fait par URL : mcp_server_url doit désigner le même serveur que url. Les appels complets figurent dans la documentation d'Anthropic sur MCP dans Managed Agents et sur les vaults.

claude.ai et Claude Desktop

Le connecteur en un clic de claude.ai (web) et de Claude Desktop exige une connexion OAuth. Le serveur Rankion ne le permet pas aujourd'hui : il n'accepte que les tokens Bearer, et laravel/passport, le paquet pour la connexion OAuth, n'est pas installé. Cette partie est prévue en phase 2, sans date fixée.

Il n'existe donc pas encore de connexion prête à l'emploi pour ces deux interfaces.

Le catalogue se met à jour tout seul

La liste des outils est reconstruite à partir des routes v1 actuelles à chaque connexion. Une nouvelle route devient un outil sans autre configuration.

Le champ version de serverInfo a la forme 1.<tool-count>.<hash>, par exemple 1.747.dd625a1e. Il change dès que l'API change. Un client ne doit pas conserver le catalogue en cache d'une version à l'autre. Si version change ou si un outil attendu manque, il relit les outils ou rétablit la connexion.

La liste d'outils est longue

Au 04.11.2026, il y a 747 outils. Sur 754 endpoints, 744 ont un outil, et trois endpoints ont deux outils avec chacun sa description. Le nombre à jour figure toujours dans version.

Deux conséquences :

• Un client limité en nombre d'outils peut ne pas tous les voir. Si possible, n'activez que les outils nécessaires. Dans Managed Agents, cela se fait dans le mcp_toolset : "default_config": { "enabled": false }, puis les outils voulus dans configs avec "enabled": true.
• tools/list renvoie 15 outils par page. Un client maison doit suivre nextCursor, sinon il ne connaît que les 15 premiers.

Tous les endpoints sont listés sur https://rankion.ai/api-reference.

Ces 10 routes n'ont pas d'outil

Les fichiers et les webhooks entrants ne se prêtent pas à un appel d'outil. Ces routes sont donc exclues volontairement (au 04.11.2026) et restent accessibles via l'API REST. D'autres routes d'export ont leur propre outil.

Skill, API REST et OpenAPI

Le serveur MCP s'ajoute aux autres voies d'accès, et un seul token vaut pour toutes :

• Skill pour Claude Code : un fichier Markdown que Claude Code lit directement.
• API REST : tous les endpoints sous https://rankion.ai/api/v1/..., décrits dans la référence API.
• Spec OpenAPI : lisible par machine sur https://rankion.ai/api/v1/openapi.yaml, par exemple pour n8n, Zapier ou vos propres clients.

Installer le Skill :

mkdir -p ~/.claude/skills/rankion-api
curl -o ~/.claude/skills/rankion-api/SKILL.md https://rankion.ai/claude-skill
export RANKION_API_TOKEN="<TOKEN>"

Tester l'API REST :

curl -H "Authorization: Bearer $RANKION_API_TOKEN" \
  -H "Accept: application/json" \
  https://rankion.ai/api/v1/team

Points d'attention

• Ne committez jamais le token. Gardez-le dans un fichier .env ou un gestionnaire de secrets.
• Surveillez les crédits. Un appel d'outil coûte autant que l'endpoint correspondant.
• Interrogez les tâches longues. Certains endpoints répondent par HTTP 202 avec un ID de job. Vérifiez ensuite le statut avec l'outil correspondant ou l'endpoint GET.

Articles wiki associés

• Référence API
• Authentification
• Agent maître / Agentic Chat : tâches en plusieurs étapes via POST /v1/agentic/chat