Cursor mostra “Connection failed”: como saber se o problema é sua rede, a VPN ou o serviço

Fala aí, beleza? Tu tá no meio de uma tarefa com o agente do Cursor e do nada aparece isso aqui:

Connection failed. If the problem persists, please check your internet connection or VPN

Ou a variante mais curta: Connection failed. Please check your internet connection or VPN

O texto joga a culpa na sua internet ou na sua VPN, né? Só que não é bem assim

No fórum oficial do Cursor essa mensagem aparece em vários relatos, e já veio junto de um Internal Error: internal em episódios de instabilidade do próprio Cursor, como no tópico "Cursor down: Connection failed… Internal Error: internal"

Ou seja: o erro pode ter três origens bem diferentes

• Serviço fora do ar: o problema está do lado do Cursor
• Bloqueio local: VPN, proxy corporativo, firewall, antivírus ou a própria rede
• Falha de sessão: uma conversa específica que travou

Bora separar uma coisa da outra, do teste mais barato pro mais caro 🙂

Primeiro teste: o Cursor está fora do ar?

Antes de mexer em qualquer configuração, abre o status.cursor.com, a página de status oficial do Cursor

O sintoma típico de falha do serviço é o erro aparecer de repente, sem tu ter mudado nada na sua rede

E isso acontece mesmo: o caso do Internal Error: internal citado acima mostra que a mensagem também surge quando o problema é no servidor

Se a página mostra incidente, pode parar por aí

Não existe ajuste local que resolva queda do serviço, então trocar proxy, reinstalar ou mexer no settings.json nessa hora só vai te fazer perder tempo (e talvez quebrar algo que estava funcionando haha)

Como prevenir: transforma a página de status no passo número 1 do seu hábito de diagnóstico, sempre

Nova conversa resolve? Quando o problema é a sessão do chat

Se o status está normal e o erro aparece numa conversa específica, sobretudo naquela com histórico gigante, vale abrir um New Chat e repetir o pedido

Usuários do fórum relatam que abrir uma nova conversa às vezes alivia o erro por algum tempo, e que históricos muito longos podem pesar

Se liga: isso é alívio temporário relatado pela comunidade, não uma correção oficial do Cursor

Agora, se o erro volta até numa conversa novinha, a causa provavelmente não é a sessão, e aí bora pro próximo teste

Como prevenir: não estender demais uma única conversa, conforme os próprios relatos do fórum

Como usar o diagnóstico de rede do Cursor (Run Diagnostics)

O Cursor tem um diagnóstico de rede built-in, e pouca gente usa

O caminho, segundo a documentação de troubleshooting de rede:

1. Abre Cursor Settings
2. Vai em Network
3. Clica em Run Diagnostics

O recurso testa a conexão com os servidores do Cursor e aponta problemas que afetam os recursos de IA ou as atualizações

Por que rodar isso antes de sair ajustando coisa? Porque ele te ajuda a separar falha local de falha remota com um clique, em vez de chutar

Guarda o resultado, porque ele vai servir mais pra frente, tanto pra conversar com o TI quanto pra mandar pro suporte

VPN, antivírus ou rede doméstica: como confirmar trocando de rede

Status normal, New Chat não resolveu, diagnóstico apontando problema de conexão… hora do teste mais revelador

Desliga a VPN ou troca de rede (por exemplo, roteando a internet pelo celular) e repete EXATAMENTE a mesma ação no chat

A leitura do resultado é simples:

• Funcionou fora da rede de sempre? O bloqueio é local: VPN, firewall, antivírus ou a própria rede
• Falhou em qualquer rede? A suspeita volta pra instalação, pra conta ou pro serviço

É o mesmo raciocínio de testar se a lâmpada queimou trocando ela de soquete: muda uma variável só e vê o que acontece

Tome cuidado pra não trocar várias coisas ao mesmo tempo (VPN, rede e configuração juntas), senão tu não descobre qual delas era o problema

Proxy corporativo (Zscaler e similares): mudar o Cursor para HTTP/1.1

Se tu programa dentro da rede da empresa, esse aqui é um dos suspeitos mais fortes

O porquê, direto da documentação do Cursor: alguns proxies corporativos, como o Zscaler, bloqueiam HTTP/2, e o Cursor usa HTTP/2 para streaming das respostas

A solução oficial:

1. Abre Cursor Settings > Network
2. Em HTTP Compatibility Mode, escolhe HTTP/1.1
3. Reinicia o Cursor

Tem também uma alternativa citada no fórum oficial: colocar isso no seu settings.json

{
  "cursor.general.disableHttp2": true
}

Ou buscar por "HTTP/2" nas configurações e ativar Disable HTTP/2

Mas atenção pra limitação: há relato no mesmo tópico de que um valor vindo do servidor pode sobrescrever o cursor.general.disableHttp2, e parte dos usuários atrás de proxy corporativo diz que esse workaround não resolveu tudo

Então se tu ativou e o erro continua, não é necessariamente porque fez errado

Como configurar o proxy no Cursor (e o problema da versão 3.9)

Em rede que só sai por proxy, a documentação cita esta configuração no settings.json:

{
  "http.proxy": "http://<proxy>:<porta>",
  "http.proxySupport": "override"
}

Troca <proxy> e <porta> pelos dados que o TI da sua empresa usa

Depois disso, fecha e reabre o Cursor de verdade

Caso tu esteja pensando em só dar um Reload Window: não basta, a documentação é clara nisso

O erro comum: a regressão da linha 3.9.x

Aqui mora uma pegadinha que pode te fazer culpar a rede à toa

Segundo esse mesmo tópico de bug no fórum oficial, desde a versão 3.9.16 as requisições de IA (API, Chat, Agent, Ping) usam um transporte HTTP/2 separado que NÃO passa pelo proxy configurado em http.proxy

Na prática, isso pode gerar:

• resets de conexão em redes que só saem por proxy
• o erro "model not available in your region"

O caso foi relatado como regressão da 3.8 para a 3.9 e segue em acompanhamento no fórum

E tem mais um relato na mesma linha: na versão 3.9.21, usuários não conseguem usar o proxy integrado do Windows (Kerberos/NTLM) depois da atualização

Moral da história: confere qual versão do Cursor está instalada antes de culpar a rede

Se o erro começou logo depois de uma atualização e tu está numa versão da linha 3.9.x atrás de proxy, acompanha esses tópicos, porque não dá pra prometer quando (nem se) a correção já chegou na sua versão

Firewall da empresa: quais domínios do Cursor liberar

Se a rede corporativa bloqueia o tráfego de saída, nenhum ajuste no Cursor vai resolver sozinho

A documentação de rede do Cursor manda liberar (allowlist) estes domínios:

• *.cursor.sh
• *.cursor-cdn.com
• *.cursorapi.com

Esse pedido normalmente vai pro time de TI, então manda a lista exatamente assim

Checagem: depois da liberação, roda de novo o Run Diagnostics em Cursor Settings > Network e repete a ação que dava erro no chat

Como prevenir: se a sua equipe está adotando o Cursor agora, inclui esses domínios no pedido de acesso desde o começo, poupa muiiita dor de cabeça depois 😀

O que mandar para o suporte do Cursor sem expor chaves nem código

Status normal, outra rede testada, ajustes feitos e o erro continua? Hora de abrir um relato, e bem feito

Primeiro, o Request ID, que identifica a requisição que falhou. Conforme a documentação de relato de bugs:

1. Abre a conversa no Chat onde deu erro
2. Clica no menu "…"
3. Escolhe Copy Request ID

A mesma documentação pede estes itens no relato:

• versão do Cursor
• sistema operacional
• passos para reproduzir
• comportamento esperado e comportamento real
• prints ou gravação de tela
• Request ID
• erros do console (Help > Toggle Developer Tools)

E a privacidade? Boa notícia aqui

Segundo a documentação de request reporting, com o Privacy Mode ligado o suporte vê só o modelo usado, se houve falha de ferramenta (sem saber qual) e falhas de backend que não têm a ver com prompt, código ou ações do agente

E problemas de conectividade normalmente dá pra investigar mesmo com o Privacy Mode ligado, ou seja, tu não precisa expor código nem conversa pra diagnosticar um Connection failed

Só que o cuidado com o que TU envia continua sendo seu

Tome cuidado: antes de mandar print ou log do console, revisa tudo e apaga chave de API, token e trecho de código privado que tenha aparecido na tela

Se o tema de segurança no projeto (chave vazada e afins) te preocupa, tem um conteúdo do canal Hora de Codar sobre como encontrar problemas de segurança nos seus projetos:

Próximo passo se o erro continuar

Se o status está normal e o erro persiste até em outra rede, para de trocar configuração às cegas

Abre o relato com Request ID, versão do Cursor e o resultado do Run Diagnostics, isso vale mais que a décima tentativa de mexer no settings.json

Em rede corporativa, leva pro TI um pedido só, completão: a liberação de .cursor.sh, .cursor-cdn.com e *.cursorapi.com, mais a informação de que o Cursor pode precisar rodar em HTTP/1.1 atrás de proxies como o Zscaler

Até o próximo post! =)

Quer aprender mais sobre inteligência artificial e programação na prática? Conheça o canal Hora de Codar no YouTube e acompanhe os próximos vídeos.