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

# Server MCP Octoparse

> Panoramica e guida rapida per il server MCP Octoparse.

Collega la piattaforma di web scraping Octoparse a qualsiasi agente AI compatibile con MCP. Cerca modelli, esegui attività cloud e recupera dati, tutto tramite linguaggio naturale.

Funziona con i modelli Octoparse predefiniti e le attività supportate nel cloud.

## Prerequisiti

<Steps>
  <Step title="Un account Octoparse">
    È possibile connettere qualsiasi account Octoparse. Gli utenti dei piani Gratuito e Basic ricevono 2.000 record gratuiti alla settimana per l'estrazione MCP: non è necessario alcun upgrade per iniziare.
  </Step>

  <Step title="Un client compatibile con MCP">
    Ad esempio ChatGPT, Codex, Claude, Claude Code, OpenClaw, Cursor, VS Code (GitHub Copilot) o Antigravity.
  </Step>
</Steps>

***

## Ambito e limitazioni

<Columns cols={2}>
  <Card title="✅ Operazioni supportate">
    * Cercare modelli di scraping predefiniti
    * Creare una nuova attività cloud da un modello preimpostato ed eseguirla
    * Avviare e monitorare le esecuzioni delle attività supportate nel cloud
    * Esportare i dati raccolti (JSON / CSV)
    * Elencare e cercare le attività esistenti
    * Avviare o interrompere un'attività in esecuzione
    * Riscattare un codice coupon
  </Card>

  <Card title="❌ Operazioni non supportate">
    * Eseguire attività disponibili solo in locale (è necessario il client desktop)
    * Creare attività completamente personalizzate o modificare dettagli della configurazione quali campi, impaginazione, loop o flusso di lavoro del browser
    * Caricare modelli di scraping personalizzati
    * Accedere alle impostazioni dell'account o alla fatturazione
    * Eseguire lo scraping senza un modello preimpostato
  </Card>
</Columns>

<Note>
  MCP può creare ed eseguire nuove attività cloud dai modelli preimpostati Octoparse. Non può creare flussi di scraping completamente personalizzati né modificarne i dettagli di configurazione. Se ti serve un flusso di lavoro personalizzato, crealo prima in Octoparse, quindi usa MCP per eseguirlo, monitorarlo, interromperlo o esportarlo.
</Note>

***

## Guida rapida

### URL del server

```text Server URL theme={null}
https://mcp.octoparse.com
```

### Metodi di autenticazione

<Columns cols={2}>
  <Card title="Percorso A: OAuth 2.1" icon="lock-keyhole">
    Accesso tramite browser. Consigliato per la maggior parte degli utenti. Non è necessaria una chiave API: accedi semplicemente a Octoparse quando richiesto.
  </Card>

  <Card title="Percorso B: chiave API" icon="key">
    Autenticazione diretta con chiave API. Ideale per ambienti automatizzati o headless come Claude Code, Codex CLI, VS Code, TRAE e OpenClaw.

    Ottieni la chiave dal [centro account Octoparse](https://www.octoparse.it/console/account-center/api-keys).
  </Card>
</Columns>

## Client supportati

Scegli il tuo client MCP di seguito e segui i passaggi di configurazione.

<div className="mb-8 grid grid-cols-2 gap-2 sm:grid-cols-4">
  <a href="#chatgpt" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/chatgpt.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>ChatGPT</span>
  </a>

  <a href="#codex" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/codex.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=56e3220fb8fd0f8dd7aa931b0836e0cf" alt="" className="h-6 w-6 shrink-0" width="36" height="36" data-path="images/mcp/codex.svg" />

    <span>Codex</span>
  </a>

  <a href="#claude" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/claude.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>Claude</span>
  </a>

  <a href="#claude-code" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/claude-code.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=41a82256b2cd0af12c8c70542c817228" alt="" className="h-6 w-6 shrink-0" width="36" height="36" data-path="images/mcp/claude-code.svg" />

    <span>Claude Code</span>
  </a>

  <a href="#openclaw" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/openclaw.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>OpenClaw</span>
  </a>

  <a href="#cursor" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/cursor.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>Cursor</span>
  </a>

  <a href="#vs-code" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://op-official-us-1251101074.cos.na-siliconvalley.myqcloud.com/mcp/vscode.svg" alt="" className="h-6 w-6 shrink-0" />

    <span>VS Code</span>
  </a>

  <a href="#antigravity" className="flex min-h-14 items-center gap-3 rounded-lg border border-gray-200 px-3 py-2 text-sm font-medium text-gray-900 no-underline transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-700 dark:text-gray-100 dark:hover:border-gray-600 dark:hover:bg-gray-900/40">
    <img src="https://mintcdn.com/octoparse/JjtZ5xTfKo3caPro/images/mcp/antigravity.svg?fit=max&auto=format&n=JjtZ5xTfKo3caPro&q=85&s=fabe46bcd843c81a23b16f27bc031b23" alt="" className="h-6 w-6 shrink-0" width="36" height="36" data-path="images/mcp/antigravity.svg" />

    <span>Antigravity</span>
  </a>
</div>

<AccordionGroup>
  <Accordion id="chatgpt" title="ChatGPT">
    <Steps>
      <Step title="Apri le impostazioni di personalizzazione">
        Fai clic sull'avatar del profilo e scegli **Personalizza ChatGPT**.
      </Step>

      <Step title="Abilita la modalità sviluppatore">
        Vai a **App → Impostazioni avanzate** e attiva **Modalità sviluppatore (Beta)**.
      </Step>

      <Step title="Crea l'app Octoparse">
        Fai clic su **Crea app**. Imposta il nome su `Octoparse` e l'URL MCP su `https://mcp.octoparse.com`, lascia vuoti ID client OAuth e Segreto, conferma la presa visione e crea l'app.
      </Step>

      <Step title="Autorizza tramite OAuth">
        ChatGPT reindirizza a Octoparse. Accedi e fai clic su **Consenti**.
      </Step>
    </Steps>

    [Consulta la guida completa alla configurazione](https://helpcenter.octoparse.com/it/articles/13444709-how-to-integrate-octoparse-with-chatgpt-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="codex" title="Codex">
    <Note>La CLI di Codex e l'estensione Codex per IDE condividono la stessa configurazione MCP (`~/.codex/config.toml`). Configurala una volta e funzionerà in entrambe.</Note>

    **Percorso A: OAuth**

    <Steps>
      <Step title="Aggiungi il server">
        ```bash theme={null}
        codex mcp add octoparse --url https://mcp.octoparse.com
        ```
      </Step>

      <Step title="Autorizza tramite OAuth">
        ```bash theme={null}
        codex mcp login octoparse
        ```

        Si apre una finestra del browser. Accedi a Octoparse e fai clic su **Consenti**.
      </Step>
    </Steps>

    ***

    **Percorso B: chiave API**

    Aggiungi a `~/.codex/config.toml`:

    ```toml theme={null}
        [mcp_servers.octoparse]
        url = "https://mcp.octoparse.com"
        http_headers = { "x-api-key" = "YOUR_API_KEY" }
    ```
  </Accordion>

  <Accordion id="claude" title="Claude">
    **Percorso A: OAuth**

    <Steps>
      <Step title="Apri Impostazioni → Connettori">
        Nella barra laterale di Claude, vai a **Impostazioni → Connettori**.
      </Step>

      <Step title="Aggiungi l'URL del server">
        Fai clic su **Aggiungi connettore** e inserisci `https://mcp.octoparse.com`.
      </Step>

      <Step title="Autorizza tramite OAuth">
        Fai clic su **Connetti**. Si apre una finestra del browser. Accedi e fai clic su **Consenti**.
      </Step>
    </Steps>

    [Consulta la guida completa alla configurazione](https://helpcenter.octoparse.com/it/articles/14001844-how-to-integrate-octoparse-with-claude-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="claude-code" title="Claude Code">
    <Note>I server aggiunti con `claude mcp add` sono condivisi tra la CLI di Claude Code, l'app desktop e le estensioni IDE (VS Code / JetBrains). Configuralo una volta e funzionerà ovunque.</Note>

    **Percorso A: OAuth**

    <Steps>
      <Step title="Aggiungi il server">
        ```bash theme={null}
        claude mcp add --transport http octoparse https://mcp.octoparse.com
        ```
      </Step>

      <Step title="Autorizza tramite OAuth">
        Avvia Claude Code ed esegui `/mcp`, quindi seleziona **octoparse** per l'autenticazione. Si apre una finestra del browser: accedi a Octoparse e fai clic su **Consenti**.
      </Step>
    </Steps>

    ***

    **Percorso B: chiave API**

    ```bash theme={null}
    claude mcp add --transport http octoparse https://mcp.octoparse.com --header "x-api-key: YOUR_API_KEY"
    ```
  </Accordion>

  <Accordion id="openclaw" title="OpenClaw">
    **Percorso A: OAuth**

    <Steps>
      <Step title="Installa OpenClaw">
        Installa OpenClaw, quindi esegui il comando di onboarding.
      </Step>

      <Step title="Registra il server MCP">
        Imposta il server MCP Octoparse e verifica la configurazione.
      </Step>

      <Step title="Riavvia il gateway">
        Riavvia il gateway per applicare la configurazione.
      </Step>

      <Step title="Autorizza tramite OAuth">
        La prima chiamata a uno strumento Octoparse apre un browser per OAuth. Accedi e fai clic su **Consenti**.
      </Step>
    </Steps>

    ***

    **Percorso B: chiave API**

    ```bash theme={null}
        mcporter config add octoparse https://mcp.octoparse.com
        mcporter config set octoparse header.x-api-key "YOUR_API_KEY"
    ```

    Quindi aggiungi alla configurazione di OpenClaw:

    ```json theme={null}
        {
          "mcp": {
            "servers": {
              "octoparse": {
                "command": "mcporter",
                "args": ["run", "stdio", "--server", "octoparse"]
              }
            }
          }
        }
    ```
  </Accordion>

  <Accordion id="cursor" title="Cursor">
    **Percorso A: OAuth**

    <Steps>
      <Step title="Apri le impostazioni di Cursor">
        Apri Cursor e fai clic sull'icona delle impostazioni nell'angolo in alto a destra.
      </Step>

      <Step title="Vai a Strumenti e MCP">
        Nella barra laterale sinistra, seleziona **Strumenti e MCP**.
      </Step>

      <Step title="Aggiungi un server MCP personalizzato">
        Fai clic su **Aggiungi MCP personalizzato**. Cursor apre il file di configurazione MCP. Aggiungi `https://mcp.octoparse.com` e salva.
      </Step>
    </Steps>

    [Consulta la guida completa alla configurazione](https://helpcenter.octoparse.com/it/articles/14013893-how-to-integrate-octoparse-with-cursor-via-mcp-step-by-step)

    ***

    **Percorso B: chiave API**

    Aggiungi a `~/.cursor/mcp.json`:

    ```json theme={null}
        {
          "mcpServers": {
            "octoparse": {
              "type": "http",
              "url": "https://mcp.octoparse.com",
              "headers": {
                "x-api-key": "YOUR_API_KEY"
              }
            }
          }
        }
    ```
  </Accordion>

  <Accordion id="vs-code" title="VS Code">
    <Info>Richiede un abbonamento **GitHub Copilot** attivo.</Info>

    **Percorso A: OAuth**

    Aggiungi a `.vscode/mcp.json`:

    ```json theme={null}
        {
          "servers": {
            "octoparse": {
              "type": "http",
              "url": "https://mcp.octoparse.com"
            }
          }
        }
    ```

    [Consulta la guida completa alla configurazione](https://helpcenter.octoparse.com/it/articles/14004033-how-to-integrate-octoparse-with-vs-code-via-mcp-step-by-step)

    ***

    **Percorso B: chiave API**

    ```json theme={null}
        {
          "servers": {
            "octoparse": {
              "type": "http",
              "url": "https://mcp.octoparse.com",
              "headers": {
                "x-api-key": "YOUR_API_KEY"
              }
            }
          }
        }
    ```
  </Accordion>

  <Accordion id="antigravity" title="Antigravity">
    <Note>L'IDE Antigravity e la CLI Antigravity condividono la stessa configurazione MCP (`~/.gemini/config/mcp_config.json`). Configurala una volta e funzionerà in entrambe. Nell'IDE, puoi anche aprirla dal pannello dell'agente: **Server MCP → Visualizza configurazione non elaborata**.</Note>

    **Percorso A: OAuth**

    Aggiungi a `~/.gemini/config/mcp_config.json`:

    ```json theme={null}
        {
          "mcpServers": {
            "octoparse": {
              "serverUrl": "https://mcp.octoparse.com"
            }
          }
        }
    ```

    Aggiorna l'elenco dei server MCP. La prima chiamata a uno strumento Octoparse apre un browser per OAuth: accedi e fai clic su **Consenti**.

    ***

    **Percorso B: chiave API**

    ```json theme={null}
        {
          "mcpServers": {
            "octoparse": {
              "serverUrl": "https://mcp.octoparse.com",
              "headers": {
                "x-api-key": "YOUR_API_KEY"
              }
            }
          }
        }
    ```
  </Accordion>
</AccordionGroup>