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

# Conectar una Data App a Claude Code

> Elige una Data App fija en el catálogo de Data Hub, añádela a Claude Code como servidor MCP con el prompt de instalación generado y verifica una llamada real.

Este tutorial es para usuarios que **ya saben qué Data App utilizar**. Primero eliges y pruebas la aplicación en el catálogo, luego copias el prompt de instalación de esa aplicación y la añades a Claude Code como servidor MCP fijo.

<Note>
  Esta página sigue el patrón «elegir primero la aplicación y luego conectar». Si aún no sabes qué aplicación elegir y quieres conectar primero el MCP y dejar que el agente busque, usa en su lugar <a href="/docs/es/datahub/quick-start/agent-connection/general" target="_blank" rel="noopener noreferrer">Conexión general: elegir una aplicación dentro del agente</a>.
</Note>

<Note>
  Claude Code y Codex usan las mismas capacidades MCP de Data Hub. La diferencia está solo en cómo cada cliente guarda su configuración MCP y muestra el estado del servidor. La Data App en sí no cambia.
</Note>

## Qué podrás hacer después

Tras este tutorial, podrás describir una necesidad de datos directamente en Claude Code y hacer que llame a la Data App de Data Hub para obtener datos estructurados. Esta página también cubre la conexión de una sola Data App y de varias Data Apps.

## Antes de empezar

Ten preparado lo siguiente:

* Una cuenta de Octoparse con la que puedas iniciar sesión.
* Claude Code instalado y con la sesión iniciada.
* Un objetivo de prueba claro y pequeño, como una plataforma objetivo, una palabra clave y un número de registros.

<Warning>
  Una clave API es una credencial de cuenta. Nunca pongas una clave real en archivos del proyecto, repositorios de código, capturas de pantalla públicas o chats de grupo. Proporciónala solo cuando Claude Code pida explícitamente una credencial.
</Warning>

## Paso 1: elegir y probar la Data App

Confirma primero las entradas y salidas de la aplicación en el navegador y luego conecta Claude Code. Si más adelante aparece un problema, podrás saber rápidamente si los parámetros son incorrectos o si el servidor no está bien configurado.

<Steps>
  <Step title="Abrir Octoparse Data Hub e iniciar sesión">
    Ve al <a href="https://www.octoparse.es/data-hub" target="_blank" rel="noopener noreferrer">Octoparse Data Hub</a> e inicia sesión mediante el acceso a la cuenta en la esquina superior derecha.
  </Step>

  <Step title="Elegir la Data App objetivo">
    Usa la búsqueda o las categorías para encontrar la aplicación objetivo. En la página de detalle, lee con atención la descripción de la capacidad, los parámetros obligatorios, los campos devueltos y el precio, y confirma que encaja con la tarea.
  </Step>

  <Step title="Ejecutar en línea una vez">
    Haz clic en **Try It Now** y rellena los parámetros según indica la página. Pide solo una pequeña cantidad de datos la primera vez. Cuando termine la ejecución, comprueba el estado, el número de registros y los campos clave.
  </Step>
</Steps>

Si la ejecución en el navegador no devuelve resultados, ajusta primero los parámetros o cambia a otra Data App. Continúa con Claude Code solo cuando la ejecución en el navegador funcione.

## Paso 2: copiar el prompt de instalación de Claude Code

En la página de detalle de la Data App, abre **Integration**, elige MCP y haz clic en **Copy install prompt**. **Copy MCP URL** solo te da la dirección del servidor, suficiente si prefieres ejecutar `claude mcp add` a mano. También puedes llegar rápidamente a través del enlace MCP de la barra lateral de la página de detalle.

<Tip>
  Para una primera conexión, elige solo una Data App. Cuantas menos herramientas haya, más fácil le resulta a Claude Code elegir la capacidad correcta, y más sencilla es la resolución de problemas.
</Tip>

## Paso 3: crear una clave API de Octoparse

<Steps>
  <Step title="Abrir la página de claves API">
    Ve al <a href="https://www.octoparse.es/console/open-platform/api-keys" target="_blank" rel="noopener noreferrer">centro de cuenta de Octoparse</a> y crea una clave API nueva.
  </Step>

  <Step title="Guardar la clave API de forma segura">
    Una clave normalmente solo se muestra completa al crearla. Guárdala temporalmente en un gestor de contraseñas de confianza. No la guardes en el directorio del proyecto ni en un documento compartido.
  </Step>
</Steps>

La configuración para una aplicación específica generada en la página de detalle de la Data App usa una clave API. La línea `Authorization: Bearer <API_KEY>` de la configuración es el formato de cabecera para la clave API. La conexión general también admite OAuth. No mezcles fragmentos de configuración de los dos tutoriales.

## Paso 4: añadir el servidor en Claude Code

<Steps>
  <Step title="Enviar el prompt de instalación a Claude Code">
    Inicia una sesión nueva de Claude Code, pega el prompt de instalación completo que copiaste y envíalo. Claude Code lee la dirección del servidor y los requisitos de configuración, y pide la clave API cuando la necesita.
  </Step>

  <Step title="Proporcionar la clave API cuando la pida">
    Proporciona la clave solo cuando Claude Code la pida explícitamente. Confirma que la dirección del servidor procede de la sección **Integration** actual de la aplicación, y no uses una dirección de origen desconocido.
  </Step>

  <Step title="Confirmar la configuración de ámbito de usuario">
    Claude Code normalmente añade el servidor, llamado `octoparse_datahub` por defecto, con `claude mcp add` en el ámbito de usuario, para que esté disponible en todos los proyectos. Si en su lugar propone un archivo `.mcp.json` de ámbito de proyecto, pide el ámbito de usuario para que la clave no se suba junto con el proyecto.
  </Step>

  <Step title="Recargar el servidor">
    Si las herramientas no aparecen de inmediato, ejecuta `/mcp` en Claude Code para comprobar el estado del servidor, o inicia una sesión nueva. Si el servidor sigue sin aparecer, cierra y vuelve a abrir Claude Code.
  </Step>
</Steps>

## Paso 5: hacer la primera llamada real

Formula la petición en lenguaje natural claro y concreto, idealmente con la plataforma, los filtros y la cantidad. Por ejemplo:

```text theme={null} theme={null}
Usa la herramienta de Data Hub que acabas de conectar para enriquecer estos tres leads con sector, plantilla y sede: Cabify, Glovo, TravelPerk.
```

<Steps>
  <Step title="Confirmar que Claude Code llamó al servidor">
    Observa las llamadas a herramientas en la conversación. Solo cuando aparece una llamada a una herramienta de Data Hub, Claude Code ha accedido realmente a la Data App.
  </Step>

  <Step title="Comprobar los resultados de datos">
    Comprueba si el número de registros, los campos principales y el contenido cumplen lo esperado. Si solo obtienes una explicación en texto, pide explícitamente «llama a la herramienta de Data Hub que acabas de conectar».
  </Step>
</Steps>

## Opcional: dejar que Claude Code use varias Data Apps

Cuando un flujo de trabajo necesite realmente varias capacidades, crea un conjunto de herramientas personalizado que reúna varias Data Apps en una sola conexión MCP.

<Steps>
  <Step title="Abrir MCP connection en la Open Platform">
    Desde Data Hub, abre la Open Platform, haz clic en **MCP connection** y luego abre la sección de conjuntos de herramientas personalizados.
  </Step>

  <Step title="Añadir las Data Apps que necesitas">
    Elige solo las aplicaciones que el flujo actual necesita realmente. Demasiadas herramientas aumentan la probabilidad de que Claude Code elija la equivocada.
  </Step>

  <Step title="Copiar el prompt de instalación de varias aplicaciones">
    Guarda el conjunto de herramientas y luego copia el prompt de instalación completo que la página genera actualmente.
  </Step>

  <Step title="Enviarlo a Claude Code y recargar">
    Envía el prompt de instalación de varias aplicaciones a Claude Code, actualiza el servidor como se indique y recarga. Luego pide a Claude Code que enumere primero las capacidades disponibles y prueba cada aplicación seleccionada de una en una.
  </Step>
</Steps>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="El servidor se añadió, pero no aparece ninguna herramienta">
    Ejecuta `/mcp` para comprobar si el servidor está conectado y luego inicia una sesión nueva o reinicia Claude Code. Si las herramientas siguen sin aparecer, ejecuta `claude mcp list` y compara la dirección del servidor y las cabeceras con el prompt de instalación.
  </Accordion>

  <Accordion title="No autorizado o clave API no válida">
    Asegúrate de que a la clave no le faltan caracteres, no tiene espacios ni saltos de línea, y sigue siendo válida. Esta página usa la configuración de clave API generada en la página de la aplicación específica. Si necesitas OAuth, usa en su lugar la configuración generada en la página de conexión general.
  </Accordion>

  <Accordion title="Claude Code no llamó a la herramienta y respondió con texto sin más">
    Escribe explícitamente «usa la herramienta de Data Hub que acabas de conectar» en la petición y proporciona los parámetros que admite la aplicación. También puedes pedir a Claude Code que enumere primero las herramientas disponibles para confirmar que el servidor está cargado.
  </Accordion>

  <Accordion title="El navegador devuelve resultados, pero la llamada de Claude Code falla">
    Compara con los parámetros que funcionaron en el navegador. Comprueba uno por uno la dirección del servidor, la clave API y el formato de los parámetros, y lee el error que se muestra en `/mcp`. Mantén un alcance de solicitud pequeño en la primera verificación para que un tiempo de espera agotado no se confunda con un fallo de conexión.
  </Accordion>

  <Accordion title="Tras cambiar el conjunto de herramientas, Claude Code sigue mostrando las herramientas antiguas">
    Tras guardar el nuevo conjunto de herramientas, copia de nuevo el prompt de instalación actual, pide a Claude Code que actualice el servidor y luego recarga. Los clientes no sincronizan automáticamente los cambios del conjunto de herramientas.
  </Accordion>
</AccordionGroup>

## Lista de comprobación

* Has ejecutado la Data App correctamente en el navegador con una pequeña cantidad de datos.
* Has copiado el prompt de instalación desde la sección **Integration** actual de la aplicación.
* La clave API se guarda solo en la configuración de ámbito de usuario de Claude Code o en una herramienta de credenciales.
* El servidor Data Hub aparece como conectado en `/mcp` y su herramienta es visible.
* Has completado una llamada real a la herramienta y has comprobado el número de registros y los campos clave.

<CardGroup cols={2}>
  <Card title="Conexión general" href="/docs/es/datahub/quick-start/agent-connection/general">
    No elijas una aplicación de antemano. Conéctate y deja que el agente busque y ejecute la capacidad de datos adecuada.
  </Card>

  <Card title="Codex: conectar una aplicación específica" href="/docs/es/datahub/quick-start/agent-connection/codex">
    Si usas Codex, consulta el flujo completo de aplicación específica para ese cliente.
  </Card>
</CardGroup>