Serveur Olostep MCP - Olostep Docs

Le serveur Olostep MCP offre à tout client AI compatible MCP (Claude, Cursor, Windsurf, VS Code, Claude Code, etc.) 10 outils prêts à l’emploi pour le web en direct — scraping, recherche, réponses AI avec citations, tâches par lots, crawling de site et découverte d’URL.

Scraper & extraire

Récupérez du markdown, HTML, JSON ou texte depuis n’importe quelle URL avec rendu JS optionnel

Réponses AI

Réponses basées sur le web avec sources et sortie structurée

Lot & crawl

Jusqu’à 10k URLs en parallèle, ou découvrez de manière autonome un site entier

Carte & recherche

Trouvez chaque URL sur un site ou effectuez une recherche web basée sur un parseur

Avant de commencer

Tu as besoin d’une clé API Olostep. Obtiens-en une depuis le tableau de bord Olostep — le niveau gratuit couvre l’utilisation personnelle.

Choisir une méthode d’installation

Le chemin le plus rapide pour chaque client est le point d’accès hébergé à https://mcp.olostep.com/mcp. Pas d’installation, pas de Node, pas de Docker — il suffit de coller une URL et ta clé API. Si tu as besoin de le faire fonctionner entièrement en local (utilisation hors ligne, proxy d’entreprise, réseau isolé), chaque client prend également en charge une installation local stdio via npx. Chaque section ci-dessous montre les deux.

Point d’accès hébergé utilise Authorization: Bearer YOUR_API_KEY. Local stdio utilise OLOSTEP_API_KEY comme variable d’environnement. Ne les mélange pas — le mauvais mode d’authentification est l’erreur d’intégration numéro 1.

Configuration du client

Installation en un clic (recommandée) :

Remplace YOUR_API_KEY dans la configuration résultante par ta vraie clé.Configuration manuelle :Crée ou modifie .cursor/mcp.json à la racine de ton projet (ou ~/.cursor/mcp.json pour une configuration globale) :

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Installation local stdio (optionnelle)

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Nécessite Node.js 18+ sur ta machine.

Vérification : Ouvre Cursor → Paramètres → MCP. Tu devrais voir olostep listé avec 10 outils incluant scrape_website. Si tu vois “Connecté, 0 outils”, ta clé API est incorrecte.

Installation CLI (recommandée) :

claude mcp add --transport http olostep https://mcp.olostep.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Configuration manuelle :Ajoute à ta configuration MCP Claude Code (.mcp.json à la racine du projet, ou ~/.claude.json globalement) :

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Installation local stdio (optionnelle)

claude mcp add --transport stdio --env OLOSTEP_API_KEY=YOUR_API_KEY olostep \
  -- npx -y olostep-mcp

Ou en JSON :

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Vérification : Exécute /mcp dans Claude Code. Tu devrais voir olostep connecté avec 10 outils.

Emplacement du fichier de configuration :

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

Hébergé (recommandé) :

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Installation local stdio (optionnelle)

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Ou installe via Smithery :

npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude

Claude Desktop doit être complètement quitté et relancé pour que les changements de configuration prennent effet — fermer la fenêtre ne suffit pas (il reste actif dans la barre de menu / la barre système).

Vérification : Ouvre Claude Desktop → cherche l’icône 🔨 (marteau) dans le champ de saisie du chat. Clique dessus — tu devrais voir 10 outils Olostep listés.

Le support MCP de VS Code est intégré à GitHub Copilot (mode Agent). Ajoute ceci à .vscode/mcp.json dans ton projet, ou à ton settings.json utilisateur :

{
  "servers": {
    "olostep": {
      "type": "http",
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Installation local stdio (optionnelle)

{
  "servers": {
    "olostep": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Vérification : Ouvre le panneau de chat Copilot → passe en mode Agent → le popover des outils devrait lister les outils Olostep.

Ajoute à ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "olostep": {
      "serverUrl": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Installation local stdio (optionnelle)

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Vérification : Cascade → Paramètres → MCP. olostep devrait apparaître avec 10 outils.

Si tu préfères exécuter le serveur dans un conteneur (CI, environnement isolé, pas de Node sur l’hôte) :

docker pull olostep/mcp-server

docker run -i --rm \
  -e OLOSTEP_API_KEY="YOUR_API_KEY" \
  olostep/mcp-server

Dans une configuration client MCP (stdio) :

{
  "mcpServers": {
    "olostep": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "OLOSTEP_API_KEY=YOUR_API_KEY",
        "olostep/mcp-server"
      ]
    }
  }
}

Prend en charge linux/amd64 et linux/arm64. Source sur GitHub.

Ouvre le tableau de bord Metorial
Navigue vers MCP Servers
Recherche Olostep
Clique sur Install et colle ta clé API

Pour une configuration manuelle :

{
  "olostep": {
    "command": "npx",
    "args": ["-y", "olostep-mcp"],
    "env": {
      "OLOSTEP_API_KEY": "YOUR_API_KEY"
    }
  }
}

Choisir le bon outil

Le serveur MCP expose 10 outils. Utilise cet arbre de décision pour choisir le bon — l’agent utilise le même raisonnement :

Tu veux…	Utilise	Remarques
Le contenu d’une page spécifique	`scrape_website` ou `get_webpage_content`	Défini `wait_before_scraping=2000–5000` pour les SPA
Une réponse web en langage naturel avec sources	`answers`	Retourne une synthèse AI + citations
Résultats de recherche pour une requête	`search_web`	Basé sur un parseur, non AI, structuré
Une liste d’URLs sur un site	`create_map`	Découverte d’URL uniquement — ne scrape PAS
URLs filtrées par requête	`get_website_urls`	Classées par pertinence pour ta `search_query`
Plusieurs URLs connues à la fois	`batch_scrape_urls` + `get_batch_results`	Asynchrone — démarre, puis interroge
Un site entier ou une section	`create_crawl` + `get_crawl_results`	Asynchrone — suit les liens à partir d’une URL de départ

Scraping d’un site entier ? Utilise create_crawl, pas batch_scrape_urls. Crawl découvre ET scrape. Batch est pour une liste connue d’URLs que tu as déjà.

Détails des outils

scrape_website

Extrait le contenu d’une seule URL. Prend en charge markdown, html, json, text. country optionnel pour les requêtes géo-ciblées, wait_before_scraping (0–10000 ms) pour les sites lourds en JS, et parser (par exemple @olostep/amazon-product) pour une extraction structurée.

get_webpage_content

Version légère en markdown uniquement de scrape_website. À utiliser lorsque tu veux juste du markdown propre et que tu n’as pas besoin d’options de format.

search_web

Résultats de recherche web structurés (basés sur un parseur) pour une requête. country optionnel pour des résultats localisés. Retourne du JSON, pas de la prose AI.

answers

Réponse alimentée par AI à une task avec sources et citations. Passe un argument json pour obtenir la réponse dans une forme spécifique — soit un schéma JSON, soit une courte description en langage naturel.

batch_scrape_urls

Scraping asynchrone de 2 à 10k URLs que tu as déjà. Retourne un batch_id — puis appelle get_batch_results pour récupérer le contenu. Défini wait_for_completion_seconds (jusqu’à 900) si tu veux un seul appel bloquant au lieu de l’interrogation. Recommandé : 60 pour les lots de moins de 50 URLs, 300–600 pour 50–1k, 0 (interroger séparément) pour les lots plus grands.

get_batch_results

Récupère le statut et le contenu extrait pour un batch_id. Retourne processing jusqu’à ce que ce soit terminé, puis completed avec le tableau d’éléments.

create_crawl

Crawl asynchrone qui suit les liens à partir d’un start_url. Utilise include_url_patterns / exclude_url_patterns (syntaxe glob comme /blog/**) pour délimiter. Retourne un crawl_id — puis appelle get_crawl_results.

get_crawl_results

Récupère le statut et les pages pour un crawl_id. Prend en charge la pagination via cursor et items_limit (max 100 par appel). Retourne in_progress jusqu’à ce que ce soit terminé.

create_map

Obtiens une liste d’URLs sur un site. Découverte d’URL uniquement — ne scrape pas. À utiliser lorsque tu veux faire apparaître des URLs candidates (par exemple, laisser l’utilisateur choisir un sous-ensemble). Prend en charge include_url_patterns / exclude_url_patterns et search_query.

get_website_urls

Comme create_map, mais les URLs sont classées par pertinence pour une search_query requise. À utiliser lorsque tu veux les N meilleurs liens correspondants sur un site.

Dépannage

Le serveur apparaît mais affiche 0 outils

Ta clé API est invalide ou limitée en taux. Ouvre le tableau de bord des clés API et vérifie la clé. Si tu utilises le point d’accès hébergé, l’en-tête doit être exactement Authorization: Bearer sk_... — pas de guillemets autour de la valeur, pas d’espaces supplémentaires.

`npx: command not found` ou `command not found: olostep-mcp`

Node.js n’est pas installé (ou pas dans ton PATH). Installe Node 18+ depuis nodejs.org, puis redémarre ton terminal et ton client MCP. Sur Windows, passe à un CMD/PowerShell qui a Node dans le PATH.

Connexion refusée ou erreurs DNS sur `mcp.olostep.com`

Tu es probablement derrière un proxy d’entreprise ou un pare-feu bloquant l’hôte. Passe à l’installation local stdio (npx -y olostep-mcp) — elle effectue des requêtes sortantes vers api.olostep.com à la place, ce qui est généralement autorisé.

Configuration modifiée mais la liste des outils est obsolète

Le client a mis en cache l’ancienne configuration. Quitte complètement et relance — ne te contente pas de fermer la fenêtre. Claude Desktop en particulier continue de fonctionner dans la barre de menu / la barre système.

Échecs spécifiques à Windows avec `npx`

Si npx échoue à lancer le serveur sur Windows, utilise la forme encapsulée par CMD :

{
  "command": "cmd",
  "args": ["/c", "npx", "-y", "olostep-mcp"],
  "env": { "OLOSTEP_API_KEY": "YOUR_API_KEY" }
}

`401 Missing Authorization: Bearer <OLOSTEP_API_KEY>`

Tu as atteint le point d’accès hébergé sans en-tête d’authentification (ou avec le mauvais format). Ajoute l’en-tête à la configuration de ton client exactement comme indiqué dans l’onglet de configuration.

Recettes

Copie-colle des invites qui fonctionnent bien avec les outils :

Scraper une liste d’URLs de produits : “J’ai un CSV de 200 URLs de produits Amazon. Scrape-les par lot avec parser=@olostep/amazon-product et retourne-les en JSON.”
Crawl un site de docs : “Crawl https://stripe.com/docs avec max_pages=50 et include_url_patterns=['/docs/**']. Résume chaque section en markdown.”
Trouver des concurrents : “Utilise answers pour trouver les 5 principaux concurrents de Notion pour les sites de documentation technique. Retourne le nom, la page d’accueil et le positionnement en une ligne.”
Cartographier puis scraper : “Exécute create_map sur https://example.com filtré sur /blog/**, puis batch_scrape_urls sur les 20 meilleurs résultats.”

Scraper & extraire

Réponses AI

Lot & crawl

Carte & recherche

​Avant de commencer

​Choisir une méthode d’installation

​Configuration du client

​Choisir le bon outil

​Détails des outils

​Dépannage

​Recettes

​Source & versions

Avant de commencer

Choisir une méthode d’installation

Configuration du client

Choisir le bon outil

Détails des outils

Dépannage

Recettes

Source & versions