Guide

Démarrer avec agridata MCP en 15 minutes

Connecter un client LLM (Claude Desktop, VS Code, Cursor) au serveur agridata MCP et exécuter une première vraie requête sur les données agricoles ouvertes tunisiennes.

Résultat attendu

À la fin de ce guide, votre client LLM habituel sera connecté au serveur agridata et vous aurez exécuté une première requête qui combine données structurées et références documentaires. Temps total estimé : .

Prérequis

  • Un client LLM compatible MCP : Claude Desktop, Claude Code, VS Code, Cursor, Windsurf, Gemini CLI, ou équivalent.
  • Une connexion Internet.
  • Pour Claude Desktop uniquement : Node.js 18 ou version ultérieure installé sur la machine. Les autres clients n'ont pas cette dépendance.

Étape 1 — Identifier l'URL du serveur

L'URL publique du serveur est https://mcp.tanitdata.org/mcp. Le chemin /mcp final est obligatoire — une URL sans ce suffixe renvoie une erreur 404.

Étape 2 — Configurer le client

Ajoutez la configuration correspondant à votre client. La logique est identique partout ; seul le format du fichier change.

Claude Desktop

Fichier de configuration :

  • Windows : %APPDATA%\Claude\claude_desktop_config.json
  • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux : ~/.config/Claude/claude_desktop_config.json
json
{
  "mcpServers": {
    "tanitdata": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.tanitdata.org/mcp"]
    }
  }
}

Claude Desktop ne gère pas encore les serveurs MCP distants de manière native : un petit pont nommé mcp-remote est utilisé, téléchargé automatiquement au premier lancement via npx. C'est pour cela que Node.js 18+ est requis. Enregistrez le fichier, puis redémarrez Claude Desktop.

VS Code (avec support MCP)

Créez ou modifiez .vscode/mcp.json à la racine du projet :

json
{
  "servers": {
    "tanitdata": {
      "url": "https://mcp.tanitdata.org/mcp",
      "type": "http"
    }
  }
}

Cursor, Windsurf, Gemini CLI, autres clients à support MCP natif

json
{
  "mcpServers": {
    "tanitdata": {
      "url": "https://mcp.tanitdata.org/mcp"
    }
  }
}

Claude Code (CLI)

Une seule commande, sans fichier de configuration :

bash
claude mcp add --transport http tanitdata https://mcp.tanitdata.org/mcp

Étape 3 — Premier appel de test

Ouvrez une nouvelle conversation dans votre client et posez la question :

« Quels outils sont exposés par le serveur tanitdata ? »

Le client doit afficher une liste d'outils fournis par le serveur. Si cette liste apparaît, la connexion fonctionne. Dans le cas contraire, vérifiez que l'URL contient bien /mcp à la fin et que la configuration a été enregistrée avant le redémarrage du client.

Étape 4 — Votre première vraie requête

Essayez une question qui combine chiffres et contexte documentaire :

« Quelle est la production de blé dur par gouvernorat sur les cinq dernières années, et comment se positionne-t-elle par rapport aux objectifs fixés par le plan national ? »

Le serveur répond avec les données correspondantes et indique pour chaque résultat la ressource d'origine sur agridata.tn. Vous pouvez suivre le lien pour vérifier la source directement sur le portail.

Dépannage

  • Le client signale une erreur 404 ou ne trouve pas le serveur. Vérifiez que l'URL est https://mcp.tanitdata.org/mcp avec le suffixe /mcp. L'URL racine https://mcp.tanitdata.org ne suffit pas.
  • Claude Desktop ne se connecte pas et n'affiche pas d'erreur claire. Vérifiez deux points : la configuration passe par npx mcp-remote et non par un champ url direct, et Node.js 18+ est bien installé sur la machine.
  • La première requête météo prend environ 7 secondes ; les suivantes sont immédiates. C'est normal : le serveur prépare un cache local lors du premier appel. Les requêtes suivantes sont rapides.

Et ensuite

Une fois le serveur opérationnel côté client, consultez les publications du studio pour des cas d'usage plus avancés. Pour partager un retour ou proposer une collaboration, la page Contribuer détaille les chemins possibles.

Questions fréquentes

Puis-je tester le serveur sans installer de client ?
Le serveur est conçu pour être appelé depuis un client LLM, pas depuis un navigateur. Pour vérifier qu'il répond, vous pouvez ouvrir https://mcp.tanitdata.org/health dans un navigateur — une réponse {"status": "ok"} confirme que le serveur est en ligne.
Quels clients MCP sont supportés ?
Tous les clients qui implémentent le protocole MCP standard : Claude Desktop, Claude Code, VS Code avec extension MCP, Cursor, Windsurf, Gemini CLI, et d'autres. La seule différence tient à la forme du fichier de configuration ; la logique est la même partout.
Les requêtes sont-elles facturées ?
Non. L'accès au serveur est gratuit pour un usage de recherche. Un usage programmatique intensif devrait passer par une copie locale — le code est ouvert sous licence MIT.
Où signaler un bug ou demander un jeu de données ?
Ouvrez une issue sur le dépôt https://github.com/tarekddoit/tanitdata ou écrivez à contact@tanitdata.org.