Olostep MCP Server

Il server Olostep MCP fornisce a qualsiasi client AI compatibile con MCP (Claude, Cursor, Windsurf, VS Code, Claude Code, ecc.) 10 strumenti pronti all’uso per il web dal vivo — scraping, ricerca, risposte AI con citazioni, lavori batch, crawling di siti e scoperta di URL.

Scrape & extract

Estrai markdown, HTML, JSON o testo da qualsiasi URL con rendering JS opzionale

Risposte AI

Risposte basate sul web con fonti e output strutturato

Batch & crawl

Fino a 100k URL in parallelo, o scopri autonomamente un intero sito

Mappa & ricerca

Trova ogni URL su un sito, o esegui una ricerca web basata su parser

Prima di iniziare

Hai bisogno di una chiave API Olostep. Ottienila dal dashboard di Olostep — il livello gratuito copre l’uso personale.

Scegli un percorso di configurazione

Il percorso più veloce per ogni client è l’endpoint ospitato su https://mcp.olostep.com/mcp. Nessuna installazione, nessun Node, nessun Docker — basta incollare un URL e la tua chiave API. Se hai bisogno che funzioni completamente in locale (uso offline, proxy aziendale, ambiente isolato), ogni client supporta anche un’installazione local stdio tramite npx. Ogni sezione sottostante mostra entrambi.

L’endpoint ospitato utilizza Authorization: Bearer YOUR_API_KEY. L’installazione local stdio utilizza OLOSTEP_API_KEY come variabile d’ambiente. Non confonderli — il modo di autenticazione errato è l’errore di onboarding numero 1.

Configurazione del client

Installazione con un clic (consigliata):

Sostituisci YOUR_API_KEY nella configurazione risultante con la tua chiave reale.Configurazione manuale:Crea o modifica .cursor/mcp.json nella radice del tuo progetto (o ~/.cursor/mcp.json per globale):

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

Installazione local stdio (opzionale)

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

Richiede Node.js 18+ sulla tua macchina.

Verifica: Apri Cursor → Impostazioni → MCP. Dovresti vedere olostep elencato con 10 strumenti inclusi scrape_website. Se vedi “Connesso, 0 strumenti”, la tua chiave API è errata.

Installazione CLI (consigliata):

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

Configurazione manuale:Aggiungi alla tua configurazione MCP di Claude Code (.mcp.json nella radice del progetto, o ~/.claude.json globalmente):

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

Installazione local stdio (opzionale)

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

Oppure come JSON:

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

Verifica: Esegui /mcp in Claude Code. Dovresti vedere olostep connesso con 10 strumenti.

Posizione del file di configurazione:

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

Ospitato (consigliato):

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

Installazione local stdio (opzionale)

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

Oppure installa tramite Smithery:

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

Claude Desktop deve essere completamente chiuso e riavviato affinché le modifiche alla configurazione abbiano effetto — chiudere la finestra non è sufficiente (rimane in esecuzione nella barra dei menu / tray di sistema).

Verifica: Apri Claude Desktop → cerca l’icona 🔨 (martello) nell’input della chat. Cliccala — dovresti vedere elencati 10 strumenti Olostep.

Il supporto MCP di VS Code è integrato in GitHub Copilot (modalità Agent). Aggiungi questo a .vscode/mcp.json nel tuo progetto, o nel tuo settings.json utente:

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

Installazione local stdio (opzionale)

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

Verifica: Apri il pannello di chat di Copilot → passa alla modalità Agent → il popover degli strumenti dovrebbe elencare gli strumenti Olostep.

Aggiungi a ~/.codeium/windsurf/mcp_config.json:

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

Installazione local stdio (opzionale)

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

Verifica: Cascade → Impostazioni → MCP. olostep dovrebbe apparire con 10 strumenti.

Se preferisci eseguire il server in un container (CI, ambiente isolato, nessun Node sull’host):

docker pull olostep/mcp-server

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

In una configurazione client MCP (stdio):

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

Supporta linux/amd64 e linux/arm64. Codice sorgente su GitHub.

Apri il dashboard di Metorial
Vai a MCP Servers
Cerca Olostep
Clicca su Install e incolla la tua chiave API

Per la configurazione manuale:

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

Scegliere lo strumento giusto

Il server MCP espone 10 strumenti. Usa questo albero decisionale per scegliere quello giusto — l’agente usa lo stesso ragionamento:

Vuoi…	Usa	Note
Il contenuto di una pagina specifica	`scrape_website` o `get_webpage_content`	Imposta `wait_before_scraping=2000–5000` per SPA
Una risposta web in linguaggio naturale con fonti	`answers`	Restituisce sintesi AI + citazioni
Risultati di ricerca per una query	`search_web`	Basato su parser, non AI, strutturato
Un elenco di URL su un sito	`create_map`	Solo scoperta URL — NON effettua scraping
URL filtrati per query	`get_website_urls`	Classificati per rilevanza alla tua `search_query`
Molti URL noti contemporaneamente	`batch_scrape_urls` + `get_batch_results`	Async — avvia, poi interroga
Un intero sito o sezione	`create_crawl` + `get_crawl_results`	Async — segue i link da un URL iniziale

Scraping di un intero sito? Usa create_crawl, non batch_scrape_urls. Crawl scopre E effettua scraping. Batch è per un elenco noto di URL che hai già.

Dettagli degli strumenti

scrape_website

Estrai contenuto da un singolo URL. Supporta markdown, html, json, text. Opzionale country per richieste geo-mirate, wait_before_scraping (0–10000 ms) per siti pesanti in JS, e parser (es. @olostep/amazon-product) per estrazione strutturata.

get_webpage_content

Versione leggera solo markdown di scrape_website. Usa quando vuoi solo markdown pulito e non hai bisogno di opzioni di formato.

search_web

Risultati di ricerca web strutturati (basati su parser) per una query. Opzionale country per risultati localizzati. Restituisce JSON, non prosa AI.

answers

Risposta AI a un task con fonti e citazioni. Passa un argomento json per ottenere la risposta in una forma specifica — sia uno schema JSON che una breve descrizione in linguaggio naturale.

batch_scrape_urls

Scraping asincrono di 2–100k URL che hai già. Restituisce un batch_id — poi chiama get_batch_results per recuperare il contenuto. Imposta wait_for_completion_seconds (fino a 900) se vuoi una singola chiamata bloccante invece di interrogare. Consigliato: 60 per batch sotto i 50 URL, 300–600 per 50–1k, 0 (interroga separatamente) per batch più grandi.

get_batch_results

Recupera lo stato e il contenuto estratto per un batch_id. Restituisce processing finché non è completato, poi completed con l’array degli elementi.

create_crawl

Crawl asincrono che segue i link da un start_url. Usa include_url_patterns / exclude_url_patterns (sintassi glob come /blog/**) per delimitare. Restituisce un crawl_id — poi chiama get_crawl_results.

get_crawl_results

Recupera lo stato e le pagine per un crawl_id. Supporta la paginazione tramite cursor e items_limit (max 100 per chiamata). Restituisce in_progress finché non è completato.

create_map

Ottieni un elenco di URL su un sito. Solo scoperta URL — non effettua scraping. Usa quando vuoi far emergere URL candidati (es. lasciare che l’utente scelga un sottoinsieme). Supporta include_url_patterns / exclude_url_patterns e search_query.

get_website_urls

Come create_map, ma gli URL sono classificati per rilevanza a una search_query richiesta. Usa quando vuoi i primi N link corrispondenti su un sito.

Risoluzione dei problemi

Il server appare ma mostra 0 strumenti

La tua chiave API è invalida o limitata nel rate. Apri il dashboard delle chiavi API e verifica la chiave. Se usi l’endpoint ospitato, l’intestazione deve essere esattamente Authorization: Bearer sk_... — senza virgolette intorno al valore, senza spazi extra.

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

Node.js non è installato (o non è nel tuo PATH). Installa Node 18+ da nodejs.org, poi riavvia il tuo terminale e il tuo client MCP. Su Windows, passa a un CMD/PowerShell che ha Node nel PATH.

Connessione rifiutata o errori DNS su mcp.olostep.com

Probabilmente sei dietro un proxy aziendale o un firewall che blocca l’host. Passa all’installazione local stdio (npx -y olostep-mcp) — effettua richieste in uscita a api.olostep.com invece, che di solito è consentito.

Configurazione modificata ma l'elenco degli strumenti è obsoleto

Il client ha memorizzato nella cache la vecchia configurazione. Chiudi completamente e riavvia — non solo chiudere la finestra. Claude Desktop in particolare continua a funzionare nella barra dei menu / tray di sistema.

Errori specifici di Windows con npx

Se npx genera errori avviando il server su Windows, usa la forma avvolta da CMD:

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

401 Missing Authorization: Bearer <OLOSTEP_API_KEY>

Hai colpito l’endpoint ospitato senza un’intestazione di autenticazione (o con il formato sbagliato). Aggiungi l’intestazione alla configurazione del tuo client esattamente come mostrato nella scheda di configurazione.

Ricette

Prompt da copiare e incollare che funzionano bene con gli strumenti:

Scrape di un elenco di URL di prodotti: “Ho un CSV di 200 URL di prodotti Amazon. Effettua lo scraping batch con parser=@olostep/amazon-product e restituisci come JSON.”
Crawl di un sito di documentazione: “Crawl https://stripe.com/docs con max_pages=50 e include_url_patterns=['/docs/**']. Riassumi ogni sezione come markdown.”
Trova concorrenti: “Usa answers per trovare i primi 5 concorrenti di Notion per siti di documentazione tecnica. Restituisci nome, homepage e posizionamento in una riga.”
Mappa poi scrape: “Esegui create_map su https://example.com filtrato su /blog/**, poi batch_scrape_urls sui primi 20 risultati.”

Integrazioni

Scrape & extract

Risposte AI

Batch & crawl

Mappa & ricerca

Prima di iniziare

Scegli un percorso di configurazione

Configurazione del client

Scegliere lo strumento giusto

Dettagli degli strumenti

Risoluzione dei problemi

Ricette

Fonte & versioni

Scrape & extract

Risposte AI

Batch & crawl

Mappa & ricerca

​Prima di iniziare

​Scegli un percorso di configurazione

​Configurazione del client

​Scegliere lo strumento giusto

​Dettagli degli strumenti

​Risoluzione dei problemi

​Ricette

​Fonte & versioni

Prima di iniziare

Scegli un percorso di configurazione

Configurazione del client

Scegliere lo strumento giusto

Dettagli degli strumenti

Risoluzione dei problemi

Ricette

Fonte & versioni