Como configurar o cursor do gate.ai no Cursor

Gate.AI compatível com a forma de integração do OpenAI permite que desenvolvedores conectem o Cursor ao Gate.AI usando a chave API do Gate.AI, a URL base compatível com OpenAI e o ID de modelo suportado, até junho de 2026. Para desenvolvedores que desejam enviar solicitações de modelos no Cursor Chat, Composer, Agent ou interfaces de código semelhantes através do Gate.AI, em vez do provedor de modelos padrão, essa configuração é especialmente importante. Este guia cobre apenas o processo de configuração do Cursor; para um entendimento mais amplo sobre integração de API, consulte o Guia de Integração da API do Gate.AI.

Pré-requisitos

• Cursor instalado.
• Chave API do Gate.AI disponível.

Conteúdo baseado na documentação oficial do Gate.AI e nas capturas de tela de configuração do Cursor fornecidas, até junho de 2026.

O que você pode fazer após concluir este guia?

Após configurar o Gate.AI no Cursor, você poderá adicionar o Gate.AI como uma rota de modelo personalizada no Cursor, inserindo sua chave API do Gate.AI e a URL base compatível com OpenAI, selecionando modelos como deepseek/deepseek-v3.2, e usando esse modelo na interface de chat ou de agentes do Cursor.

Este guia cobre apenas a configuração na interface do Cursor. Não inclui integração via SDK, configuração do Claude Code, Claude Desktop ou permissões empresariais.

Passo 1: Abrir configurações do Cursor

Este passo abrirá a área de configuração do Cursor, onde você gerencia modelos e configurações de API.

Ação: No Cursor, vá ao canto superior direito e clique no ícone de configurações. A rota de entrada do Cursor descrita na documentação oficial do Gate.AI é Menu superior direito → Configurações.

Antes de alterar a configuração do modelo, acesse as configurações do Cursor pelo menu superior direito.

Passo 2: Abrir configurações de modelos

Este passo acessa a página de configuração de modelos do Cursor.

Ação: Dentro das configurações do Cursor, na barra lateral esquerda, selecione Modelos. Se a lista completa de modelos não estiver visível, escolha Ver todos os modelos. Segundo a documentação do Gate.AI, o caminho para adicionar modelos personalizados no Cursor é Modelos → Ver todos os modelos.

Gerencie modelos internos, modelos personalizados e configurações de API na aba de modelos.

Passo 3: Clicar em adicionar modelo personalizado

Este passo cria uma nova entrada de modelo personalizado para o Gate.AI.

Ação: Role até o final da lista de modelos e clique em Adicionar modelo personalizado. A documentação do Gate.AI indica que o caminho de configuração do Cursor deve rolar até o final e selecionar Adicionar modelo personalizado.

Após adicionar o modelo personalizado, será exibido um campo para inserir o ID do modelo do Gate.AI.

Passo 4: Inserir o ID do modelo do Gate.AI

Este passo informa ao Cursor qual modelo suportado pelo Gate.AI deve processar as solicitações.

Ação: No Cursor, insira o ID do modelo do Gate.AI e clique em Adicionar. Use o formato provider/nome-do-modelo, por exemplo, deepseek/deepseek-v3.2. Segundo a documentação do Gate.AI, o ID do modelo deve ser obtido na loja de modelos e não deve usar auto na configuração.

De acordo com a documentação do Gate.AI (até junho de 2026), o ID do modelo deve seguir o formato provider/nome-do-modelo, sendo deepseek/deepseek-v3.2 um exemplo de ID suportado.

Passo 5: Inserir a chave API do Gate.AI e a URL base

Este passo conecta o campo de API compatível com OpenAI do Cursor ao Gate.AI.

Ação: Na seção Chave API, ative a opção Chave API do OpenAI e cole sua chave API do Gate.AI. Depois, ative Sobrescrever URL base do OpenAI e insira:

(insira aqui a URL base compatível com OpenAI fornecida pelo Gate.AI)

Segundo a documentação oficial do Gate.AI, essa URL deve ser compatível com OpenAI e o caminho correto é /openai/v1, não apenas /v1.

No Cursor, insira o ID do modelo do Gate.AI, a chave API e a URL base.

Passo 6: Selecionar o modelo do Gate.AI no Cursor Chat

Este passo garante que o Cursor possa usar o modelo do Gate.AI na troca de mensagens de código.

Ação: Feche as configurações do Cursor, abra o Cursor Chat, Composer, Agent ou outra interface de diálogo, e no seletor de modelos, escolha o modelo que você adicionou. Segundo a documentação do Gate.AI, o modelo adicionado estará disponível para seleção em Chat, Composer, Agent e outras interfaces de diálogo.

Você deve ver o nome do modelo configurado, como deepseek/deepseek-v3.2, na lista de modelos.

Após configurar, selecione o modelo do Gate.AI no seletor de modelos do Cursor e envie comandos.

Quais valores devem ser inseridos na configuração do gate.ai no Cursor?

| Campo do Cursor | Valor de entrada | Regras de configuração | | --------------------------- | -------------------------------------------------------------- | ------------------------------------------------- | | ID do modelo personalizado | Exemplo: deepseek/deepseek-v3.2 | Use o formato provider/nome-do-modelo, não auto. | | Chave API do OpenAI | Sua chave API do Gate.AI | Confirme que a chave está válida e copiada corretamente. | | URL base do OpenAI | (insira aqui a URL base compatível com OpenAI) | Use /openai/v1, não apenas /v1. | | Seletor de modelos | O modelo que você adicionou | Selecione antes de testar comandos. |

O ID do modelo e a URL base são os campos mais críticos na configuração do gate.ai no Cursor. Se o Cursor aceitar a chave, mas não roteirizar as solicitações, verifique primeiro o formato do ID do modelo e a URL base, antes de alterar outras configurações.

O que fazer se o gate.ai não funcionar no Cursor? Lista de verificação de problemas

• Situação: Cursor mostra erro 401 ou falha na conexão.

  • Causa: Chave API do Gate.AI inválida, expirada, revogada, desativada, copiada incorretamente ou saldo insuficiente.
  • Solução: Verifique o status da chave API do Gate.AI, copie novamente a chave, confirme saldo suficiente na conta. A documentação do Gate.AI indica que chaves inválidas ou saldo insuficiente são causas comuns de falha na autenticação ou solicitação.

• Situação: Cursor indica que o modelo não está disponível ou não foi encontrado.

  • Causa: Erro de digitação no ID do modelo, uso de formato errado, ou valor auto.
  • Solução: Copie o ID exato do modelo na lista do Gate.AI e use um ID específico como deepseek/deepseek-v3.2.

• Situação: Cursor retorna erro de caminho de API desconhecido ou 404.

  • Causa: URL base incorreta ou mal inserida.
  • Solução: Corrija a URL base para /openai/v1.

• Situação: Modelo personalizado não aparece no Cursor Chat.

  • Causa: Configuração do Cursor não foi salva ou a lista de modelos não foi atualizada.
  • Solução: Salve as configurações, feche e reabra o Cursor, e verifique novamente.

• Situação: Um modelo funciona, outro não.

  • Causa: O ID do modelo não corresponde exatamente ao do Gate.AI ou há restrições na conta ou na política de risco.
  • Solução: Confirme o formato do ID na documentação do Gate.AI e verifique restrições na conta.

Próximos passos: o que mais pode ser configurado ou desenvolvido?

Para integrações mais amplas, consulte o Guia de Integração da API do Gate.AI. Ele explica detalhadamente o papel da API na integração compatível com OpenAI.

Para referências de configuração, use a documentação oficial do Gate.AI. Para seleção de modelos, consulte a lista de modelos do Gate.AI. Se houver orçamento ou limites de uso, revise os preços do Gate.AI antes de usar em produção.

Perguntas frequentes

Posso usar auto como ID de modelo no Cursor?

Não. A documentação do Gate.AI indica que o Cursor deve usar IDs específicos de modelos do mercado, não auto.

Qual URL base do Gate.AI devo inserir no Cursor?

Use a URL compatível com OpenAI, como /openai/v1. A documentação reforça que o caminho correto é /openai/v1, não apenas /v1.

** Onde escolho o modelo do Gate.AI após a configuração?**

Abra o Cursor Chat, Composer, Agent ou outra interface de diálogo e selecione o modelo adicionado no seletor de modelos do Cursor.

** Por que a chave API funciona em outros lugares, mas não no Cursor?**

Possivelmente porque o Cursor está usando uma entrada de modelo não salva, URL base incorreta ou ID de modelo errado. Verifique novamente o ID do modelo, as chaves de API, o URL base e o seletor de modelos.