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.
Se connecter
Section intitulée « Se connecter »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 :
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é>" } } }}Construire un écran
Section intitulée « Construire un écran »Demandez par exemple : « Construis un écran du classement de la Ligue 1 en React avec l’API iDalgo ». L’assistant enchaîne alors :
search: trouve la compétition et sa saison en cours à partir de son nom ;list_endpoints, puisdescribe_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_endpointappelle n’importe quelle route et rend sa réponse exacte, enveloppe comprise ;- 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 ; 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.
Coder contre l’API, pas contre l’assistant
Section intitulée « Coder contre l’API, pas contre l’assistant »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.
Ce que le serveur propose
Section intitulée « Ce que le serveur propose »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.