Se connecter

1. Localiser le fichier de configuration

Claude Desktop lit les serveurs MCP depuis un seul fichier JSON. Ouvrez-le dans votre éditeur :

OSChemin
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

Si le fichier n'existe pas encore, créez-le avec un objet {} vide.

2. Ajouter le serveur Crawlbase

{
  "mcpServers": {
    "crawlbase": {
      "type": "stdio",
      "command": "npx",
      "args": ["@crawlbase/mcp@latest"],
      "env": {
        "CRAWLBASE_TOKEN": "YOUR_TOKEN",
        "CRAWLBASE_JS_TOKEN": "YOUR_JS_TOKEN"
      }
    }
  }
}
// Claude Code reads the same shape from claude.json
{
  "mcpServers": {
    "crawlbase": {
      "type": "stdio",
      "command": "npx",
      "args": ["@crawlbase/mcp@latest"],
      "env": {
        "CRAWLBASE_TOKEN": "YOUR_TOKEN",
        "CRAWLBASE_JS_TOKEN": "YOUR_JS_TOKEN"
      }
    }
  }
}
Vous avez déjà d'autres serveurs ?

Si votre configuration contient déjà un bloc mcpServers, ajoutez simplement l'entrée crawlbase à côté des autres. Ne remplacez pas les serveurs existants.

3. Redémarrer Claude Desktop

Quittez complètement (pas seulement fermer la fenêtre - utilisez Cmd+Q sur macOS ou faites un clic droit sur la barre d'état système sur Windows) puis relancez. La prochaine conversation aura accès aux outils Crawlbase.

4. Vérifier que ça fonctionne

Cliquez sur l'icône curseur/outils dans le champ de saisie. Vous devriez voir crawlbase listé avec 9 outils disponibles (3 crawl + 6 stockage). Essayez un test rapide :

Crawl https://anthropic.com and tell me what's in the navigation.

Vous verrez Claude appeler crawl (ou crawl_markdown), puis résumer le résultat. Si vous ne voyez pas l'appel d'outil, vérifiez les logs :

OSChemin des logs
macOS~/Library/Logs/Claude/mcp*.log
Windows%APPDATA%\Claude\logs\mcp*.log

Exemples de prompts

Ce qui fonctionne directement une fois Crawlbase connecté :

  • « Compare les pages tarifaires de Stripe, Adyen et Square. Fais un tableau des offres et des tarifs phares. »
  • « Prends des captures d'écran de ces 5 landing pages et dis-moi laquelle a le above-the-fold le plus percutant. »
  • « Quels sont les 3 meilleurs résultats pour 'open source LLM observability' en ce moment ? Résume chacun. »
  • « Surveille news.ycombinator.com et préviens-moi quand un post sur mon entreprise atteint la page d'accueil. »

Dépannage

Pas de « crawlbase » dans la liste des outils
Le JSON de configuration est invalide ou le chemin est incorrect. Validez avec jq . claude_desktop_config.json. Consultez les logs pour les erreurs de parsing.
Les appels d'outils renvoient 401
Token incorrect ou non collé dans env. Vérifiez les valeurs depuis votre dashboard.
« npx not found »
Node n'est pas installé ou n'est pas dans le PATH de Claude Desktop. Installez Node 18+ ou utilisez le chemin absolu : "command": "/usr/local/bin/npx".