> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/dapta-mcp/troubleshooting.md). # Solución de Problemas Problemas comunes del Dapta MCP y cómo resolverlos: preguntas sobre el workspace, problemas de inicio de sesión, errores de clave, límites de uso, herramientas de búsqueda web eliminadas y vistas prev La mayoría de los problemas se reducen al workspace, al inicio de sesión o a la clave de API. Esta tabla cubre los casos comunes. | Síntoma | Causa probable | Solución | | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | Claude pregunta qué workspace usar | Iniciaste sesión y tu cuenta tiene varios workspaces | Responde con el nombre del workspace (no con un id). Di "cambia a \" para cambiar después | | "workspace is required" en la respuesta de una herramienta | Una conversación con inicio de sesión que todavía no ha nombrado su workspace | Dile a Claude el workspace. Él repite la llamada | | La página de inicio de sesión entra en bucle, o el conector muestra un error en claude.ai | Sesión del conector desactualizada | Elimina el conector de Dapta y agrégalo de nuevo con `https://mcp.dapta.ai/mcp` | | Iniciaste sesión pero no aparece ningún workspace | Iniciar sesión llega solo a los workspaces donde eres propietario o admin | Pídele al propietario de tu workspace que te haga admin, o que te dé una clave de API para ese workspace | | ChatGPT abre el navegador por segunda vez después de instalar la app | Al instalar la app se vincula tu cuenta una vez más | Es normal. Haz clic otra vez en **Open ChatGPT** | | Cursor avisa que el inicio de sesión redirige a `localhost` | Cursor recibe el inicio de sesión en tu propia computadora | Es normal. Haz clic en **Allow access** y luego en **Open Cursor** | | 401 "Invalid or revoked API key" | Clave incorrecta o revocada | Revisa la clave en **Acceso MCP**. Crea una nueva si hace falta | | 401 que envía al cliente a un inicio de sesión aunque usas una clave | La clave se envió como `Authorization: ` sin `Bearer`, o en un header desconocido | Usa el header `x-api-key`, `Authorization: Bearer `, o la URL del conector con la clave | | **Crear clave de API** no aparece o falla | Solo el propietario del workspace puede crear claves | Mejor inicia sesión con tu cuenta de Dapta, o pídele una clave al propietario del workspace | | "Límite de keys alcanzado (10 activas)" | El workspace ya tiene 10 claves activas | Revoca en **Acceso MCP** una clave que ya no uses y luego crea la nueva | | "Rate limit exceeded (60/min)" | Más de 60 llamadas a herramientas en un minuto desde la misma clave o inicio de sesión | Espera un minuto y vuelve a preguntar | | "heavy-tool budget exceeded (100/hour)" | Las analíticas pesadas, como mapas de calor de llamadas, análisis de variables o estadísticas de ejecuciones de flujos, tienen un límite de 100 llamadas por hora por workspace | Espera y vuelve a intentarlo más tarde, o limita la pregunta a un agente o a un rango de fechas más corto | | Claude dice que una herramienta de búsqueda web es desconocida | Las herramientas de búsqueda web se eliminaron del servidor | Usa la búsqueda web de tu propio cliente. Si no, Claude te pide los datos de la empresa | | Una escritura dice que la vista previa venció | Las vistas previas son de un solo uso y duran poco | Pídele a Claude que genere la vista previa otra vez y confirma | | Instrucciones antiguas mencionan un plugin o un paquete de skills | Ambos están retirados | No hay nada que descargar. Conéctate con un inicio de sesión o una clave como se describe en [Configuración y Conexión](/dapta-docs-es/dapta-mcp/setup.md) | *** ## ¿Sigues con problemas? Escribe a e incluye el cliente que usas, cómo te conectaste (inicio de sesión o clave de API) y el mensaje exacto que ves. Nunca envíes tu clave de API. *** ## Relacionado {% content-ref url="/pages/YjqSi8sNMity7yIJrL6w" %} [Verifica tu conexión](/dapta-docs-es/dapta-mcp/setup/verify.md) {% endcontent-ref %} {% content-ref url="/pages/H5CyEzM9NRIPupJxrUsd" %} [Genera tu clave de API](/dapta-docs-es/dapta-mcp/setup/mint-your-api-key.md) {% endcontent-ref %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.dapta.ai/dapta-docs-es/dapta-mcp/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.