Olostep MCP Server

De Olostep MCP-server biedt elke MCP-compatibele AI-client (Claude, Cursor, Windsurf, VS Code, Claude Code, etc.) 10 gebruiksklare tools voor het live web — scraping, zoeken, AI-antwoorden met citaties, batchtaken, sitecrawlen en URL-ontdekking.

Scrapen & extraheren

Haal markdown, HTML, JSON of tekst op van elke URL met optionele JS-rendering

AI-antwoorden

Web-gebaseerde antwoorden met bronnen en gestructureerde output

Batch & crawl

Tot 100k URL’s parallel, of autonoom een hele site ontdekken

Kaart & zoek

Vind elke URL op een site, of voer parser-gebaseerd webzoeken uit

Voordat je begint

Je hebt een Olostep API-sleutel nodig. Haal er een van het Olostep dashboard — de gratis laag dekt persoonlijk gebruik.

Kies een installatiepad

Het snelste pad voor elke client is de gehoste eindpunt op https://mcp.olostep.com/mcp. Geen installaties, geen Node, geen Docker — plak gewoon een URL en je API-sleutel. Als je het volledig lokaal moet laten draaien (offline gebruik, bedrijfsproxy, air-gapped), ondersteunt elke client ook een lokale stdio installatie via npx. Elke sectie hieronder toont beide.

Gehoste eindpunt gebruikt Authorization: Bearer YOUR_API_KEY. Lokale stdio gebruikt OLOSTEP_API_KEY als een omgevingsvariabele. Verwissel ze niet — verkeerde auth-modus is de #1 onboarding fout.

Client installatie

Een-klik installatie (aanbevolen):

Vervang YOUR_API_KEY in de resulterende configuratie door je echte sleutel.Handmatige installatie:Maak of bewerk .cursor/mcp.json in de hoofdmap van je project (of ~/.cursor/mcp.json voor globaal):

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

Lokale stdio installatie (optioneel)

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

Vereist Node.js 18+ op je machine.

Verifieer: Open Cursor → Instellingen → MCP. Je zou olostep moeten zien met 10 tools inclusief scrape_website. Als je “Verbonden, 0 tools” ziet, is je API-sleutel onjuist.

CLI installatie (aanbevolen):

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

Handmatige installatie:Voeg toe aan je Claude Code MCP-configuratie (.mcp.json in de hoofdmap van het project, of ~/.claude.json globaal):

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

Lokale stdio installatie (optioneel)

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

Of als JSON:

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

Verifieer: Voer /mcp uit in Claude Code. Je zou olostep verbonden moeten zien met 10 tools.

Configuratie bestand locatie:

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

Gehost (aanbevolen):

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

Lokale stdio installatie (optioneel)

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

Of installeer via Smithery:

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

Claude Desktop moet volledig worden afgesloten en opnieuw worden gestart om configuratiewijzigingen door te voeren — alleen het venster sluiten is niet genoeg (het blijft draaien in de menubalk / systeemvak).

Verifieer: Open Claude Desktop → zoek naar het 🔨 (hamer) pictogram in het chatinvoerveld. Klik erop — je zou 10 Olostep-tools moeten zien.

De MCP-ondersteuning van VS Code is ingebouwd in GitHub Copilot (Agent-modus). Voeg dit toe aan .vscode/mcp.json in je project, of je gebruikers settings.json:

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

Lokale stdio installatie (optioneel)

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

Verifieer: Open het Copilot-chatpaneel → schakel over naar Agent-modus → de tool-popover zou Olostep-tools moeten tonen.

Voeg toe aan ~/.codeium/windsurf/mcp_config.json:

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

Lokale stdio installatie (optioneel)

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

Verifieer: Cascade → Instellingen → MCP. olostep zou moeten verschijnen met 10 tools.

Als je liever de server in een container draait (CI, geïsoleerde omgeving, geen Node op host):

docker pull olostep/mcp-server

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

In een MCP-clientconfiguratie (stdio):

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

Ondersteunt linux/amd64 en linux/arm64. Bron op GitHub.

Open het Metorial dashboard
Navigeer naar MCP Servers
Zoek naar Olostep
Klik op Installeren en plak je API-sleutel

Voor handmatige configuratie:

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

Het juiste hulpmiddel kiezen

De MCP-server biedt 10 tools aan. Gebruik deze beslisboom om het juiste hulpmiddel te kiezen — de agent gebruikt dezelfde redenering:

Je wilt…	Gebruik	Opmerkingen
De inhoud van een specifieke pagina	`scrape_website` of `get_webpage_content`	Stel `wait_before_scraping=2000–5000` in voor SPA’s
Een webantwoord in natuurlijke taal met bronnen	`answers`	Geeft AI-synthese + citaties terug
Zoekresultaten voor een query	`search_web`	Parser-gebaseerd, niet-AI, gestructureerd
Een lijst van URL’s op een site	`create_map`	Alleen URL-ontdekking — scrapt NIET
URL’s gefilterd op query	`get_website_urls`	Gerangschikt op relevantie voor je `search_query`
Veel bekende URL’s tegelijk	`batch_scrape_urls` + `get_batch_results`	Async — start, dan poll
Een hele site of sectie	`create_crawl` + `get_crawl_results`	Async — volgt links vanaf een start-URL

Een hele site scrapen? Gebruik create_crawl, niet batch_scrape_urls. Crawl ontdekt EN scrapt. Batch is voor een bekende lijst van URL’s die je al hebt.

Tool details

scrape_website

Haal inhoud op van een enkele URL. Ondersteunt markdown, html, json, text. Optioneel country voor geo-gerichte verzoeken, wait_before_scraping (0–10000 ms) voor JS-zware sites, en parser (bijv. @olostep/amazon-product) voor gestructureerde extractie.

get_webpage_content

Lichte markdown-only versie van scrape_website. Gebruik wanneer je alleen schone markdown wilt en geen opmaakopties nodig hebt.

search_web

Gestructureerde (parser-gebaseerde) webzoekresultaten voor een query. Optioneel country voor gelokaliseerde resultaten. Geeft JSON terug, geen AI-proza.

answers

AI-gestuurd antwoord op een task met bronnen en citaties. Geef een json argument door om het antwoord in een specifieke vorm te krijgen — ofwel een JSON-schema of een korte natuurlijke-taalbeschrijving.

batch_scrape_urls

Async scrape van 2–100k URL’s die je al hebt. Geeft een batch_id terug — roep vervolgens get_batch_results aan om inhoud op te halen. Stel wait_for_completion_seconds in (tot 900) als je een enkele blokkerende oproep wilt in plaats van polling. Aanbevolen: 60 voor batches onder 50 URL’s, 300–600 voor 50–1k, 0 (apart poll) voor grotere batches.

get_batch_results

Haalt de status en gescrapete inhoud op voor een batch_id. Geeft processing terug totdat het klaar is, dan completed met de items-array.

create_crawl

Async crawl die links volgt vanaf een start_url. Gebruik include_url_patterns / exclude_url_patterns (glob-syntaxis zoals /blog/**) om te scopen. Geeft een crawl_id terug — roep vervolgens get_crawl_results aan.

get_crawl_results

Haalt de status en pagina’s op voor een crawl_id. Ondersteunt paginering via cursor en items_limit (max 100 per oproep). Geeft in_progress terug totdat het klaar is.

create_map

Krijg een lijst van URL’s op een site. Alleen URL-ontdekking — scrapt niet. Gebruik wanneer je kandidaat-URL’s wilt tonen (bijv. laat de gebruiker een subset kiezen). Ondersteunt include_url_patterns / exclude_url_patterns en search_query.

get_website_urls

Zoals create_map, maar URL’s worden gerangschikt op relevantie voor een vereiste search_query. Gebruik wanneer je de top N overeenkomende links op een site wilt.

Problemen oplossen

Server verschijnt maar toont 0 tools

Je API-sleutel is ongeldig of beperkt. Open het API-sleuteldashboard en verifieer de sleutel. Als je het gehoste eindpunt gebruikt, moet de header exact Authorization: Bearer sk_... zijn — geen aanhalingstekens rond de waarde, geen extra spaties.

npx: command not found of command not found: olostep-mcp

Node.js is niet geïnstalleerd (of niet in je PATH). Installeer Node 18+ van nodejs.org, herstart dan je terminal en je MCP-client. Op Windows, schakel naar een CMD/PowerShell die Node op de PATH heeft.

Verbinding geweigerd of DNS-fouten op mcp.olostep.com

Je zit waarschijnlijk achter een bedrijfsproxy of firewall die de host blokkeert. Schakel over naar de lokale stdio-installatie (npx -y olostep-mcp) — het maakt uitgaande verzoeken naar api.olostep.com in plaats daarvan, wat meestal is toegestaan.

Bewerkte configuratie maar de tool lijst is verouderd

De client heeft de oude configuratie in cache. Volledig afsluiten en opnieuw starten — niet alleen het venster sluiten. Claude Desktop blijft met name draaien in de menubalk / systeemvak.

Windows-specifieke npx fouten

Als npx fouten geeft bij het starten van de server op Windows, gebruik de CMD-ingewikkelde vorm:

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

401 Missing Authorization: Bearer <OLOSTEP_API_KEY>

Je hebt het gehoste eindpunt geraakt zonder een auth-header (of met het verkeerde formaat). Voeg de header toe aan je clientconfiguratie precies zoals getoond in het installatie-tabblad.

Recepten

Kopieer-plak prompts die goed werken met de tools:

Scrape een lijst van product-URL’s: “Ik heb een CSV van 200 Amazon product-URL’s. Batch scrape ze met parser=@olostep/amazon-product en retourneer als JSON.”
Crawl een documentatiesite: “Crawl https://stripe.com/docs met max_pages=50 en include_url_patterns=['/docs/**']. Vat elke sectie samen als markdown.”
Vind concurrenten: “Gebruik answers om de top 5 concurrenten van Notion voor technische documentsites te vinden. Geef naam, homepage en 1-regel positionering terug.”
Kaart dan scrape: “Voer create_map uit op https://example.com gefilterd naar /blog/**, dan batch_scrape_urls op de top 20 resultaten.”

Integraties

Scrapen & extraheren

AI-antwoorden

Batch & crawl

Kaart & zoek

Voordat je begint

Kies een installatiepad

Client installatie

Het juiste hulpmiddel kiezen

Tool details

Problemen oplossen

Recepten

Bron & versies

Scrapen & extraheren

AI-antwoorden

Batch & crawl

Kaart & zoek

​Voordat je begint

​Kies een installatiepad

​Client installatie

​Het juiste hulpmiddel kiezen

​Tool details

​Problemen oplossen

​Recepten

​Bron & versies

Voordat je begint

Kies een installatiepad

Client installatie

Het juiste hulpmiddel kiezen

Tool details

Problemen oplossen

Recepten

Bron & versies