Resposta rápida
Se um assistente de IA não consegue ler seus dados do Dashboardly, as causas podem ser uma conexão OAuth revogada, uma chave API ausente ou revogada, um escopo de lojas incorreto, uma versão sem suporte ao Model Context Protocol ou uma loja desconectada no TikTok. Veja abaixo as verificações para cada caso.
Este artigo cobre o login com sua conta Dashboardly (OAuth) e as conexões com chave API. Se ainda não conectou um assistente, comece por «Conectar assistentes de IA ao Dashboardly».
«Não vejo a aba API Keys nas configurações»
As chaves API MCP estão incluídas em Brand Growing, Pro e Enterprise e em todos os planos Agency. Brand Free e Starter não incluem esse recurso. Developer REST é uma capacidade separada: a elegibilidade MCP não concede esse acesso.
O que verificar
- Confira seu plano em Settings > Subscriptions.
- Se usa Brand Free ou Starter, compare os planos elegíveis antes de decidir pelo upgrade.
- Após mudar de plano, recarregue Settings e confira API Keys.
Se um plano Brand ou Agency elegível não mostra a aba, saia e entre novamente para atualizar a sessão. Se ela continuar ausente, fale com o suporte.
Aparece «Failed to load API keys»
Seu navegador chegou ao Dashboardly, mas não conseguiu carregar a lista de chaves.
O que verificar
- Recarregue a página. Uma falha temporária de rede ou um deploy recente pode causar o problema; recarregar pode resolvê-lo.
- Saia e entre novamente. Sua sessão pode ter expirado. Depois, abra Settings > API Keys novamente.
- Verifique a conexão TikTok Shop. Alguns tipos de conta precisam de uma loja ativa. Em Settings > Shops, confirme que pelo menos uma está «Active» ou «Connected».
- Teste outro navegador ou uma janela anônima. Extensões podem interferir nas solicitações seguras.
Se o erro continuar em dois navegadores após um novo login, envie o erro e uma captura ao suporte. Antes de compartilhar imagens ou trechos do console, remova chaves API, cabeçalhos de autorização, cookies, tokens e dados de clientes.
«Meu assistente diz que não consegue conectar ao Dashboardly»
As causas mais comuns são:
A URL do endpoint está errada
Use o endpoint do tipo de conexão: MCP não é a API Developer REST. ChatGPT e Claude Desktop usam o login da conta Dashboardly (OAuth), sem a chave API secreta. Claude Code e Cursor podem usar o endpoint MCP HTTP remoto com uma chave Bearer.
O que verificar
Leia as instruções públicas; não precisa criar uma chave temporária para encontrar a URL. Para MCP, use https://mcp.dashboardly.io/mcp, incluindo /mcp. Developer REST usa https://api.dashboardly.io/api/developer/v1 no seu servidor, não no navegador nem em aplicativo móvel. Não troque os endpoints.
A versão do assistente não suporta MCP
Confirme que o assistente suporta a conexão MCP desejada e que ela está habilitada na conta ou no workspace. Atualizar o aplicativo não habilita sozinho uma integração desativada.
O que verificar
Atualize o assistente de IA para a versão mais recente:
- Claude Desktop: Confira atualizações e siga as instruções OAuth do Dashboardly.
- Claude na web: Confira as integrações atuais da conta ou do workspace.
- ChatGPT: Conexões personalizadas dependem das configurações da conta e do workspace; veja a orientação oficial.
- Cursor: Atualize o aplicativo e siga as instruções MCP.
Após atualizar, reinicie o aplicativo e tente conectar novamente.
«Authentication failed» ou «Invalid API key»
O assistente chegou ao Dashboardly, mas a chave foi rejeitada.
O que verificar
- Confirme que a chave está ativa. Em Settings > API Keys, uma chave revogada não pode ser reutilizada; crie uma substituta se necessário.
- Confira a validade. Uma chave expirada não autentica; substitua-a se necessário.
- Remova espaços acidentais. Não inclua espaços ou quebras de linha antes ou depois da chave.
- Copie o segredo completo. Ele começa com
dk_live_. Dashboardly só o mostra na criação ou rotação. Se o perder, use a ação de rotação disponível ou crie uma substituta e atualize o assistente. - Confira a conta. A chave deve pertencer à conta Dashboardly dos dados que deseja ler.
Se uma chave nova for rejeitada imediatamente, confira endpoint, autenticação, validade e conta. Se persistir, procure o suporte; não crie várias chaves apenas para investigar.
«O assistente não retorna dados» ou «Não encontro pedidos»
A conexão funciona, mas o assistente não encontra dados para sua pergunta.
O que verificar
- Confira loja e tipo de acesso. Verifique Shop em API Keys e substitua uma chave com escopo incorreto por uma da loja desejada. Só proprietários/administradores elegíveis podem escolher All shops para MCP. Chaves Collaborator e Developer REST ficam restritas a uma loja. Chaves MCP novas usam Reporting & reconciliation por padrão, sem contatos, endereços e rastreamento dos compradores. Full orders & fulfilment exige escolha explícita de proprietário/administrador elegível.
- Confira o período. Uma loja pouco movimentada pode não ter pedidos na semana passada; tente este mês ou este ano.
- Confira o mesmo período no Dashboardly. Se a métrica também não aparecer ali, investigue a conexão e o status da importação; veja «Por que meus dados estão atrasados?».
- Confira a atividade pertinente. Métricas de anúncios e lives precisam dos dados correspondentes. Sem anúncios, ROAS zero ou ausente não significa erro de conexão.
«O assistente só vê uma loja, mas tenho várias»
A solução depende do login com a conta Dashboardly ou do uso de uma chave API.
O que verificar
Para uma conexão OAuth do ChatGPT ou Claude Desktop:
- Abra Settings > API Keys e encontre o assistente em Connected Apps.
- Se aparecer Current shop only, reconecte apenas se precisar de outro escopo. Revogar remove o acesso atual.
- No novo consentimento, escolha Selected shops only para lojas específicas ou All shops I can access somente se quiser autorizar todas as lojas acessíveis.
Uma conexão pode usar as lojas autorizadas. Dashboardly remove automaticamente lojas desconectadas ou às quais você perdeu acesso. Conexões OAuth anteriores à seleção multiloja mantêm o escopo original de uma loja até serem revogadas e reconectadas.
Para uma chave API MCP, as opções dependem da função da conta:
- Uma chave por loja. Use nomes como «Claude Code — US Shop» ou «Claude Code — UK Shop» e selecione a chave correta no assistente.
- Uma chave MCP para todas as lojas. Proprietários/administradores elegíveis podem escolher explicitamente All shops em Shop para perguntas entre lojas. Chaves Collaborator continuam limitadas a uma loja; Developer REST também exige uma loja selecionada. Uma chave MCP multiloja não concede Developer REST nem permissões opcionais de escrita.
Não é possível mudar a loja vinculada após criar a chave. Para usar outra loja, revogue a chave e crie uma nova.
«Algumas perguntas demoram para responder»
O tempo depende do assistente, da rede, do período e da complexidade da consulta. Não existe um tempo garantido para todas as perguntas. Exemplos que podem demorar:
- Lucros e perdas em períodos longos. O detalhamento anual pode exigir mais processamento.
- Principais produtos de várias lojas. Comparar lojas gera trabalho adicional.
- Valor do cliente ao longo do tempo. Analisar compras recorrentes pode exigir mais dados.
Se perguntas simples demorarem regularmente mais de 30 segundos, informe ao suporte o horário da solicitação lenta para verificarmos os logs.
«Revoguei uma chave por engano»
Chaves revogadas não podem ser restauradas. Não existe desfazer porque o segredo é invalidado permanentemente no Dashboardly.
O que verificar
- Em Settings > API Keys, clique em New API key.
- Selecione loja, validade e acesso permitido. Chaves MCP novas começam com acesso de relatórios; não presuma que a substituta herda permissões opcionais.
- Copie o novo segredo quando for exibido e atualize o assistente.
A substituta tem seu próprio segredo e histórico de uso. Confira loja e permissões antes de usar: o mesmo nome não torna o acesso igual ao da chave revogada.
«Vejo uma conexão desconhecida em Connected Apps»
Connected Apps, no final de API Keys, lista os assistentes que entraram com sua conta Dashboardly. Se não reconhecer uma conexão:
O que verificar
- Clique em Revoke ao lado da conexão. Isso invalida imediatamente os tokens de acesso e renovação e impede uso futuro.
- Mude sua senha Dashboardly se suspeitar que a conta foi comprometida.
Se reconhecer o assistente, mas precisar de outro escopo de lojas, revogue a conexão e reconecte pelo assistente.
Quando procurar o suporte
Procure o suporte se:
- Seguiu os passos e ainda não consegue conectar.
- Uma chave tem uso que você não reconhece.
- API Keys se comporta de forma diferente do artigo, como uma chave revogada que parece funcionar.
- Um plano Brand ou Agency elegível não mostra API Keys mesmo após novo login.
Inclua nome da chave, nome do assistente, erro exato e captura relevante, não o segredo. Oculte tokens, cabeçalhos de autorização, cookies e dados de clientes. Para solicitações lentas, informe o horário.
Nunca compartilhe a chave API completa em mensagens ao suporte. Trate-a como uma senha.