> ## 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.

# Octoparse MCP Server

> Überblick und Schnellstart für den Octoparse MCP Server.

Verbinden Sie die Web-Scraping-Plattform von Octoparse mit jedem MCP-kompatiblen KI-Agenten. Suchen Sie Vorlagen, führen Sie Cloud-Aufgaben aus und rufen Sie Daten ab – alles in natürlicher Sprache.

Funktioniert mit vorgefertigten Octoparse-Vorlagen und cloudfähigen Aufgaben.

## Voraussetzungen

<Steps>
  <Step title="Ein Octoparse-Konto">
    Jedes Octoparse-Konto kann eine Verbindung herstellen. Nutzer des kostenlosen und Basic-Plans erhalten wöchentlich 2.000 kostenlose Datensätze für die MCP-Extraktion – für den Einstieg ist kein Upgrade erforderlich.
  </Step>

  <Step title="Ein MCP-kompatibler Client">
    Zum Beispiel ChatGPT, Codex, Claude, Claude Code, OpenClaw, Cursor, VS Code (GitHub Copilot) oder Antigravity.
  </Step>
</Steps>

***

## Umfang und Einschränkungen

<Columns cols={2}>
  <Card title="✅ Möglich">
    * Vorgefertigte Scraping-Vorlagen suchen
    * Eine neue Cloud-Aufgabe aus einer vorgegebenen Vorlage erstellen und ausführen
    * Läufe cloudfähiger Aufgaben auslösen und überwachen
    * Erfasste Daten exportieren (JSON / CSV)
    * Vorhandene Aufgaben auflisten und durchsuchen
    * Eine laufende Aufgabe starten oder stoppen
    * Einen Gutscheincode einlösen
  </Card>

  <Card title="❌ Nicht möglich">
    * Ausschließlich lokale Aufgaben ausführen (Desktop-Client erforderlich)
    * Vollständig benutzerdefinierte Aufgaben erstellen oder Konfigurationsdetails wie Felder, Paginierung, Schleifen oder Browser-Workflow bearbeiten
    * Benutzerdefinierte Scraping-Vorlagen hochladen
    * Auf Kontoeinstellungen oder Abrechnung zugreifen
    * Ohne vorgegebene Vorlage scrapen
  </Card>
</Columns>

<Note>
  MCP kann aus vorgegebenen Octoparse-Vorlagen neue Cloud-Aufgaben erstellen und ausführen. Vollständig benutzerdefinierte Scraping-Workflows lassen sich damit weder erstellen noch in ihren Konfigurationsdetails bearbeiten. Wenn Sie einen individuellen Workflow benötigen, erstellen Sie ihn zuerst in Octoparse und verwenden Sie MCP anschließend zum Ausführen, Überwachen, Stoppen oder Exportieren.
</Note>

***

## Schnellstart

### Server-URL

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

### Authentifizierungsmethoden

<Columns cols={2}>
  <Card title="Pfad A: OAuth 2.1" icon="lock-keyhole">
    Browserbasierte Anmeldung. Für die meisten Nutzer empfohlen. Kein API-Schlüssel erforderlich – melden Sie sich bei Aufforderung einfach bei Octoparse an.
  </Card>

  <Card title="Pfad B: API-Schlüssel" icon="key">
    Direkte Authentifizierung per API-Schlüssel. Ideal für automatisierte oder monitorlose Umgebungen wie Claude Code, Codex CLI, VS Code, TRAE und OpenClaw.

    Rufen Sie Ihren Schlüssel im [Octoparse-Kontocenter](https://www.octoparse.de/console/account-center/api-keys) ab.
  </Card>
</Columns>

## Unterstützte Clients

Wählen Sie unten Ihren MCP-Client aus und folgen Sie den Einrichtungsschritten.

<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="Personalisierungseinstellungen öffnen">
        Klicken Sie auf Ihren Profilavatar und wählen Sie **ChatGPT personalisieren**.
      </Step>

      <Step title="Entwicklermodus aktivieren">
        Wechseln Sie zu **Apps → Erweiterte Einstellungen** und aktivieren Sie den **Entwicklermodus (Beta)**.
      </Step>

      <Step title="Octoparse-App erstellen">
        Klicken Sie auf **App erstellen**. Setzen Sie den Namen auf `Octoparse` und die MCP-URL auf `https://mcp.octoparse.com`, lassen Sie OAuth-Client-ID und Geheimnis leer, bestätigen Sie den Hinweis und erstellen Sie die App.
      </Step>

      <Step title="Über OAuth autorisieren">
        ChatGPT leitet Sie zu Octoparse weiter. Melden Sie sich an und klicken Sie auf **Zulassen**.
      </Step>
    </Steps>

    [Vollständige Einrichtungsanleitung ansehen](https://helpcenter.octoparse.com/de/articles/13444709-how-to-integrate-octoparse-with-chatgpt-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="codex" title="Codex">
    <Note>Codex CLI und die Codex-IDE-Erweiterung verwenden dieselbe MCP-Konfiguration (`~/.codex/config.toml`). Richten Sie sie einmal ein; sie funktioniert dann in beiden.</Note>

    **Pfad A: OAuth**

    <Steps>
      <Step title="Server hinzufügen">
        ```bash theme={null}
        codex mcp add octoparse --url https://mcp.octoparse.com
        ```
      </Step>

      <Step title="Über OAuth autorisieren">
        ```bash theme={null}
        codex mcp login octoparse
        ```

        Ein Browserfenster wird geöffnet. Melden Sie sich bei Octoparse an und klicken Sie auf **Zulassen**.
      </Step>
    </Steps>

    ***

    **Pfad B: API-Schlüssel**

    Fügen Sie Folgendes zu `~/.codex/config.toml` hinzu:

    ```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">
    **Pfad A: OAuth**

    <Steps>
      <Step title="Einstellungen → Connectors öffnen">
        Wechseln Sie in der Claude-Seitenleiste zu **Einstellungen → Connectors**.
      </Step>

      <Step title="Server-URL hinzufügen">
        Klicken Sie auf **Connector hinzufügen** und geben Sie `https://mcp.octoparse.com` ein.
      </Step>

      <Step title="Über OAuth autorisieren">
        Klicken Sie auf **Verbinden**. Ein Browserfenster wird geöffnet. Melden Sie sich an und klicken Sie auf **Zulassen**.
      </Step>
    </Steps>

    [Vollständige Einrichtungsanleitung ansehen](https://helpcenter.octoparse.com/de/articles/14001844-how-to-integrate-octoparse-with-claude-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="claude-code" title="Claude Code">
    <Note>Mit `claude mcp add` hinzugefügte Server werden von Claude Code CLI, Desktop-App und IDE-Erweiterungen (VS Code / JetBrains) gemeinsam genutzt. Richten Sie den Server einmal ein; er funktioniert dann überall.</Note>

    **Pfad A: OAuth**

    <Steps>
      <Step title="Server hinzufügen">
        ```bash theme={null}
        claude mcp add --transport http octoparse https://mcp.octoparse.com
        ```
      </Step>

      <Step title="Über OAuth autorisieren">
        Starten Sie Claude Code, führen Sie `/mcp` aus und wählen Sie zur Authentifizierung **octoparse**. Ein Browserfenster wird geöffnet – melden Sie sich bei Octoparse an und klicken Sie auf **Zulassen**.
      </Step>
    </Steps>

    ***

    **Pfad B: API-Schlüssel**

    ```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">
    **Pfad A: OAuth**

    <Steps>
      <Step title="OpenClaw installieren">
        Installieren Sie OpenClaw und führen Sie anschließend den Onboarding-Befehl aus.
      </Step>

      <Step title="MCP-Server registrieren">
        Legen Sie den Octoparse MCP Server fest und überprüfen Sie die Konfiguration.
      </Step>

      <Step title="Gateway neu starten">
        Starten Sie das Gateway neu, um die Konfiguration anzuwenden.
      </Step>

      <Step title="Über OAuth autorisieren">
        Ihr erster Octoparse-Toolaufruf öffnet einen Browser für OAuth. Melden Sie sich an und klicken Sie auf **Zulassen**.
      </Step>
    </Steps>

    ***

    **Pfad B: API-Schlüssel**

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

    Fügen Sie anschließend Folgendes zur OpenClaw-Konfiguration hinzu:

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

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

    <Steps>
      <Step title="Cursor-Einstellungen öffnen">
        Öffnen Sie Cursor und klicken Sie oben rechts auf das Einstellungssymbol.
      </Step>

      <Step title="Zu Tools & MCP wechseln">
        Wählen Sie in der linken Seitenleiste **Tools & MCP**.
      </Step>

      <Step title="Benutzerdefinierten MCP-Server hinzufügen">
        Klicken Sie auf **Benutzerdefiniertes MCP hinzufügen**. Cursor öffnet die MCP-Konfigurationsdatei. Fügen Sie `https://mcp.octoparse.com` hinzu und speichern Sie.
      </Step>
    </Steps>

    [Vollständige Einrichtungsanleitung ansehen](https://helpcenter.octoparse.com/de/articles/14013893-how-to-integrate-octoparse-with-cursor-via-mcp-step-by-step)

    ***

    **Pfad B: API-Schlüssel**

    Fügen Sie Folgendes zu `~/.cursor/mcp.json` hinzu:

    ```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>Erfordert ein aktives **GitHub Copilot**-Abonnement.</Info>

    **Pfad A: OAuth**

    Fügen Sie Folgendes zu `.vscode/mcp.json` hinzu:

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

    [Vollständige Einrichtungsanleitung ansehen](https://helpcenter.octoparse.com/de/articles/14004033-how-to-integrate-octoparse-with-vs-code-via-mcp-step-by-step)

    ***

    **Pfad B: API-Schlüssel**

    ```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>Antigravity IDE und Antigravity CLI verwenden dieselbe MCP-Konfiguration (`~/.gemini/config/mcp_config.json`). Richten Sie sie einmal ein; sie funktioniert dann in beiden. In der IDE können Sie sie auch im Agentenbereich über **MCP Servers → View raw config** öffnen.</Note>

    **Pfad A: OAuth**

    Fügen Sie Folgendes zu `~/.gemini/config/mcp_config.json` hinzu:

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

    Aktualisieren Sie die MCP-Serverliste. Ihr erster Octoparse-Toolaufruf öffnet einen Browser für OAuth – melden Sie sich an und klicken Sie auf **Zulassen**.

    ***

    **Pfad B: API-Schlüssel**

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