> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Solução de problemas

> Resolva problemas comuns com o conector do GetQR no Claude, ChatGPT e Cursor.

Encontre a mensagem ou o sintoma que você está vendo e siga a solução. A maioria dos problemas vem da função do membro, da assinatura ou de uma conexão expirada.

## Verificação rápida

Antes de qualquer coisa, confira estes três pontos:

1. **Função.** Você é Admin ou Editor no workspace. Viewers não podem usar conectores de IA.
2. **Assinatura.** A assinatura do Admin do workspace está ativa.
3. **Conexão.** Em **My Account** → **AI connectors**, seu assistente aparece como **Active**.

## Ao conectar

> **“AI connectors aren't available”**
>
> A página de login do GetQR mostra "Viewers can't connect AI assistants. Ask an editor or the workspace owner." Sua função é Viewer. Peça ao Admin do workspace para mudar sua função para Editor. Veja [Funções e permissões](/pt-br/members/roles-and-permissions).

> **“An active subscription is required”**
>
> Assistentes de IA só podem se conectar a contas do GetQR com uma assinatura ativa.
>
> * **Admin:** clique em **View plans** para renovar. Para dúvidas sobre pagamento, consulte a [Central de Ajuda](https://getqr.com/help).
> * **Editor:** a página diz "The workspace owner needs an active subscription before you can connect an AI assistant." Fale com o Admin do seu workspace.

> **“This connection request is invalid”**
>
> O app que enviou você ao GetQR não foi reconhecido, ou o endereço de redirecionamento dele não corresponde. Feche a janela e conecte novamente a partir do assistente. Se continuar acontecendo, remova o GetQR do assistente e adicione-o novamente com `https://getqr.com/api/mcp`.

> **“Couldn't connect this assistant. Try again.”**
>
> A aprovação falhou depois que você clicou em **Allow**. Clique em **Allow** novamente, ou inicie a conexão de novo a partir do assistente.

> **A caixa de diálogo do GetQR fica em “Waiting for…”**
>
> O GetQR aguarda até você aprovar a conexão. Conclua o login no assistente e clique em **Allow** na página do GetQR. A caixa de diálogo é atualizada automaticamente. Se você fechou a aba do assistente, clique em **Cancel** e comece de novo.

> **ChatGPT: “Set up ChatGPT on desktop”**
>
> O ChatGPT não permite adicionar conectores pelo app para celular. Abra o chatgpt.com no seu computador para conectar o GetQR. Veja [Conectar ao ChatGPT](/pt-br/ai-connectors/connect-chatgpt).

> **Cursor: “Set up Cursor on desktop”**
>
> O Cursor é um app de desktop, então só pode ser conectado a partir do seu computador. Veja [Conectar ao Cursor](/pt-br/ai-connectors/connect-cursor).

> **O Cursor não abre pelo botão Open Cursor**
>
> Instale o app de desktop do Cursor e permita que o navegador o abra. Ou adicione o GetQR ao `mcp.json` manualmente. Veja [Conectar ao Cursor](/pt-br/ai-connectors/connect-cursor#adicionar-manualmente).

> **O assistente aparece desativado na caixa de diálogo Connect**
>
> Ele já está conectado à sua conta. Para recomeçar, revogue a conexão primeiro. Veja [Gerenciar conexões](/pt-br/ai-connectors/manage-connections).

## Depois de conectar

> **O assistente diz que o token é inválido ou expirou**
>
> Os tokens de acesso duram 1 hora e o assistente os renova sozinho. Se o assistente não foi usado por 30 dias, ou se a conexão foi revogada, a renovação falha. Reconecte a partir do assistente e clique em **Allow**. Veja [Reconectar um assistente](/pt-br/ai-connectors/manage-connections#reconectar-um-assistente).

> **A conexão aparece como Expired**
>
> O assistente não foi usado por 30 dias. Reconecte a partir do assistente. A conexão volta a mostrar **Active**.

> **O conector funcionava e parou com “Active subscription required”**
>
> A assinatura do workspace não está mais ativa. Todas as conexões param de funcionar até a renovação. Admins podem ver os planos no GetQR; consulte a [Central de Ajuda](https://getqr.com/help) para dúvidas sobre pagamento.

> **O conector parou com “AI connectors are not available for this role.”**
>
> Sua função foi alterada para Viewer, ou você foi removido do workspace. Peça ao Admin do workspace a função Editor.

> **O assistente não usa o GetQR**
>
> Mencione o GetQR no prompt, por exemplo "Usando o GetQR, liste meus QR codes". Verifique se o conector está ativado no assistente para este chat.

> **O assistente trabalha no workspace errado**
>
> Uma conexão fica vinculada a um workspace: seu workspace padrão ou o primeiro workspace em que você entrou.&#x20;

## Tarefas e resultados

> **O assistente não consegue criar um vCard, PDF ou outro tipo de QR**
>
> O conector cria apenas QR codes de site. Crie outros tipos no [criador de QR codes](/pt-br/qr-types/overview).

> **O assistente não consegue alterar o link curto**
>
> Um link curto não pode ser alterado depois que o QR code é criado. Crie um novo QR code com o link curto que você quer.

> **O assistente não consegue gerenciar membros**
>
> O gerenciamento de membros é exclusivo do Admin do workspace. Editors recebem um erro de permissão.

> **O assistente não consegue usar meu logo enviado ou um AI design**
>
> Logos enviados, Convert logo to QR, Branded designs e AI designs não estão disponíveis pelo conector. Use os logos sugeridos ou estilize o código no app.

> **O link de download ou exportação não funciona**
>
> Os links funcionam por 1 hora. Peça um novo ao assistente. Em uma exportação grande, uma página em branco significa que o arquivo ainda não está pronto: aguarde cerca de um minuto. Se continuar em branco depois de uns 5 minutos, peça a exportação de novo com um período menor ou em CSV.

> **Um domínio não pode ser usado em um QR code**
>
> O domínio precisa estar ativo e o QR code precisa de um link curto personalizado. Peça ao assistente para verificar o domínio. Se ele não estiver ativo, adicione o registro CNAME informado no seu provedor de DNS (somente DNS, sem proxy) e verifique de novo depois de um minuto. Veja [Verificar e resolver problemas de um domínio](/pt-br/custom-domains/verify-and-troubleshoot).

> **O assistente pergunta sobre cobrança ou exclusão da minha conta**
>
> Assinatura, cobrança e exclusão de conta nunca ficam disponíveis para assistentes. Use o app do GetQR ou a [Central de Ajuda](https://getqr.com/help).

## Ainda com problemas?

Envie um e-mail para [help@getqr.com](mailto:help@getqr.com) informando o assistente que você usa, o que você pediu e a mensagem de erro que aparece.

## Próximos passos

> **[Gerenciar conexões](/pt-br/ai-connectors/manage-connections)**

> **[O que você pode fazer](/pt-br/ai-connectors/capabilities)**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.