Soluciona problemas habituales de configuración, autenticación, ejecución de tareas y exportación del servidor MCP de Octoparse.
Usa esta página para diagnosticar problemas habituales al configurar o utilizar el servidor MCP de Octoparse.
Problemas de autenticación
Clave de API ausente o no válida
Puede aparecer un error de autenticación si el servidor MCP no encuentra una clave de API de Octoparse válida.Síntomas habituales:
UnauthorizedInvalid API keyAuthentication failed401 UnauthorizedMissing API key
Comprueba que la clave de API sea válida y que no se haya eliminado o regenerado.Si utilizas una variable de entorno, confirma que esté disponible en el mismo shell o entorno de ejecución que inicia el servidor MCP.
echo $OCTOPARSE_API_KEY
Si no aparece ningún valor, vuelve a definir la clave antes de iniciar el servidor.
export OCTOPARSE_API_KEY="your-api-key"
No incluyas claves de API en Git, scripts, capturas de pantalla, registros compartidos ni informes de incidencias públicos.
La clave funciona en un terminal, pero no en el cliente MCP
Algunos clientes MCP no heredan las variables de entorno del terminal interactivo.Si el servidor funciona al iniciarlo manualmente, pero falla dentro de un cliente MCP, revisa la configuración del cliente y asegúrate de que la clave de API se pase al proceso del servidor.Reinicia el cliente MCP después de actualizar las variables de entorno.
Problemas al iniciar el servidor
El servidor MCP no se inicia
Si el servidor no se inicia, comprueba el comando, el directorio de trabajo, la versión de Node.js y las variables de entorno.Ejecuta primero el comando del servidor directamente en un terminal. Así podrás distinguir los problemas de configuración del cliente MCP de los problemas del entorno de ejecución del servidor.
node --versionnpm --version
Asegúrate de que el comando utilizado por el cliente MCP coincida con el que funciona en el terminal.
Comando no encontrado
Si el cliente indica que no encuentra el comando del servidor, utiliza una ruta absoluta o confirma que el paquete esté instalado.Un comando puede funcionar en el shell y fallar en el cliente MCP si ambos no utilizan el mismo PATH.
Problemas de acceso a tareas
Tarea no encontrada
Puede aparecer este error si el ID de la tarea es incorrecto o si la cuenta autenticada no tiene acceso a ella.Comprueba lo siguiente:
El ID de la tarea se ha copiado correctamente.
La tarea pertenece a la cuenta autenticada de Octoparse.
La tarea no se ha eliminado.
La clave de API pertenece al espacio de trabajo o a la cuenta correctos.
No se devuelve ninguna tarea accesible
Si la búsqueda no devuelve resultados, verifica primero la clave de API y el acceso de la cuenta. Después, prueba una consulta más amplia o enumera las tareas sin filtrar por palabra clave.
Problemas de ejecución
La tarea no se inicia
Una tarea puede no iniciarse si su definición no es compatible, si ya se está ejecutando o si la cuenta no tiene permiso para ejecutarla.Comprueba primero la tarea en Octoparse y vuelve a intentarlo desde el cliente MCP.Si se creó con un flujo antiguo, vuelve a crearla o actualízala en la aplicación actual de Octoparse antes de ejecutarla mediante automatización.
La ejecución se inicia, pero no devuelve datos
Si la ejecución finaliza correctamente, pero la exportación no devuelve datos, comprueba si la tarea ha terminado y si la ejecución o el lote seleccionados contienen datos.Causas habituales:
La tarea todavía se está ejecutando.
El ID de lote seleccionado no contiene datos.
La tarea finalizó, pero no encontró registros.
Se solicitó la exportación antes de que terminara la ejecución.
Problemas de exportación
La exportación falla
Verifica que la tarea haya finalizado y que la herramienta admita el formato de exportación elegido.Si el comando o la herramienta acepta un ID de lote, asegúrate de que pertenezca a la misma tarea y al mismo historial de ejecución.
Archivo de exportación vacío
Normalmente significa que la ejecución seleccionada no contiene registros extraídos o que se solicitó la exportación antes de finalizar la extracción.Comprueba primero el historial y vuelve a exportar con la ejecución o el lote correctos.
Límites de solicitudes y fallos transitorios
Si una solicitud falla de manera intermitente, espera brevemente y vuelve a intentarlo. Los problemas de red, los retrasos de la cola de tareas o los errores temporales del backend pueden provocar fallos transitorios.Si el fallo se repite, recopila:
El nombre y la versión del cliente MCP
La versión del servidor MCP
La llamada a la herramienta o el prompt exactos
El ID de la tarea
El mensaje de error
Si la misma tarea funciona directamente en Octoparse
Elimina claves de API, tokens de acceso, cookies y datos personales antes de compartir registros.
Información que debes proporcionar al informar de un problema
Incluye:
Nombre del cliente MCP
Versión del servidor MCP
Sistema operativo
Versión de Node.js
Nombre de la herramienta que falló
Mensaje de error exacto
ID de la tarea o un ejemplo anonimizado
Si la tarea funciona en Octoparse fuera de MCP
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Octoparse Docs","description":"Developer documentation for Octoparse MCP Server and OpenAPI integrations.","colors":{"primary":"#117CFF","light":"#117CFF","dark":"#117CFF"},"logo":{"light":"https://mintcdn.com/octoparse/Gvd6HefaOGSEtZAm/images/logo_octoparse.svg?fit=max\u0026auto=format\u0026n=Gvd6HefaOGSEtZAm\u0026q=85\u0026s=2442bfff45bdc256a531bbb3f0a6e07d","dark":"https://mintcdn.com/octoparse/Gvd6HefaOGSEtZAm/images/logo_octoparse.svg?fit=max\u0026auto=format\u0026n=Gvd6HefaOGSEtZAm\u0026q=85\u0026s=2442bfff45bdc256a531bbb3f0a6e07d","href":"https://www.octoparse.com"},"favicon":"https://mintcdn.com/octoparse/rEXwXcMDf83PhQtP/images/op-logo.svg?fit=max\u0026auto=format\u0026n=rEXwXcMDf83PhQtP\u0026q=85\u0026s=76cbf4eb19a67897dcbdcf6489472101","api":{},"background":{"color":{"dark":"#011229"}},"navbar":{"primary":{"type":"button","label":"Contact support","href":"mailto:support@octoparse.com"}},"seo":{"metatags":{"keywords":"Octoparse Docs, Octoparse MCP Server, Octoparse OpenAPI, web scraping API, MCP web scraping, cloud data extraction","twitter:site":"@Octoparse"},"indexing":"navigable"},"integrations":{"gtm":{"tagId":"GTM-WZ7K2D4"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"en/overview"},{"language":"es","href":"es/overview"},{"language":"fr","href":"fr/overview"},{"language":"de","href":"de/overview"},{"language":"it","href":"it/overview"},{"language":"ko","href":"ko/overview"},{"language":"ja","href":"jp/overview"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"octoparse","hasAudioNarration":false,"actualSubdomain":"octoparse","customDomains":["www.octoparse.com"],"gitSource":{"type":"github","owner":"octoparse","repo":"opdocs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af407c2d3a2c029a3cdb973","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"en","tag":"Data Hub","count":66},{"language":"en","tag":"DATA HUB API","count":66},{"language":"ja","tag":"Data Hub","count":66},{"language":"ja","tag":"DATA HUB API","count":66},{"language":"ko","tag":"API 레퍼런스","count":48},{"language":"en","tag":"Publishing","count":36},{"language":"ja","tag":"公開","count":36},{"language":"en","tag":"Academy","count":35},{"language":"ja","tag":"アカデミー","count":34},{"language":"en","tag":"API Reference","count":30},{"language":"en","tag":"API REFERENCE","count":30},{"language":"ja","tag":"APIリファレンス","count":30},{"language":"ja","tag":"APIドキュメント","count":30},{"language":"de","tag":"API-Referenz","count":24},{"language":"de","tag":"API-REFERENZ","count":24},{"language":"es","tag":"Referencia de la API","count":24},{"language":"es","tag":"REFERENCIA DE API","count":24},{"language":"fr","tag":"Référence API","count":24},{"language":"fr","tag":"RÉFÉRENCE API","count":24},{"language":"it","tag":"Riferimento API","count":24},{"language":"it","tag":"RIFERIMENTO API","count":24},{"language":"en","tag":"GET STARTED","count":18},{"language":"en","tag":"CLI","count":15},{"language":"ja","tag":"CLI","count":15},{"language":"en","tag":"AI Assistant","count":14},{"language":"en","tag":"Desktop","count":14},{"language":"ja","tag":"AIアシスタント","count":14},{"language":"ja","tag":"スクレイパーの仕組み","count":13},{"language":"ja","tag":"はじめに","count":13},{"language":"de","tag":"Aufgabe","count":9},{"language":"es","tag":"Tarea","count":9},{"language":"fr","tag":"Tâche","count":9},{"language":"it","tag":"Attività","count":9},{"language":"ko","tag":"작업","count":9},{"language":"de","tag":"Cloud-Extraktion","count":7},{"language":"es","tag":"Extracción en la nube","count":7},{"language":"fr","tag":"Extraction dans le cloud","count":7},{"language":"it","tag":"Estrazione cloud","count":7},{"language":"ko","tag":"클라우드 추출","count":7},{"language":"de","tag":"Daten","count":5},{"language":"es","tag":"Datos","count":5},{"language":"fr","tag":"Données","count":5},{"language":"it","tag":"Dati","count":5},{"language":"ko","tag":"데이터","count":5},{"language":"de","tag":"Zugriffstoken","count":2},{"language":"es","tag":"Token de acceso","count":2},{"language":"fr","tag":"Jeton d’accès","count":2},{"language":"it","tag":"Token di accesso","count":2},{"language":"ko","tag":"액세스 토큰","count":2},{"language":"de","tag":"Aufgabengruppe","count":1},{"language":"es","tag":"Grupo de tareas","count":1},{"language":"fr","tag":"Groupe de tâches","count":1},{"language":"it","tag":"Gruppo di attività","count":1},{"language":"ko","tag":"작업 그룹","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"es/mcp/troubleshooting","slug":"/es/mcp/troubleshooting","pageMetadata":{"title":"Solución de problemas","sidebarTitle":"Solución de problemas","description":"Soluciona problemas habituales de configuración, autenticación, ejecución de tareas y exportación del servidor MCP de Octoparse.","keywords":"solución de problemas de Octoparse MCP, errores del servidor MCP, clave de API de Octoparse, autenticación MCP, errores de ejecución de tareas","noindex":true,"href":"/es/mcp/troubleshooting"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Soluciona problemas habituales de configuración, autenticación, ejecución de tareas y exportación del servidor MCP de Octoparse.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Usa esta página para diagnosticar problemas habituales al configurar o utilizar el servidor MCP de Octoparse.`}),`\n`,_jsx(Heading,{level:`2`,id:`problemas-de-autenticación`,children:`Problemas de autenticación`}),`\n`,_jsx(Heading,{level:`3`,id:`clave-de-api-ausente-o-no-válida`,children:`Clave de API ausente o no válida`}),`\n`,_jsx(_components.p,{children:`Puede aparecer un error de autenticación si el servidor MCP no encuentra una clave de API de Octoparse válida.`}),`\n`,_jsx(_components.p,{children:`Síntomas habituales:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Unauthorized`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Invalid API key`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authentication failed`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`401 Unauthorized`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Missing API key`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Comprueba que la clave de API sea válida y que no se haya eliminado o regenerado.`}),`\n`,_jsx(_components.p,{children:`Si utilizas una variable de entorno, confirma que esté disponible en el mismo shell o entorno de ejecución que inicia el servidor MCP.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`echo`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` $OCTOPARSE_API_KEY`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Si no aparece ningún valor, vuelve a definir la clave antes de iniciar el servidor.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` OCTOPARSE_API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your-api-key\"`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`No incluyas claves de API en Git, scripts, capturas de pantalla, registros compartidos ni informes de incidencias públicos.`})}),`\n`,_jsx(Heading,{level:`3`,id:`la-clave-funciona-en-un-terminal-pero-no-en-el-cliente-mcp`,children:`La clave funciona en un terminal, pero no en el cliente MCP`}),`\n`,_jsx(_components.p,{children:`Algunos clientes MCP no heredan las variables de entorno del terminal interactivo.`}),`\n`,_jsx(_components.p,{children:`Si el servidor funciona al iniciarlo manualmente, pero falla dentro de un cliente MCP, revisa la configuración del cliente y asegúrate de que la clave de API se pase al proceso del servidor.`}),`\n`,_jsx(_components.p,{children:`Reinicia el cliente MCP después de actualizar las variables de entorno.`}),`\n`,_jsx(Heading,{level:`2`,id:`problemas-al-iniciar-el-servidor`,children:`Problemas al iniciar el servidor`}),`\n`,_jsx(Heading,{level:`3`,id:`el-servidor-mcp-no-se-inicia`,children:`El servidor MCP no se inicia`}),`\n`,_jsx(_components.p,{children:`Si el servidor no se inicia, comprueba el comando, el directorio de trabajo, la versión de Node.js y las variables de entorno.`}),`\n`,_jsx(_components.p,{children:`Ejecuta primero el comando del servidor directamente en un terminal. Así podrás distinguir los problemas de configuración del cliente MCP de los problemas del entorno de ejecución del servidor.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`node`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --version`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --version`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Asegúrate de que el comando utilizado por el cliente MCP coincida con el que funciona en el terminal.`}),`\n`,_jsx(Heading,{level:`3`,id:`comando-no-encontrado`,children:`Comando no encontrado`}),`\n`,_jsx(_components.p,{children:`Si el cliente indica que no encuentra el comando del servidor, utiliza una ruta absoluta o confirma que el paquete esté instalado.`}),`\n`,_jsxs(_components.p,{children:[`Un comando puede funcionar en el shell y fallar en el cliente MCP si ambos no utilizan el mismo `,_jsx(_components.code,{children:`PATH`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`problemas-de-acceso-a-tareas`,children:`Problemas de acceso a tareas`}),`\n`,_jsx(Heading,{level:`3`,id:`tarea-no-encontrada`,children:`Tarea no encontrada`}),`\n`,_jsx(_components.p,{children:`Puede aparecer este error si el ID de la tarea es incorrecto o si la cuenta autenticada no tiene acceso a ella.`}),`\n`,_jsx(_components.p,{children:`Comprueba lo siguiente:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`El ID de la tarea se ha copiado correctamente.`}),`\n`,_jsx(_components.li,{children:`La tarea pertenece a la cuenta autenticada de Octoparse.`}),`\n`,_jsx(_components.li,{children:`La tarea no se ha eliminado.`}),`\n`,_jsx(_components.li,{children:`La clave de API pertenece al espacio de trabajo o a la cuenta correctos.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`no-se-devuelve-ninguna-tarea-accesible`,children:`No se devuelve ninguna tarea accesible`}),`\n`,_jsx(_components.p,{children:`Si la búsqueda no devuelve resultados, verifica primero la clave de API y el acceso de la cuenta. Después, prueba una consulta más amplia o enumera las tareas sin filtrar por palabra clave.`}),`\n`,_jsx(Heading,{level:`2`,id:`problemas-de-ejecución`,children:`Problemas de ejecución`}),`\n`,_jsx(Heading,{level:`3`,id:`la-tarea-no-se-inicia`,children:`La tarea no se inicia`}),`\n`,_jsx(_components.p,{children:`Una tarea puede no iniciarse si su definición no es compatible, si ya se está ejecutando o si la cuenta no tiene permiso para ejecutarla.`}),`\n`,_jsx(_components.p,{children:`Comprueba primero la tarea en Octoparse y vuelve a intentarlo desde el cliente MCP.`}),`\n`,_jsx(_components.p,{children:`Si se creó con un flujo antiguo, vuelve a crearla o actualízala en la aplicación actual de Octoparse antes de ejecutarla mediante automatización.`}),`\n`,_jsx(Heading,{level:`3`,id:`la-ejecución-se-inicia-pero-no-devuelve-datos`,children:`La ejecución se inicia, pero no devuelve datos`}),`\n`,_jsx(_components.p,{children:`Si la ejecución finaliza correctamente, pero la exportación no devuelve datos, comprueba si la tarea ha terminado y si la ejecución o el lote seleccionados contienen datos.`}),`\n`,_jsx(_components.p,{children:`Causas habituales:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`La tarea todavía se está ejecutando.`}),`\n`,_jsx(_components.li,{children:`El ID de lote seleccionado no contiene datos.`}),`\n`,_jsx(_components.li,{children:`La tarea finalizó, pero no encontró registros.`}),`\n`,_jsx(_components.li,{children:`Se solicitó la exportación antes de que terminara la ejecución.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`problemas-de-exportación`,children:`Problemas de exportación`}),`\n`,_jsx(Heading,{level:`3`,id:`la-exportación-falla`,children:`La exportación falla`}),`\n`,_jsx(_components.p,{children:`Verifica que la tarea haya finalizado y que la herramienta admita el formato de exportación elegido.`}),`\n`,_jsx(_components.p,{children:`Si el comando o la herramienta acepta un ID de lote, asegúrate de que pertenezca a la misma tarea y al mismo historial de ejecución.`}),`\n`,_jsx(Heading,{level:`3`,id:`archivo-de-exportación-vacío`,children:`Archivo de exportación vacío`}),`\n`,_jsx(_components.p,{children:`Normalmente significa que la ejecución seleccionada no contiene registros extraídos o que se solicitó la exportación antes de finalizar la extracción.`}),`\n`,_jsx(_components.p,{children:`Comprueba primero el historial y vuelve a exportar con la ejecución o el lote correctos.`}),`\n`,_jsx(Heading,{level:`2`,id:`límites-de-solicitudes-y-fallos-transitorios`,children:`Límites de solicitudes y fallos transitorios`}),`\n`,_jsx(_components.p,{children:`Si una solicitud falla de manera intermitente, espera brevemente y vuelve a intentarlo. Los problemas de red, los retrasos de la cola de tareas o los errores temporales del backend pueden provocar fallos transitorios.`}),`\n`,_jsx(_components.p,{children:`Si el fallo se repite, recopila:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`El nombre y la versión del cliente MCP`}),`\n`,_jsx(_components.li,{children:`La versión del servidor MCP`}),`\n`,_jsx(_components.li,{children:`La llamada a la herramienta o el prompt exactos`}),`\n`,_jsx(_components.li,{children:`El ID de la tarea`}),`\n`,_jsx(_components.li,{children:`El mensaje de error`}),`\n`,_jsx(_components.li,{children:`Si la misma tarea funciona directamente en Octoparse`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Elimina claves de API, tokens de acceso, cookies y datos personales antes de compartir registros.`})}),`\n`,_jsx(Heading,{level:`2`,id:`información-que-debes-proporcionar-al-informar-de-un-problema`,children:`Información que debes proporcionar al informar de un problema`}),`\n`,_jsx(_components.p,{children:`Incluye:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Nombre del cliente MCP`}),`\n`,_jsx(_components.li,{children:`Versión del servidor MCP`}),`\n`,_jsx(_components.li,{children:`Sistema operativo`}),`\n`,_jsx(_components.li,{children:`Versión de Node.js`}),`\n`,_jsx(_components.li,{children:`Nombre de la herramienta que falló`}),`\n`,_jsx(_components.li,{children:`Mensaje de error exacto`}),`\n`,_jsx(_components.li,{children:`ID de la tarea o un ejemplo anonimizado`}),`\n`,_jsx(_components.li,{children:`Si la tarea funciona en Octoparse fuera de MCP`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Solución de problemas","sidebarTitle":"Solución de problemas","description":"Soluciona problemas habituales de configuración, autenticación, ejecución de tareas y exportación del servidor MCP de Octoparse.","keywords":"solución de problemas de Octoparse MCP, errores del servidor MCP, clave de API de Octoparse, autenticación MCP, errores de ejecución de tareas","noindex":true,"href":"/es/mcp/troubleshooting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Problemas de autenticación","slug":"problemas-de-autenticación","depth":2,"children":[{"title":"Clave de API ausente o no válida","slug":"clave-de-api-ausente-o-no-válida","depth":3,"children":[]},{"title":"La clave funciona en un terminal, pero no en el cliente MCP","slug":"la-clave-funciona-en-un-terminal-pero-no-en-el-cliente-mcp","depth":3,"children":[]}]},{"title":"Problemas al iniciar el servidor","slug":"problemas-al-iniciar-el-servidor","depth":2,"children":[{"title":"El servidor MCP no se inicia","slug":"el-servidor-mcp-no-se-inicia","depth":3,"children":[]},{"title":"Comando no encontrado","slug":"comando-no-encontrado","depth":3,"children":[]}]},{"title":"Problemas de acceso a tareas","slug":"problemas-de-acceso-a-tareas","depth":2,"children":[{"title":"Tarea no encontrada","slug":"tarea-no-encontrada","depth":3,"children":[]},{"title":"No se devuelve ninguna tarea accesible","slug":"no-se-devuelve-ninguna-tarea-accesible","depth":3,"children":[]}]},{"title":"Problemas de ejecución","slug":"problemas-de-ejecución","depth":2,"children":[{"title":"La tarea no se inicia","slug":"la-tarea-no-se-inicia","depth":3,"children":[]},{"title":"La ejecución se inicia, pero no devuelve datos","slug":"la-ejecución-se-inicia-pero-no-devuelve-datos","depth":3,"children":[]}]},{"title":"Problemas de exportación","slug":"problemas-de-exportación","depth":2,"children":[{"title":"La exportación falla","slug":"la-exportación-falla","depth":3,"children":[]},{"title":"Archivo de exportación vacío","slug":"archivo-de-exportación-vacío","depth":3,"children":[]}]},{"title":"Límites de solicitudes y fallos transitorios","slug":"límites-de-solicitudes-y-fallos-transitorios","depth":2,"children":[]},{"title":"Información que debes proporcionar al informar de un problema","slug":"información-que-debes-proporcionar-al-informar-de-un-problema","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"octoparse","siteName":"Octoparse Docs","title":"Solución de problemas - Octoparse Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/mcp/troubleshooting","matchLevel":1},"es":{"href":"/es/mcp/troubleshooting","matchLevel":0},"fr":{"href":"/fr/mcp/troubleshooting","matchLevel":1,"noindex":true},"de":{"href":"/de/mcp/troubleshooting","matchLevel":1,"noindex":true},"it":{"href":"/it/mcp/troubleshooting","matchLevel":1,"noindex":true},"ko":{"href":"/ko/mcp/troubleshooting","matchLevel":1,"noindex":true},"ja":{"href":"/jp/mcp/troubleshooting","matchLevel":1}}},"lastModified":"2026-08-11T08:14:46.095Z","originalFileLocation":"es/mcp/troubleshooting.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Soluciona problemas habituales de configuración, autenticación, ejecución de tareas y exportación del servidor MCP de Octoparse.\">\u003cmeta data-mint-head name=\"keywords\" content=\"solución de problemas de Octoparse MCP, errores del servidor MCP, clave de API de Octoparse, autenticación MCP, errores de ejecución de tareas\">\u003cmeta data-mint-head name=\"application-name\" content=\"Octoparse Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Solución de problemas - Octoparse Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Soluciona problemas habituales de configuración, autenticación, ejecución de tareas y exportación del servidor MCP de Octoparse.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Octoparse Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.octoparse.com/docs/es/mcp/troubleshooting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://octoparse.mintlify.site/docs/_mintlify/api/og/v2?division=PRIMEROS+PASOS\u0026amp;title=Soluci%C3%B3n+de+problemas\u0026amp;description=Soluciona+problemas+habituales+de+configuraci%C3%B3n%2C+autenticaci%C3%B3n%2C+ejecuci%C3%B3n+de+tareas+y+exportaci%C3%B3n+del+servidor+MCP+de+Octoparse.\u0026amp;theme=9934a710d60c4378e24fdaf5\u0026amp;signature=c4b736a465391cb097b47ec32acecade12f436392cf43291c3eac9cc9dee3248\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Solución de problemas - Octoparse Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Soluciona problemas habituales de configuración, autenticación, ejecución de tareas y exportación del servidor MCP de Octoparse.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://octoparse.mintlify.site/docs/_mintlify/api/og/v2?division=PRIMEROS+PASOS\u0026amp;title=Soluci%C3%B3n+de+problemas\u0026amp;description=Soluciona+problemas+habituales+de+configuraci%C3%B3n%2C+autenticaci%C3%B3n%2C+ejecuci%C3%B3n+de+tareas+y+exportaci%C3%B3n+del+servidor+MCP+de+Octoparse.\u0026amp;theme=9934a710d60c4378e24fdaf5\u0026amp;signature=c4b736a465391cb097b47ec32acecade12f436392cf43291c3eac9cc9dee3248\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Octoparse Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#117CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.octoparse.com/docs/es/mcp/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/es/mcp/troubleshooting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Octoparse Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Octoparse Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/es/mcp/troubleshooting.md","siteName":"Octoparse Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/en/mcp/troubleshooting"}]},{"language":"es","tabs":[{"tab":"Inicio","pages":[{"title":"Inicio","href":"/es/overview"}]},{"tab":"Academia","pages":[{"title":"Academia","href":"/es/academy"}]},{"tab":"Asistente de IA","pages":[{"title":"Asistente de IA","href":"/es/ai-assistant"}]},{"tab":"Plantillas","pages":[{"title":"Plantillas","href":"/es/templates/overview"}]},{"tab":"Desktop","pages":[{"title":"Desktop","href":"/es/desktop/how-it-works"}]},{"tab":"Nube","pages":[{"title":"Nube","href":"/es/cloud/local-vs-cloud"}]},{"tab":"MCP","groups":[{"group":"PRIMEROS PASOS","pages":[{"title":"Servidor MCP de Octoparse","href":"/es/mcp"},{"title":"Límites de solicitudes","href":"/es/mcp/rate-limits"},{"title":"Ejemplo de flujo de trabajo","description":"Un ejemplo completo: desde encontrar una plantilla hasta exportar los resultados.","href":"/es/mcp/workflow"},{"title":"Solución de problemas","sidebarTitle":"Solución de problemas","href":"/es/mcp/troubleshooting"},{"title":"Preguntas frecuentes","description":"Preguntas frecuentes sobre las herramientas MCP, la ejecución de tareas y los límites de la cuenta.","href":"/es/mcp/faq"}]},{"group":"REFERENCIA DE HERRAMIENTAS","pages":[{"title":"search_templates","href":"/es/mcp/search-templates"},{"title":"execute_task","href":"/es/mcp/execute-task"},{"title":"export_data","href":"/es/mcp/export-data"},{"title":"search_tasks","href":"/es/mcp/search-tasks"},{"title":"start_or_stop_task","href":"/es/mcp/start-or-stop-task"},{"title":"redeem_coupon_code","href":"/es/mcp/redeem-coupon-code"}]}]},{"tab":"Referencia de la API","pages":[{"title":"Referencia de la API","href":"/es/api-reference"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/es/cli"}]},{"tab":"Data Hub","pages":[{"title":"Data Hub","href":"/es/datahub"}]}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/mcp/troubleshooting"}]},{"language":"de","pages":[{"title":"de","href":"/de/mcp/troubleshooting"}]},{"language":"it","pages":[{"title":"it","href":"/it/mcp/troubleshooting"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/mcp/troubleshooting"}]},{"language":"ja","pages":[{"title":"ja","href":"/jp/mcp/troubleshooting"}]}]},"basePath":"","title":"Solución de problemas - Octoparse Docs","buildId":"dpl_5Wnaxc3m8t3HZwdvwe36fSBdcT12","deploymentId":"dpl_5Wnaxc3m8t3HZwdvwe36fSBdcT12","dynamics":[],"chunks":[]}