Recuperação
Solução de Problemas
Quando o onboarding falha, o problema geralmente é o estado da sessão, o caminho da config MCP ou a URL errada do servidor. Verifique nesta ordem.
IDE Selecionada
Cursor
.cursor/mcp.json
O Swylink mantém a ponte explícita para esta IDE renderizando --ide cursor e o caminho correto da config MCP em toda a documentação.
Seção
Sem sessão ativa no CLI
Se a geração ou troca do token de configuração falhar, seu estado de autenticação local pode estar ausente ou expirado.
- Rode npx @swylink/cli auth whoami --api-base-url https://api.swylink.com
- Se reportar que não há sessão, rode npx @swylink/cli auth login --api-base-url https://api.swylink.com novamente
- Se o login funcionar mas a geração do token ou a inicialização da ponte estiver bloqueada, verifique se a conta tem uma assinatura ativa no dashboard
Seção
IDE fica offline
A IDE geralmente fica offline quando a config aponta para o arquivo errado ou o comando ainda resolve para localhost em vez do seu backend de produção.
- Confirme que o caminho do arquivo corresponde a .cursor/mcp.json para a IDE selecionada
- Confirme que a config inclui --ide cursor
- Se espera produção, mantenha --server wss://api.swylink.com/ws explícito na config gerada
- Rode npx @swylink/cli doctor --ide cursor para verificar conflitos de configuração
Loop mínimo de debug
Rode o comando start exato manualmente em um terminal primeiro. Se conectar lá, o problema restante quase sempre é o arquivo de config da IDE ou o ambiente do processo.
Seção
Idioma e localização
O CLI suporta múltiplos idiomas para mensagens de saída. Defina o idioma explicitamente se a detecção automática estiver errada.
- Use --lang pt (ou en, es, fr, de, zh) para sobrescrever o idioma detectado
- Você também pode definir a variável de ambiente SWYLINK_LANG
Continuar
Siga o caminho completo do CLI, da autenticação à conexão da IDE, ou volte ao início para documentar o onboarding de um novo usuário.