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

# Servidor MCP de Octoparse

> Descripción general y guía de inicio rápido del servidor MCP de Octoparse.

Conecta la plataforma de web scraping de Octoparse con cualquier agente de IA compatible con MCP. Busca plantillas, ejecuta tareas en la nube y recupera datos, todo mediante lenguaje natural.

Funciona con las plantillas prediseñadas de Octoparse y las tareas compatibles con la nube.

## Requisitos previos

<Steps>
  <Step title="Una cuenta de Octoparse">
    Puedes conectar cualquier cuenta de Octoparse. Los usuarios de los planes Gratuito y Básico reciben 2000 registros gratuitos por semana para la extracción mediante MCP; no es necesario actualizar el plan para empezar.
  </Step>

  <Step title="Un cliente compatible con MCP">
    Por ejemplo, ChatGPT, Codex, Claude, Claude Code, OpenClaw, Cursor, VS Code (GitHub Copilot) o Antigravity.
  </Step>
</Steps>

***

## Alcance y limitaciones

<Columns cols={2}>
  <Card title="✅ Funciones disponibles">
    * Buscar plantillas de web scraping prediseñadas
    * Crear y ejecutar una nueva tarea en la nube a partir de una plantilla predefinida
    * Iniciar y supervisar ejecuciones de tareas compatibles con la nube
    * Exportar los datos recopilados (JSON/CSV)
    * Enumerar y buscar tareas existentes
    * Iniciar o detener una tarea en ejecución
    * Canjear un código de cupón
  </Card>

  <Card title="❌ Funciones no disponibles">
    * Ejecutar tareas que solo admiten ejecución local (requieren el cliente de escritorio)
    * Crear tareas totalmente personalizadas o editar detalles de configuración como campos, paginación, bucles o el flujo del navegador
    * Subir plantillas de web scraping personalizadas
    * Acceder a los ajustes de la cuenta o la facturación
    * Extraer datos sin una plantilla predefinida
  </Card>
</Columns>

<Note>
  MCP puede crear y ejecutar nuevas tareas en la nube a partir de plantillas predefinidas de Octoparse. No puede crear flujos de web scraping totalmente personalizados ni editar la configuración detallada de una tarea personalizada. Si necesitas un flujo personalizado, créalo primero en Octoparse y después usa MCP para ejecutarlo, supervisarlo, detenerlo o exportarlo.
</Note>

***

## Inicio rápido

### URL del servidor

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

### Métodos de autenticación

<Columns cols={2}>
  <Card title="Opción A: OAuth 2.1" icon="lock-keyhole">
    Inicio de sesión mediante el navegador. Recomendado para la mayoría de los usuarios. No necesitas una clave de API: inicia sesión en Octoparse cuando se te solicite.
  </Card>

  <Card title="Opción B: clave de API" icon="key">
    Autenticación directa mediante una clave de API. Es la mejor opción para entornos automatizados o sin interfaz gráfica, como Claude Code, Codex CLI, VS Code, TRAE y OpenClaw.

    Obtén la clave en el [centro de cuentas de Octoparse](https://www.octoparse.es/console/account-center/api-keys).
  </Card>
</Columns>

## Clientes compatibles

Elige tu cliente MCP y sigue los pasos de configuración.

<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="Abre los ajustes de personalización">
        Haz clic en el avatar de tu perfil y selecciona **Personalizar ChatGPT**.
      </Step>

      <Step title="Activa el modo de desarrollador">
        Ve a **Aplicaciones → Configuración avanzada** y activa **Modo de desarrollador (beta)**.
      </Step>

      <Step title="Crea la aplicación de Octoparse">
        Haz clic en **Crear aplicación**. Establece `Octoparse` como nombre y `https://mcp.octoparse.com` como URL de MCP, deja en blanco el ID y el secreto del cliente OAuth, confirma el aviso y crea la aplicación.
      </Step>

      <Step title="Autoriza mediante OAuth">
        ChatGPT te redirigirá a Octoparse. Inicia sesión y haz clic en **Permitir**.
      </Step>
    </Steps>

    [Consulta la guía de configuración completa](https://helpcenter.octoparse.com/es/articles/13444709-how-to-integrate-octoparse-with-chatgpt-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="codex" title="Codex">
    <Note>Codex CLI y la extensión de Codex para IDE comparten la misma configuración de MCP (`~/.codex/config.toml`). Configúrala una vez y funcionará en ambos.</Note>

    **Opción A: OAuth**

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

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

        Se abrirá una ventana del navegador. Inicia sesión en Octoparse y haz clic en **Permitir**.
      </Step>
    </Steps>

    ***

    **Opción B: clave de API**

    Agrega lo siguiente 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">
    **Opción A: OAuth**

    <Steps>
      <Step title="Abre Configuración → Conectores">
        En la barra lateral de Claude, ve a **Configuración → Conectores**.
      </Step>

      <Step title="Agrega la URL del servidor">
        Haz clic en **Agregar conector** e introduce `https://mcp.octoparse.com`.
      </Step>

      <Step title="Autoriza mediante OAuth">
        Haz clic en **Conectar**. Se abrirá una ventana del navegador. Inicia sesión y haz clic en **Permitir**.
      </Step>
    </Steps>

    [Consulta la guía de configuración completa](https://helpcenter.octoparse.com/es/articles/14001844-how-to-integrate-octoparse-with-claude-via-mcp-step-by-step)
  </Accordion>

  <Accordion id="claude-code" title="Claude Code">
    <Note>Los servidores agregados mediante `claude mcp add` se comparten entre Claude Code CLI, la aplicación de escritorio y las extensiones para IDE (VS Code/JetBrains). Configúralos una vez y funcionarán en todas partes.</Note>

    **Opción A: OAuth**

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

      <Step title="Autoriza mediante OAuth">
        Inicia Claude Code y ejecuta `/mcp`; después, selecciona **octoparse** para autenticarte. Se abrirá una ventana del navegador: inicia sesión en Octoparse y haz clic en **Permitir**.
      </Step>
    </Steps>

    ***

    **Opción B: clave de 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">
    **Opción A: OAuth**

    <Steps>
      <Step title="Instala OpenClaw">
        Instala OpenClaw y ejecuta el comando de incorporación.
      </Step>

      <Step title="Registra el servidor MCP">
        Configura el servidor MCP de Octoparse y verifica la configuración.
      </Step>

      <Step title="Reinicia Gateway">
        Reinicia Gateway para aplicar la configuración.
      </Step>

      <Step title="Autoriza mediante OAuth">
        La primera llamada a una herramienta de Octoparse abrirá el navegador para OAuth. Inicia sesión y haz clic en **Permitir**.
      </Step>
    </Steps>

    ***

    **Opción B: clave de API**

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

    Después, agrega lo siguiente a la configuración de OpenClaw:

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

  <Accordion id="cursor" title="Cursor">
    **Opción A: OAuth**

    <Steps>
      <Step title="Abre la configuración de Cursor">
        Abre Cursor y haz clic en el icono de configuración de la esquina superior derecha.
      </Step>

      <Step title="Ve a Tools & MCP">
        En la barra lateral izquierda, selecciona **Tools & MCP**.
      </Step>

      <Step title="Agrega un servidor MCP personalizado">
        Haz clic en **Add Custom MCP**. Cursor abrirá el archivo de configuración de MCP. Agrega `https://mcp.octoparse.com` y guarda los cambios.
      </Step>
    </Steps>

    [Consulta la guía de configuración completa](https://helpcenter.octoparse.com/es/articles/14013893-how-to-integrate-octoparse-with-cursor-via-mcp-step-by-step)

    ***

    **Opción B: clave de API**

    Agrega lo siguiente 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>Requiere una suscripción activa a **GitHub Copilot**.</Info>

    **Opción A: OAuth**

    Agrega lo siguiente a `.vscode/mcp.json`:

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

    [Consulta la guía de configuración completa](https://helpcenter.octoparse.com/es/articles/14004033-how-to-integrate-octoparse-with-vs-code-via-mcp-step-by-step)

    ***

    **Opción B: clave de 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>El IDE y la CLI de Antigravity comparten la misma configuración de MCP (`~/.gemini/config/mcp_config.json`). Configúrala una vez y funcionará en ambos. En el IDE también puedes abrirla desde el panel del agente: **MCP Servers → View raw config**.</Note>

    **Opción A: OAuth**

    Agrega lo siguiente a `~/.gemini/config/mcp_config.json`:

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

    Actualiza la lista de servidores MCP. La primera llamada a una herramienta de Octoparse abrirá el navegador para OAuth: inicia sesión y haz clic en **Permitir**.

    ***

    **Opción B: clave de API**

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