Connecter votre client MCP

Le serveur MCP expose 5 outils « fuel data » à n'importe quel agent compatible. Ci-dessous : guides pas-à-pas pour les clients les plus utilisés.

Endpoint

URL

https://developer.monpleinpascher.com/mcp

Transport Streamable HTTP· pas d'auth · 30 req/min par IP

Claude Code

Une commande, et l'agent peut interroger les prix carburant dans toutes vos sessions.

Ajout via CLI

claude mcp add --transport http fuel-prices https://developer.monpleinpascher.com/mcp

Options de scope

• --scope local (défaut) — visible seulement par toi sur ce projet
• --scope project — partagé via .mcp.json dans le repo
• --scope user — disponible sur tous tes projets

Vérifier

claude mcp list
# fuel-prices: https://developer.monpleinpascher.com/mcp (http) ✓ connected

Tester dans une session

> Quel est le prix moyen du gazole en France aujourd'hui ?
# Claude appelle automatiquement get_national_prices(fuel="gazole")

Claude Desktop

Édite le fichier de config (Settings → Developer → Edit Config), puis redémarre l'app.

claude_desktop_config.json

{
  "mcpServers": {
    "fuel-prices": {
      "url": "https://developer.monpleinpascher.com/mcp"
    }
  }
}

Localisation du fichier :
macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
Windows — %APPDATA%\Claude\claude_desktop_config.json

Autres clients (Cursor, Cline, raw)

Tout client conforme MCP avec transport HTTP fonctionne : pointe-le sur l'endpoint, aucune négociation supplémentaire.

Test rapide en curl (list tools)

curl -X POST https://developer.monpleinpascher.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Outils disponibles

lookup_stationdétails + dernier prix par carburant pour un ID station

search_stations_nearbystations les moins chères dans un rayon (lat/lng)

get_national_pricesmoyenne 1/3/7j, min, max, tendance pour un carburant

get_price_historysérie temporelle quotidienne pour une station (LOCF)

get_brand_trendsmoyennes par enseigne (top 6) sur N jours

Schémas d'entrée/sortie complets dans le Swagger.

Troubleshooting

• connection refused— vérifie que l'URL est exactement https://developer.monpleinpascher.com/mcp, sans slash final
• 429 too many requests — limite 30 req/min par IP, attends 60s ou contacte-nous pour un quota plus élevé
• l'agent n'utilise pas l'outil — formule la question avec du vocabulaire carburant explicite (« gazole », « station », « €/L »)

← retour à l'accueil Explorer l'API REST →