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 la añades a Claude Code como servidor MCP fijo.
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.
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.

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

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

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

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

​
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 API nueva.
2

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

1

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

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

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

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.

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

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

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

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

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

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

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.

​
Preguntas frecuentes

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

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

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.

Codex: conectar una aplicación específica

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