> ## 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 el MCP de Data Hub a tu agente

> Conecta el MCP de Data Hub sin elegir primero una Data App y deja que tu agente busque, entienda y ejecute la capacidad de datos adecuada para cada tarea.

Usa este tutorial si aún no sabes qué Data App utilizar, o si quieres que el agente encuentre por sí mismo una capacidad para cada tarea. La conexión general añade a tu agente las herramientas de descubrimiento y ejecución de Data Hub. Una vez conectado, describes los datos que necesitas, y el agente busca una Data App adecuada, revisa sus parámetros y luego confirma y la ejecuta.

<Note>
  **La conexión general no requiere elegir una aplicación primero.** Este tutorial y los tutoriales «Codex: conectar una aplicación específica» y «Claude Code: conectar una aplicación específica» son dos patrones de uso distintos. La conexión a una aplicación específica se adapta a una capacidad clara, fija y de largo plazo. La conexión general se adapta a necesidades cambiantes o a casos en los que la aplicación aún no se ha elegido.
</Note>

## Entender los dos métodos de conexión

| Método                                   | Orden de las operaciones                                                                                                              | Ideal para                                                                                                                      |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Conexión general**                     | Conectar el MCP de Data Hub → buscar aplicaciones dentro del agente → revisar detalles → elegir y ejecutar                            | No sabes qué aplicación elegir; cada tarea puede necesitar una capacidad distinta; quieres que el agente ayude a descubrir.     |
| **Conexión a una aplicación específica** | Elegir una aplicación en el catálogo → copiar el prompt de instalación de esa aplicación → conectar el agente → ejecutar directamente | Tienes una aplicación fija; quieres un alcance de herramientas más reducido; ejecutas un proceso de negocio estable y repetido. |

Ambos métodos llaman a las mismas Data Apps de Data Hub. La única diferencia es dónde eliges la aplicación. Puedes mantener ambos tipos de conexión, pero dales nombres reconocibles para que el agente no elija la herramienta equivocada.

## Qué podrás hacer después

Tras este tutorial, podrás hacer lo siguiente dentro de tu agente, en orden:

1. Buscar Data Apps por palabra clave, plataforma o escenario.
2. Revisar el propósito, los parámetros de entrada, los campos de salida y la facturación de una aplicación.
3. Confirmar la aplicación y los parámetros y luego iniciar una ejecución.
4. Comprobar el estado de una tarea asíncrona y obtener el resultado final.

<Note>
  Para los parámetros completos y las reglas de gestión de `search_data_apps`, `run_data_app`, las comprobaciones de estado asíncronas y el `handoff` de resultados grandes, consulta <a href="/docs/es/datahub/mcp-capabilities" target="_blank" rel="noopener noreferrer">Capacidades MCP de Data Hub</a>. Esta página se centra en la conexión y el primer uso.
</Note>

## Antes de empezar

Ten preparado lo siguiente:

* Una cuenta de Octoparse con la que puedas iniciar sesión.
* Un cliente de agente compatible con Streamable HTTP MCP, como Claude Code, Codex o Cursor.
* Si eliges el método de clave API: crea una clave API de Octoparse con antelación.
* Un objetivo de datos sencillo para probar, como «encontrar una Data App que pueda enriquecer información de empresas».

<Warning>
  Una clave API es una credencial de cuenta. Nunca subas una clave real a un repositorio de código, una configuración compartida, una captura de pantalla pública o un chat de grupo. En modo OAuth, nunca copies un token de acceso temporal de una sesión del navegador en una configuración local.
</Warning>

## Paso 1: abrir la conexión MCP general

<Steps>
  <Step title="Ir a la Data Hub Open Platform">
    Inicia sesión en el sitio web de Octoparse, abre el menú Data Hub en la parte superior y haz clic en **Data Hub Open Platform**.
  </Step>

  <Step title="Abrir MCP connection">
    En la navegación izquierda de la Open Platform, haz clic en **MCP connection** para abrir la página Data Hub MCP Server. El conjunto de herramientas predeterminado que muestra la página puede buscar y ejecutar cualquier Data App de Data Hub. No necesitas elegir primero una aplicación en el catálogo.
  </Step>
</Steps>

<Tip>
  La sección **Integration** de cualquier Data App también tiene al final un enlace a la conexión MCP que lleva aquí. Ese enlace es un atajo. No significa que tengas que elegir esa aplicación primero.
</Tip>

## Paso 2: elegir un método de autenticación

La conexión general admite tanto clave API como OAuth. La elección solo afecta a la autenticación. No cambia cómo se buscan o ejecutan las Data Apps.

### Opción 1: clave API (recomendada)

Ideal para un uso estable a largo plazo, clientes de línea de comandos y automatización. La configuración generada por la página contiene:

```text theme={null} theme={null}
Authorization: Bearer <YOUR_API_KEY>
```

`Bearer` es simplemente el formato de cabecera usado para pasar la clave API. Usa una clave API de Octoparse, no un token de acceso temporal de una sesión del navegador con la sesión iniciada.

Si aún no tienes una clave, crea una en el <a href="https://www.octoparse.es/console/open-platform/api-keys" target="_blank" rel="noopener noreferrer">centro de cuenta de Octoparse</a>. Una clave API normalmente solo se muestra completa una vez, al crearla. Guárdala en un gestor de contraseñas de confianza.

### Opción 2: inicio de sesión con OAuth

Ideal para clientes interactivos compatibles con MCP OAuth. Cuando eliges OAuth, la configuración no contiene ninguna clave API. La primera vez que el cliente se conecta, abre un navegador donde inicias sesión en Octoparse y confirmas la autorización. La sesión puede caducar, en cuyo caso vuelves a autorizar.

## Paso 3: copiar el prompt de instalación general

En la página **MCP connection**, elige tu cliente de agente y el método de autenticación, y luego haz clic en **Copy install prompt**. **Copy MCP URL** solo te da la dirección del servidor. Copia el contenido completo que la página genera en ese momento. No escribas de memoria la dirección del servidor, el alcance de las herramientas ni las cabeceras.

<Tip>
  La dirección general del servidor que muestra la página se basa en `https://mcp-v2.octoparse.com`. La configuración exacta y los parámetros de las herramientas pueden cambiar, así que usa siempre lo que la Open Platform genera actualmente.
</Tip>

## Paso 4: dejar que el agente complete la configuración

El ejemplo siguiente usa Claude Code. Codex y Cursor colocan los botones de forma distinta, pero los pasos principales son los mismos: pegar el prompt de instalación, elegir el método de autenticación, permitir cambios en la configuración MCP del usuario actual y luego recargar el cliente.

<Steps>
  <Step title="Enviar el prompt de instalación al agente">
    Inicia una conversación nueva y pega el prompt completo que copiaste. El agente debería preguntar el método de autenticación antes de escribir la configuración. Si intenta escribir credenciales en un archivo del proyecto, detenlo y pídele en su lugar la configuración MCP local del usuario actual.
  </Step>

  <Step title="Confirmar el método de autenticación">
    Si elegiste clave API, proporciona la clave de forma segura cuando el agente la pida. Si elegiste OAuth, no proporciones ninguna clave y deja que el agente escriba una configuración sin credenciales.
  </Step>

  <Step title="Recargar el cliente">
    Tras la configuración, recarga los servidores MCP o reinicia el cliente. Con OAuth, la primera conexión puede mostrar «Necesita autenticación». Es lo esperado.
  </Step>
</Steps>

## Paso 5: completar la autorización OAuth (solo OAuth)

Si elegiste clave API, salta al paso siguiente.

<Steps>
  <Step title="Activar la conexión en el cliente">
    En Claude Code, ejecuta `/mcp` y selecciona el servidor Data Hub que acabas de añadir, llamado `octoparse_datahub` por defecto. Cuando indique que se necesita autenticación, elige autenticarte. Otros clientes muestran un botón **Connect** o similar en su configuración MCP.
  </Step>

  <Step title="Iniciar sesión y autorizar en el navegador">
    El navegador abre la página de identidad de Octoparse. Comprueba el dominio y la cuenta actual, lee el alcance solicitado y confirma. Sigue la indicación de la página para volver al cliente. Algunos clientes vuelven automáticamente.
  </Step>

  <Step title="Confirmar que el servidor está habilitado">
    De vuelta en el cliente, confirma que el estado «Necesita autenticación» ha desaparecido y que el servidor está habilitado. Si sigue apareciendo como no autenticado, recarga el cliente e inténtalo de nuevo.
  </Step>
</Steps>

## Paso 6: buscar primero, no ejecutar todavía

La clave de la conexión general es dejar que el agente descubra primero las Data Apps. En el primer uso, pídele explícitamente que solo busque y compare, y que no cree todavía ninguna tarea facturable. Por ejemplo:

```text theme={null} theme={null}
Usa Data Hub para buscar Data Apps relacionadas con «enriquecimiento de empresas».
Enumera los 3 resultados más relevantes. Para cada uno, describe el propósito, las entradas necesarias, los campos de salida principales y el modelo de facturación.
No ejecutes nada todavía. Espera mi confirmación.
```

El agente suele llamar a `search_data_apps` para buscar en el catálogo y luego a `get_data_app_details` para leer el contrato completo de cada candidata.

<Note>
  El número, los nombres y la cobertura de plataformas de las aplicaciones que encuentra un agente cambian en tiempo real con el catálogo de Data Hub. Esta documentación no ofrece una lista fija. Fíate de lo que `search_data_apps` devuelve realmente.
</Note>

## Paso 7: confirmar la aplicación y luego ejecutar

Elige una aplicación entre las candidatas. Pide al agente que repita los parámetros y las acciones previstas, y luego ejecuta una prueba pequeña:

```text theme={null} theme={null}
Elige la primera Data App. Dime primero sus parámetros obligatorios, sus valores predeterminados y su modelo de facturación.
Cuando yo confirme, ejecuta solo con el volumen de datos más pequeño y devuelve el estado de la tarea, el número de registros y los 5 primeros registros.
```

<Steps>
  <Step title="Comprobar las entradas y el coste">
    Confirma los parámetros obligatorios, el alcance de los datos, los campos devueltos y la unidad de facturación. Si algo no está claro, pide al agente que vuelva a llamar a la herramienta de detalles en lugar de adivinar los parámetros.
  </Step>

  <Step title="Ejecutar una prueba pequeña">
    Solo tras la confirmación, deja que el agente llame a `run_data_app`. Una aplicación síncrona devuelve los resultados directamente. Una aplicación asíncrona necesita comprobaciones de estado posteriores.
  </Step>

  <Step title="Obtener los resultados asíncronos">
    Para las tareas asíncronas, pide al agente que use las herramientas de estado y resultado para esperar a que termine y luego devolver los datos finales. No trates «tarea enviada» como una extracción correcta.
  </Step>

  <Step title="Comprobar los resultados">
    Comprueba el estado de la tarea, el número real de registros y los campos clave. Un campo ausente en un solo registro puede reflejar una diferencia en los datos de origen. Si la mayoría de los registros no coinciden con lo esperado, cambia de aplicación o ajusta los parámetros.
  </Step>
</Steps>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿La conexión general requiere elegir primero una Data App?">
    No. La conexión general proporciona primero las herramientas de búsqueda y ejecución. Tras conectarse, el agente usa `search_data_apps` para encontrar capacidades. Solo la conexión a una aplicación específica requiere elegir primero una aplicación en el catálogo.
  </Accordion>

  <Accordion title="¿Debo elegir clave API u OAuth?">
    Prefiere la clave API para uso a largo plazo, clientes de línea de comandos y automatización. Elige OAuth cuando quieras iniciar sesión a través del navegador y tu cliente admita explícitamente MCP OAuth. Las sesiones OAuth pueden caducar y requerir una nueva autorización.
  </Accordion>

  <Accordion title="La configuración se completó, pero no hay herramienta search_data_apps">
    Confirma que usaste la configuración general de la página **MCP connection** de la Open Platform, no la configuración restringida de una aplicación específica. Copia de nuevo el prompt actual y recarga el cliente.
  </Accordion>

  <Accordion title="OAuth sigue indicando que se necesita autenticación">
    Activa la conexión en la configuración MCP del cliente, completa el inicio de sesión y la autorización en el navegador y vuelve al cliente. Comprueba si el navegador bloqueó la redirección y confirma que la página de autorización pertenece al servicio de identidad oficial de Octoparse.
  </Accordion>

  <Accordion title="El agente encontró una aplicación y la ejecutó de inmediato">
    Escribe explícitamente «solo buscar y comparar, no ejecutar todavía» en el prompt. Cuando haya costes o grandes volúmenes de datos de por medio, pide al agente que espere la confirmación antes de llamar a `run_data_app`.
  </Accordion>

  <Accordion title="La ejecución solo devolvió un ID de tarea y ningún dato">
    La aplicación probablemente es asíncrona. Pide al agente que siga comprobando el estado de la tarea y que recupere los resultados cuando termine. No vuelvas a enviar la misma tarea.
  </Accordion>
</AccordionGroup>

## Lista de comprobación

* Has copiado el prompt de instalación general desde la página **MCP connection** de la Data Hub Open Platform.
* Has elegido clave API u OAuth y no has mezclado las dos credenciales.
* El agente ha cargado las herramientas generales de Data Hub y puede usar `search_data_apps`.
* Has buscado y revisado los detalles de la aplicación antes de confirmar una ejecución.
* Has completado una llamada real con el volumen de datos más pequeño y has comprobado el resultado final.

## ¿Ya sabes qué aplicación usar?

Si tu negocio usa una aplicación fija a largo plazo, puedes reducir el alcance de la conexión:

<CardGroup cols={2}>
  <Card title="Codex: conectar una aplicación específica" href="/docs/es/datahub/quick-start/agent-connection/codex">
    Elige primero una aplicación concreta y luego añádela a Codex como herramienta fija.
  </Card>

  <Card title="Claude Code: conectar una aplicación específica" href="/docs/es/datahub/quick-start/agent-connection/claude-code">
    Elige primero una aplicación concreta y luego añádela a Claude Code como servidor MCP fijo.
  </Card>
</CardGroup>

<Note>
  El número real de aplicaciones, sus nombres, editores y precios devueltos por una búsqueda cambian con el catálogo de Data Hub. Fíate de lo que la herramienta devuelve en cada llamada.
</Note>