Aller au contenu

Assistant IA (MCP)

Le serveur MCP iDalgo connecte un assistant de code (Claude Code, Cursor, VS Code…) à l’API : il y trouve les routes, leurs contrats, des données réelles et un client prêt à l’emploi, puis écrit avec vous le code de vos écrans. Il ne fait que lire l’API, avec les mêmes données que vous.

Le serveur répond à l’URL https://mcp.idalgo.live/mcp (transport HTTP). La clé, communiquée à l’ouverture de votre accès, se passe dans l’en-tête Authorization: Bearer <clé>. Avec votre clé secrète idl_sk_…, le serveur la transmet à l’API : ce que lit l’assistant compte dans votre consommation (voir Votre clé).

Claude Code :

Fenêtre de terminal
claude mcp add --transport http idalgo https://mcp.idalgo.live/mcp --header "Authorization: Bearer <clé>"

Cursor (.cursor/mcp.json) :

{
"mcpServers": {
"idalgo": {
"url": "https://mcp.idalgo.live/mcp",
"headers": { "Authorization": "Bearer <clé>" }
}
}
}

VS Code (.vscode/mcp.json) :

{
"servers": {
"idalgo": {
"type": "http",
"url": "https://mcp.idalgo.live/mcp",
"headers": { "Authorization": "Bearer <clé>" }
}
}
}

Demandez par exemple : « Construis un écran du classement de la Ligue 1 en React avec l’API iDalgo ». L’assistant enchaîne alors :

  1. search : trouve la compétition et sa saison en cours à partir de son nom ;
  2. list_endpoints, puis describe_endpoint : choisit la route, lit ses paramètres, ses codes de réponse et ses schémas, et peut voir une vraie réponse (include_example) ; get_endpoint appelle n’importe quelle route et rend sa réponse exacte, enveloppe comprise ;
  3. le client de référence (idalgo://snippets/idalgo-client.ts) : un client TypeScript sans dépendance qui applique les règles de l’API — enveloppe, erreurs, ETag, pagination, direct ;
  4. find_examples : des matchs réels à venir, en direct, terminés, reportés, annulés, et des épreuves classées, pour tester l’écran dans tous ses états.

Le prompt build_screen (classement, calendrier ou direct) lance ce scénario d’un coup, avec le client et les guides joints.

Chaque réponse d’un tool liste les requêtes REST qui l’ont produite (apiRequests, chemins relatifs à $IDALGO_API) : ce sont elles à écrire dans votre code. Les tools résument leurs réponses par défaut ; detail: "full" rend la réponse exacte de l’API, mais votre code reçoit toujours l’enveloppe { data, meta, links } et les en-têtes de cache décrits dans Conventions et Cache et fraîcheur.

Tools :

Tool Rôle
list_endpoints, describe_endpoint Les routes de l’API et le contrat de chacune
get_endpoint La réponse exacte de n’importe quelle route
find_examples Des identifiants réels pour chaque état d’un écran
search Un nom (« PSG », « Mbappé ») vers son identifiant
list_competitions, list_seasons Le catalogue des compétitions et de leurs saisons
get_standings, get_medal_table, get_season_leaders Classement, tableau des médailles, buteurs, passeurs et cartons d’une saison, ou d’une équipe
list_contests, get_contest, get_live_contests Calendrier et résultats, fiche d’un match (compositions et actions en option), scores du jour
get_team, get_person, get_head_to_head Équipe, personne (stats d’une saison en option), confrontations

Ressources : le contrat OpenAPI (idalgo://api/openapi.json), le client de référence, et les guides de l’API (idalgo://docs/api/…).

Prompts : build_screen, ainsi que match_preview, matchday_recap et player_profile pour rédiger à partir des données.