Respuesta breve
Si un asistente de IA no puede leer tus datos de Dashboardly, las causas pueden ser una conexión OAuth revocada, una clave API ausente o revocada, un alcance de tiendas incorrecto, una versión sin soporte para Model Context Protocol o una tienda desconectada en TikTok. A continuación encontrarás las comprobaciones para cada caso.
Este artículo explica tanto el inicio de sesión con tu cuenta de Dashboardly (OAuth) como las conexiones con clave API. Si aún no has conectado un asistente, empieza por «Conectar asistentes de IA a Dashboardly».
«No veo la pestaña API Keys en la configuración»
Las claves API MCP están incluidas en Brand Growing, Pro y Enterprise y en todos los planes Agency. Brand Free y Starter no incluyen esta función. Developer REST es una capacidad independiente: poder usar MCP no concede acceso a Developer REST.
Qué comprobar
- Comprueba tu plan en Settings > Subscriptions.
- Si usas Brand Free o Starter, compara los planes elegibles antes de decidir si cambias de plan.
- Tras un cambio de plan, recarga Settings y comprueba API Keys.
Si tienes un plan Brand o Agency elegible y la pestaña no aparece, cierra sesión y vuelve a entrar para actualizarla. Si sigue sin aparecer, contacta con soporte.
Aparece «Failed to load API keys»
El navegador llegó a Dashboardly, pero no pudo cargar la lista de claves.
Qué comprobar
- Recarga la página. Un fallo temporal de red o un despliegue reciente puede causar el error; recargar puede resolverlo.
- Cierra sesión y vuelve a entrar. La sesión podría haber caducado. Después, abre de nuevo Settings > API Keys.
- Comprueba la conexión de TikTok Shop. Algunos tipos de cuenta necesitan una tienda activa. En Settings > Shops, comprueba que al menos una figure como «Active» o «Connected».
- Prueba otro navegador o una ventana de incógnito. Las extensiones pueden interferir con las solicitudes seguras.
Si el error persiste en dos navegadores después de iniciar sesión de nuevo, envía a soporte el error y una captura. Antes de compartir capturas o fragmentos de la consola, elimina claves API, cabeceras de autorización, cookies, tokens y datos de clientes.
«Mi asistente de IA dice que no puede conectar con Dashboardly»
Las causas más frecuentes son:
La URL del endpoint es incorrecta
Usa el endpoint correspondiente: MCP no es la API Developer REST. ChatGPT y Claude Desktop usan el inicio de sesión de Dashboardly (OAuth), sin la clave API secreta. Claude Code y Cursor pueden usar el endpoint MCP HTTP remoto con una clave Bearer.
Qué comprobar
Consulta las instrucciones públicas; no necesitas crear una clave temporal para encontrar la URL. Para MCP usa https://mcp.dashboardly.io/mcp, incluido /mcp. Developer REST usa https://api.dashboardly.io/api/developer/v1 desde tu servidor, no desde el navegador ni una aplicación móvil. No intercambies los endpoints.
Tu versión del asistente no admite MCP
Comprueba que el asistente admite la conexión MCP deseada y que tu cuenta o espacio de trabajo la habilita. Actualizar la aplicación no activa por sí solo una integración deshabilitada.
Qué comprobar
Actualiza el asistente de IA a la última versión:
- Claude Desktop: Comprueba las actualizaciones y sigue las instrucciones OAuth de Dashboardly.
- Claude en la web: Revisa las integraciones disponibles para tu cuenta o espacio de trabajo.
- ChatGPT: Las conexiones personalizadas dependen de la configuración de cuenta y espacio de trabajo; consulta la guía oficial.
- Cursor: Actualiza la aplicación y sigue las instrucciones MCP.
Después de actualizar, reinicia la aplicación y vuelve a probar la conexión.
«Authentication failed» o «Invalid API key»
El asistente llegó a Dashboardly, pero la clave fue rechazada.
Qué comprobar
- Comprueba que la clave está activa. En Settings > API Keys, una clave revocada no puede reutilizarse; crea una sustituta si hace falta.
- Comprueba la caducidad. Una clave caducada no puede autenticarse; sustitúyela si es necesario.
- Elimina espacios accidentales. No incluyas espacios ni saltos de línea antes o después de la clave.
- Copia el secreto completo. Empieza por
dk_live_. Dashboardly solo lo muestra al crear o rotar la clave. Si lo pierdes, usa la acción de rotación disponible o crea una sustituta y actualiza el asistente. - Comprueba la cuenta. La clave debe pertenecer a la cuenta de Dashboardly cuyos datos quieres leer.
Si una clave nueva se rechaza inmediatamente, comprueba endpoint, método de autenticación, caducidad y cuenta. Si persiste, contacta con soporte; no crees claves repetidamente solo para diagnosticar el problema.
«El asistente no devuelve datos» o «No encuentro pedidos»
La conexión funciona, pero el asistente no encuentra datos para tu pregunta.
Qué comprobar
- Comprueba la tienda y el tipo de acceso. Revisa Shop en API Keys y sustituye una clave con alcance incorrecto por otra de la tienda deseada. Solo propietarios/administradores elegibles pueden seleccionar All shops para MCP. Las claves Collaborator y Developer REST se limitan a una tienda. Las claves MCP nuevas usan Reporting & reconciliation por defecto, sin contactos, direcciones ni seguimiento del comprador. Full orders & fulfilment exige selección explícita de un propietario/administrador elegible.
- Comprueba el intervalo. Una tienda poco activa puede no tener pedidos de la semana pasada; prueba este mes o este año.
- Comprueba el mismo periodo en Dashboardly. Si tampoco aparece la métrica, revisa la conexión y el estado de importación; consulta «¿Por qué se retrasan mis datos?».
- Comprueba la actividad pertinente. Las métricas publicitarias o de directos necesitan datos correspondientes. Sin anuncios, un ROAS cero o ausente no implica un error de conexión.
«El asistente solo ve una tienda, pero tengo varias»
La solución depende de si usas el inicio de sesión de Dashboardly o una clave API.
Qué comprobar
Para una conexión OAuth de ChatGPT o Claude Desktop:
- Abre Settings > API Keys y busca el asistente en Connected Apps.
- Si dice Current shop only, reconecta solo si necesitas otro alcance de tiendas. Revocar elimina el acceso actual.
- En el nuevo consentimiento, selecciona Selected shops only para tiendas concretas, o All shops I can access solo si quieres autorizar todas las tiendas accesibles.
Una conexión puede usar las tiendas autorizadas. Dashboardly elimina automáticamente las desconectadas o aquellas a las que ya no puedes acceder. Una conexión OAuth anterior a la selección multitienda conserva su alcance original de una tienda hasta que la revoques y reconectes.
Para una clave API MCP, las opciones dependen del rol de tu cuenta:
- Una clave por tienda. Usa nombres como «Claude Code — US Shop» o «Claude Code — UK Shop» y selecciona la clave adecuada en el asistente.
- Una clave MCP para todas las tiendas. Los propietarios/administradores elegibles pueden elegir explícitamente All shops en Shop para preguntas entre tiendas. Las claves Collaborator siguen siendo de una tienda; Developer REST también requiere una tienda seleccionada. Una clave MCP multitienda no concede Developer REST ni permisos de escritura opcionales.
No puedes cambiar la tienda vinculada después de crear la clave. Para cambiar de tienda, revócala y crea una nueva.
«Algunas preguntas tardan mucho»
El tiempo depende del asistente, la red, el periodo y la complejidad de la consulta. No hay un tiempo garantizado para todas las preguntas. Pueden tardar más:
- Pérdidas y ganancias de un periodo largo. El desglose anual puede necesitar más procesamiento.
- Productos principales de varias tiendas. Comparar tiendas añade trabajo.
- Valor del cliente a lo largo del tiempo. Analizar compras repetidas puede requerir más datos.
Si las preguntas sencillas tardan habitualmente más de 30 segundos, contacta con soporte indicando la hora de la solicitud lenta para que podamos revisar los registros.
«He revocado una clave por accidente»
Las claves revocadas no se pueden restaurar. No existe deshacer porque Dashboardly invalida permanentemente el secreto.
Qué comprobar
- En Settings > API Keys, pulsa New API key.
- Selecciona tienda, caducidad y acceso permitido. Las claves MCP nuevas tienen acceso de informes por defecto; no supongas que la sustituta hereda permisos opcionales.
- Copia el nuevo secreto cuando aparezca y actualiza el asistente.
La sustituta tiene su propio secreto e historial de uso. Comprueba tienda y permisos antes de usarla: el mismo nombre no hace que tenga el mismo acceso que la clave revocada.
«Veo una conexión desconocida en Connected Apps»
Connected Apps, al final de API Keys, muestra los asistentes que iniciaron sesión con tu cuenta de Dashboardly. Si no reconoces una conexión:
Qué comprobar
- Pulsa Revoke junto a la conexión. Invalida de inmediato sus tokens de acceso y renovación y evita su uso futuro.
- Cambia tu contraseña de Dashboardly si sospechas que tu cuenta está comprometida.
Si reconoces el asistente pero necesitas otro alcance de tiendas, revoca la conexión y reconecta desde el asistente.
Cuándo contactar con soporte
Contacta con soporte si:
- Has seguido los pasos y sigues sin poder conectar.
- Una clave muestra uso que no reconoces.
- API Keys se comporta de forma distinta a lo descrito, por ejemplo una clave revocada parece seguir funcionando.
- Un plan Brand o Agency elegible sigue sin mostrar API Keys tras iniciar sesión de nuevo.
Incluye nombre de la clave, nombre del asistente, error exacto y captura pertinente, no el secreto. Oculta tokens, cabeceras de autorización, cookies y datos de clientes. Para solicitudes lentas, indica la hora.
Nunca compartas la clave API completa en un mensaje de soporte. Trátala como una contraseña.