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

> Elige una Data App fija en el catálogo de Data Hub, añádela a Codex con el prompt de instalación generado y completa una llamada real con una prueba pequeña.

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 dejas que Codex la use como herramienta fija.

<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>
  Esta página usa como ejemplo una Data App de enriquecimiento de empresas, que devuelve sector, plantilla y sede a partir del nombre de una empresa. Si eliges otra Data App, el nombre de la página, los parámetros de entrada y los campos devueltos serán distintos, pero el método de conexión es el mismo.
</Note>

## Qué podrás hacer después

Tras este tutorial, podrás describir una necesidad de datos directamente en Codex, hacer que Codex llame a la Data App de Data Hub y obtener resultados estructurados. Nunca escribes la configuración MCP a mano.

## Antes de empezar

Ten preparado lo siguiente:

* Una cuenta de Octoparse con la que puedas iniciar sesión.
* Codex instalado y con la sesión iniciada.
* Un objetivo de prueba claro y pequeño, como «enriquecer tres nombres de empresa con sector, plantilla y sede».

<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 Codex pida explícitamente una credencial.
</Warning>

## Paso 1: elegir y probar la Data App

Antes de conectar el agente, confirma en el navegador que la Data App cumple tus necesidades. Si una llamada posterior falla, podrás saber rápidamente si el problema está en los parámetros de datos o en la configuración de Codex.

<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="Encontrar la Data App que necesitas">
    Usa la búsqueda o los filtros de categoría para encontrar la aplicación objetivo. En la página de detalle, lee primero la descripción de la capacidad, los parámetros de entrada, los campos de salida y el precio. No juzgues si encaja solo por el nombre de la aplicación.
  </Step>

  <Step title="Ejecutar en línea con una pequeña cantidad de datos">
    Haz clic en **Try It Now** y rellena los parámetros obligatorios. 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 de entrada o cambia a otra Data App. No te apresures a conectar Codex.

## Paso 2: copiar el prompt de instalación de Codex

En la página de detalle de la Data App, abre **Integration**, elige MCP y haz clic en **Copy install prompt**. Copia el contenido completo que genera la página. **Copy MCP URL** solo te da la dirección del servidor, suficiente si prefieres añadir el servidor a mano. No reescribas la dirección del servidor a mano.

<Tip>
  Cuando solo necesites una capacidad, conecta una única Data App. Codex elige la herramienta correcta con más facilidad, y la resolución de problemas es más sencilla.
</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 nueva.
  </Step>

  <Step title="Guardar temporalmente la clave nueva">
    Una clave normalmente solo se muestra completa al crearla. Guárdala en un gestor de contraseñas de confianza. Tras la configuración, no la conserves en un archivo de texto sin cifrar.
  </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 simplemente 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: dejar que Codex complete la conexión

<Steps>
  <Step title="Enviar el prompt de instalación a Codex">
    Inicia una conversación nueva de Codex, pega el prompt de instalación completo que copiaste y envíalo. Codex lee la dirección del servidor y los requisitos de configuración, y luego te dice qué necesita a continuación.
  </Step>

  <Step title="Proporcionar la clave API cuando la pida">
    Proporciona la clave que acabas de crear solo cuando Codex pida explícitamente una credencial. Confirma que Codex está editando la configuración MCP del usuario actual, no un archivo compartido del proyecto.
  </Step>

  <Step title="Confirmar el resultado de la configuración">
    Cuando Codex termina, te indica qué archivo de configuración escribió y el nombre del servidor nuevo. Normalmente edita el `config.toml` de nivel de usuario y te pide que recargues MCP o reinicies Codex.
  </Step>

  <Step title="Recargar Codex">
    Recarga MCP como sugiere Codex. Si la interfaz no tiene opción de recarga, cierra y vuelve a abrir Codex. Luego continúa con la verificación siguiente.
  </Step>
</Steps>

## Paso 5: hacer la primera llamada real

Dile a Codex en lenguaje natural qué quieres consultar y dale un alcance claro. Limita la cantidad en la primera llamada. Por ejemplo:

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

<Steps>
  <Step title="Confirmar que Codex llamó a la Data App">
    Observa las llamadas a herramientas en la conversación. Solo cuando aparece una llamada a una herramienta de Data Hub, Codex ha usado realmente la Data App en lugar de responder con su propio conocimiento.
  </Step>

  <Step title="Comprobar los resultados devueltos">
    Comprueba si el número de registros, los campos y el contenido coinciden con la prueba del navegador. Un campo vacío no siempre significa un fallo. Comprueba primero si los datos de origen proporcionan ese campo para el registro.
  </Step>
</Steps>

## Opcional: dejar que Codex use varias Data Apps

Crea un conjunto de herramientas de varias aplicaciones solo cuando un flujo de trabajo necesite realmente varias capacidades de datos.

<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="Elegir las Data Apps que necesitas">
    Añade solo las aplicaciones que el flujo de trabajo actual necesita realmente. Algunas páginas de detalle también ofrecen un paquete **Related Data Apps**.
  </Step>

  <Step title="Copiar y enviar el prompt de instalación de varias aplicaciones">
    Guarda el conjunto de herramientas, copia el prompt de instalación que genera la página, envíalo a Codex y recarga MCP cuando se te pida.
  </Step>

  <Step title="Verificar las herramientas una por una">
    Pide primero a Codex que enumere las capacidades de datos disponibles y luego prueba una aplicación cada vez. Cuando todas funcionen, deja que varias aplicaciones trabajen juntas en una tarea compleja.
  </Step>
</Steps>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="Codex dice que la configuración se completó, pero no aparece ninguna herramienta">
    Recarga MCP o reinicia Codex. Si las herramientas siguen sin aparecer, pide a Codex que compruebe que la dirección del servidor y las cabeceras del `config.toml` de nivel de usuario están completas, y confirma que está leyendo la misma configuración de usuario.
  </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="Codex 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 pregunta y proporciona los parámetros que admite la aplicación. También puedes pedir a Codex que enumere primero las herramientas disponibles para confirmar que el servidor está cargado.
  </Accordion>

  <Accordion title="El navegador devuelve resultados, pero la llamada de Codex falla">
    Compara con los parámetros que funcionaron en el navegador. Comprueba uno por uno la dirección del servidor, la clave API, el formato de los parámetros y los registros de Codex. 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, Codex sigue mostrando las herramientas antiguas">
    Tras guardar el nuevo conjunto de herramientas, copia de nuevo el prompt de instalación actual, pide a Codex que actualice la configuración y luego recarga MCP. 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 una configuración local de confianza o en una herramienta de credenciales.
* Codex ha recargado MCP y aparece la herramienta de Data Hub.
* 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="Claude Code: conectar una aplicación específica" href="/docs/es/datahub/quick-start/agent-connection/claude-code">
    Si usas Claude Code, consulta el flujo completo de aplicación específica para ese cliente.
  </Card>
</CardGroup>