> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Olostep MCP Server

> Geef elke MCP-compatibele AI-client webscraping, zoeken, crawlen en AI-antwoordtools in minder dan een minuut

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

<CardGroup cols={2}>
  <Card title="Scrape & extract" icon="file-lines">
    Haal markdown, HTML, JSON of tekst op van elke URL met optionele JS-rendering
  </Card>

  <Card title="AI answers" icon="sparkles">
    Web-gebaseerde antwoorden met bronnen en gestructureerde output
  </Card>

  <Card title="Batch & crawl" icon="layer-group">
    Tot 10k URL's parallel, of ontdek autonoom een hele site
  </Card>

  <Card title="Map & search" icon="map">
    Vind elke URL op een site, of voer parser-gebaseerd webzoeken uit
  </Card>
</CardGroup>

## Voordat je begint

Je hebt een Olostep API-sleutel nodig. Verkrijg er een via het [Olostep dashboard](https://www.olostep.com/dashboard/api-keys) — de gratis versie dekt persoonlijk gebruik.

## Kies een installatiepad

Het snelste pad voor elke client is de **gehoste endpoint** 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 wilt laten draaien (offline gebruik, bedrijfsproxy, air-gapped), ondersteunt elke client ook een **lokale stdio** installatie via `npx`. Elke sectie hieronder toont beide.

<Note>
  **Gehoste endpoint** 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.
</Note>

## Client installatie

<Tabs>
  <Tab title="Cursor">
    **Een-klik installatie (aanbevolen):**

    <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=olostep&config=eyJ1cmwiOiJodHRwczovL21jcC5vbG9zdGVwLmNvbS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgWU9VUl9BUElfS0VZIn19">
      <img src="https://cursor.com/deeplink/mcp-install-dark.png" alt="Voeg Olostep MCP-server toe aan Cursor" style={{ maxHeight: 32 }} />
    </a>

    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):

    ```json theme={null}
    {
      "mcpServers": {
        "olostep": {
          "url": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="Lokale stdio installatie (optioneel)">
      ```json theme={null}
      {
        "mcpServers": {
          "olostep": {
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```

      Vereist Node.js 18+ op je machine.
    </Accordion>

    **Verifiëren:** Open Cursor → Instellingen → MCP. Je zou `olostep` moeten zien met **10 tools** inclusief `scrape_website`. Als je "Connected, 0 tools" ziet, is je API-sleutel verkeerd.
  </Tab>

  <Tab title="Claude Code">
    **CLI installatie (aanbevolen):**

    ```bash theme={null}
    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):

    ```json theme={null}
    {
      "mcpServers": {
        "olostep": {
          "url": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="Lokale stdio installatie (optioneel)">
      ```bash theme={null}
      claude mcp add --transport stdio --env OLOSTEP_API_KEY=YOUR_API_KEY olostep \
        -- npx -y olostep-mcp
      ```

      Of als JSON:

      ```json theme={null}
      {
        "mcpServers": {
          "olostep": {
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```
    </Accordion>

    **Verifiëren:** Voer `/mcp` uit in Claude Code. Je zou `olostep` verbonden moeten zien met 10 tools.
  </Tab>

  <Tab title="Claude Desktop">
    **Configuratiebestand 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):**

    ```json theme={null}
    {
      "mcpServers": {
        "olostep": {
          "url": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="Lokale stdio installatie (optioneel)">
      ```json theme={null}
      {
        "mcpServers": {
          "olostep": {
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```

      Of installeer via Smithery:

      ```bash theme={null}
      npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude
      ```
    </Accordion>

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

    **Verifiëren:** Open Claude Desktop → zoek naar het 🔨 (hamer) icoon in het chatinvoerveld. Klik erop — je zou 10 Olostep-tools moeten zien.
  </Tab>

  <Tab title="VS Code">
    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`:

    ```json theme={null}
    {
      "servers": {
        "olostep": {
          "type": "http",
          "url": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="Lokale stdio installatie (optioneel)">
      ```json theme={null}
      {
        "servers": {
          "olostep": {
            "type": "stdio",
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```
    </Accordion>

    **Verifiëren:** Open het Copilot-chatpaneel → schakel over naar Agent-modus → de toolspopover zou Olostep-tools moeten tonen.
  </Tab>

  <Tab title="Windsurf">
    Voeg toe aan `~/.codeium/windsurf/mcp_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "olostep": {
          "serverUrl": "https://mcp.olostep.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Accordion title="Lokale stdio installatie (optioneel)">
      ```json theme={null}
      {
        "mcpServers": {
          "olostep": {
            "command": "npx",
            "args": ["-y", "olostep-mcp"],
            "env": {
              "OLOSTEP_API_KEY": "YOUR_API_KEY"
            }
          }
        }
      }
      ```
    </Accordion>

    **Verifiëren:** Cascade → Instellingen → MCP. `olostep` zou moeten verschijnen met 10 tools.
  </Tab>

  <Tab title="Docker">
    Als je de server liever in een container wilt draaien (CI, geïsoleerde omgeving, geen Node op host):

    ```bash theme={null}
    docker pull olostep/mcp-server

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

    In een MCP-clientconfiguratie (stdio):

    ```json theme={null}
    {
      "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](https://github.com/olostep/olostep-mcp-server).
  </Tab>

  <Tab title="Metorial">
    1. Open het [Metorial dashboard](https://metorial.com)
    2. Navigeer naar **MCP Servers**
    3. Zoek naar **Olostep**
    4. Klik op **Installeren** en plak je API-sleutel

    Voor handmatige configuratie:

    ```json theme={null}
    {
      "olostep": {
        "command": "npx",
        "args": ["-y", "olostep-mcp"],
        "env": {
          "OLOSTEP_API_KEY": "YOUR_API_KEY"
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Het juiste hulpmiddel kiezen

De MCP-server biedt 10 tools. Gebruik deze beslisboom om de juiste 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 + citaten                         |
| 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 pollen                           |
| Een hele site of sectie                         | `create_crawl` + `get_crawl_results`      | Async — volgt links vanaf een start-URL             |

<Tip>
  **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.
</Tip>

### Tooldetails

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

<Accordion title="get_webpage_content">
  Lichte markdown-only versie van `scrape_website`. Gebruik wanneer je alleen schone markdown wilt en geen opmaakopties nodig hebt.
</Accordion>

<Accordion title="search_web">
  Gestructureerde (parser-gebaseerde) webzoekresultaten voor een query. Optioneel `country` voor gelokaliseerde resultaten. Geeft JSON, geen AI-proza.
</Accordion>

<Accordion title="answers">
  AI-gestuurd antwoord op een `task` met bronnen en citaten. Geef een `json` argument door om het antwoord in een specifieke vorm te krijgen — ofwel een JSON-schema of een korte natuurlijke-taalbeschrijving.
</Accordion>

<Accordion title="batch_scrape_urls">
  Async scrape van 2–10k URL's die je al hebt. Geeft een `batch_id` — roep dan `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 pollen. Aanbevolen: 60 voor batches onder 50 URL's, 300–600 voor 50–1k, 0 (apart pollen) voor grotere batches.
</Accordion>

<Accordion title="get_batch_results">
  Haalt de status en gescrapete inhoud op voor een `batch_id`. Geeft `processing` totdat het klaar is, dan `completed` met de items-array.
</Accordion>

<Accordion title="create_crawl">
  Async crawl die links volgt vanaf een `start_url`. Gebruik `include_url_patterns` / `exclude_url_patterns` (glob-syntaxis zoals `/blog/**`) om te beperken. Geeft een `crawl_id` — roep dan `get_crawl_results` aan.
</Accordion>

<Accordion title="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` totdat het klaar is.
</Accordion>

<Accordion title="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`.
</Accordion>

<Accordion title="get_website_urls">
  Net als `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.
</Accordion>

## Problemen oplossen

<Accordion title="Server verschijnt maar toont 0 tools">
  Je API-sleutel is ongeldig of beperkt. Open het [API-sleuteldashboard](https://www.olostep.com/dashboard/api-keys) en controleer de sleutel. Als je de gehoste endpoint gebruikt, moet de header **exact** zijn `Authorization: Bearer sk_...` — geen aanhalingstekens rond de waarde, geen extra spaties.
</Accordion>

<Accordion title="`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](https://nodejs.org/), herstart dan je terminal **en** je MCP-client. Op Windows, schakel over naar een CMD/PowerShell die Node op de PATH heeft.
</Accordion>

<Accordion title="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`) — deze maakt uitgaande verzoeken naar `api.olostep.com` in plaats daarvan, wat meestal is toegestaan.
</Accordion>

<Accordion title="Bewerkte configuratie maar de toolslijst is verouderd">
  De client heeft de oude configuratie in de cache opgeslagen. Volledig afsluiten en opnieuw starten — niet alleen het venster sluiten. Claude Desktop blijft met name actief in de menubalk / systeemvak.
</Accordion>

<Accordion title="Windows-specifieke `npx` fouten">
  Als `npx` fouten geeft bij het starten van de server op Windows, gebruik de CMD-omsloten vorm:

  ```json theme={null}
  {
    "command": "cmd",
    "args": ["/c", "npx", "-y", "olostep-mcp"],
    "env": { "OLOSTEP_API_KEY": "YOUR_API_KEY" }
  }
  ```
</Accordion>

<Accordion title="`401 Missing Authorization: Bearer <OLOSTEP_API_KEY>`">
  Je hebt de gehoste endpoint geraakt zonder een auth-header (of met het verkeerde formaat). Voeg de header toe aan je clientconfiguratie precies zoals getoond in het installatie-tabblad.
</Accordion>

## 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](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 documentatiesites te vinden. Retourneer naam, homepage en 1-regel positionering."*
* **Map dan scrape:** *"Voer `create_map` uit op [https://example.com](https://example.com) gefilterd naar `/blog/**`, dan `batch_scrape_urls` op de top 20 resultaten."*

## Bron & versies

* [GitHub repo](https://github.com/olostep/olostep-mcp-server)
* [npm package](https://www.npmjs.com/package/olostep-mcp)
* [Docker Hub](https://hub.docker.com/r/olostep/mcp-server)
* [MCP Registry](https://registry.modelcontextprotocol.io/)