Connecter un client MCP

Connectez-vous à https://kardilo.com/api/v1/mcp en Streamable HTTP, avec Authorization: Bearer <ACCESS_TOKEN> à chaque requête. Commencez par obtenir des identifiants, puis échangez-les contre un jeton.

Préparez un jeton valide dans KARDILO_ACCESS_TOKEN, puis choisissez votre client.

Streamable HTTP

URL: https://kardilo.com/api/v1/mcp
Transport: Streamable HTTP
Authorization: Bearer <ACCESS_TOKEN>

Configurez ces valeurs dans un client qui accepte un en-tête Bearer explicite. Initialisez la connexion puis listez les outils.

Claude Code

claude mcp add --transport http --scope user kardilo-catalog \
  https://kardilo.com/api/v1/mcp \
  --header "Authorization: Bearer ${KARDILO_ACCESS_TOKEN}"

La commande enregistre la valeur du jeton. Remplacez-la après renouvellement, puis reconnectez le serveur depuis /mcp. Ne partagez pas cette configuration.

Codex

[mcp_servers.kardilo_catalog]
url = "https://kardilo.com/api/v1/mcp"
bearer_token_env_var = "KARDILO_ACCESS_TOKEN"

Ajoutez ce bloc à ~/.codex/config.toml. Le jeton doit être dans l’environnement du processus Codex. Redémarrez après renouvellement.

Quatre outils en lecture seule

Outil	Entrée	structuredContent
list_sets	zone?: intl, jp, chn	{ sets: Set[] }
list_cards	setCode; page? ≥1; pageSize? 1–200	{ page, pageSize, total, cards: Card[] }
get_card	cardId	Card
search_cards	query: 2–200 chars; zone?; setCode? ≤50 chars; limit? 1–100	{ cards: Card[] }

Valeurs par défaut : page=1, pageSize=50 et limit=25 pour la recherche. list_cards accepte aussi un identifiant complet d’extension comme setCode ; le setCode de recherche filtre par code.

Une réponse réussie figure dans structuredContent et dans un bloc texte JSON. Un échec de recherche renvoie isError: true. Vérifiez ce champ ; des arguments invalides peuvent produire une erreur protocolaire.

Vérifier la connexion

Initialisez la connexion et découvrez les quatre outils. Appelez list_sets, choisissez un identifiant retourné, puis appelez list_cards et get_card avec les identifiants reçus.

Essayez : « Trouve les entrées internationales correspondant à Charizard 4. Affiche l’extension, la langue, l’impression et l’URL du scan disponible. »

Renouvellement et compatibilité

Le serveur ne maintient pas de session. Un GET authentifié renvoie 405. Chaque requête exige un jeton valide. Renouvelez selon expires_in, mettez à jour le jeton du client et reconnectez-le si nécessaire. Un client proposant uniquement une connexion OAuth dans le navigateur n’est pas compatible avec ce flux client credentials.