Skip to main content
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.
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 Conexión general: elegir una aplicación dentro del agente.
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.

​
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».
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.

​
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.
1

Abrir Octoparse Data Hub e iniciar sesión

Ve al Octoparse Data Hub e inicia sesión mediante el acceso a la cuenta en la esquina superior derecha.
2

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

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

​
Paso 3: crear una clave API de Octoparse

1

Abrir la página de claves API

Ve al centro de cuenta de Octoparse y crea una clave nueva.
2

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

1

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

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

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

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.

​
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:
1

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

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.

​
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.
1

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

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

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

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.

​
Preguntas frecuentes

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

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

Conexión general

No elijas una aplicación de antemano. Conéctate y deja que el agente busque y ejecute la capacidad de datos adecuada.

Claude Code: conectar una aplicación específica

Si usas Claude Code, consulta el flujo completo de aplicación específica para ese cliente.