Cursor

EscopoCopy Anchor Link

Este guia se aplica ao editor Cursor para desktop no macOS, Windows e Linux. O suporte oficial a OpenAI BYOK abrange modelos de chat padrão sem raciocínio; a conclusão Tab continua usando modelos do Cursor. Alterar a OpenAI Base URL não habilita todos os modelos do TokenLab nem todos os recursos do Cursor. Veja os limites oficiais.

Se precisar apenas de ferramentas de imagem, vídeo ou outras APIs, mantenha seu provedor de chat e adicione MCP. Um Skill fornece instruções sem trocar o modelo principal.

Tarefa para seu agente atualCopy Anchor Link

Leia https://tokenlab.sh/docs/pt/integrations/cursor e confira minha versão instalada e meu sistema operacional.
Confirme se preciso do TokenLab como modelo principal, ferramentas MCP ou um Skill de API.
Preserve contas, configurações dos provedores e permissões; explique como restaurar as alterações.
Não peça chaves de API no chat. Eu as inserirei localmente e farei as etapas necessárias na interface.
Explique o custo de uma pequena requisição de verificação. Só após minha escolha explícita desse teste, ajude a executá-lo e a conferir seu registro no TokenLab.

Abra as configurações corretasCopy Anchor Link

1. Instale ou atualize o editor em Cursor Downloads. Este guia não configura CLI nem Cloud Agents.
2. Abra Cursor Settings pela paleta de comandos ou com Cmd/Ctrl + Shift + J. Cmd/Ctrl + , abre as configurações gerais do editor.
3. Em Models, anote a configuração OpenAI atual para poder restaurá-la. Preserve os outros provedores.
4. Insira e salve sua chave TokenLab localmente em OpenAI API Key. Não a envie no chat nem a inclua em commits.
5. Ative Override OpenAI Base URL e informe:

https://api.tokenlab.sh/v1

As requisições BYOK também passam pelos servidores do Cursor para montar o prompt. O editor não se conecta diretamente ao TokenLab.

Escolha um modeloCopy Anchor Link

Copie o ID exato do catálogo atual do TokenLab e confirme o suporte no OpenAI BYOK do Cursor. A categoria chat no TokenLab não comprova essa compatibilidade.

Para o primeiro teste de texto, gpt-4.1-mini é um exemplo sem raciocínio, caso ainda esteja disponível. Ative a entrada existente em Models ou use Add model se ela não existir, e selecione-a no chat. Não duplique modelos integrados com outra grafia nem suponha que Claude ou Gemini usem o override OpenAI. Veja a orientação do Cursor.

Verifique uma pequena requisiçãoCopy Anchor Link

Crie um novo chat com o modelo escolhido e envie:

Responda apenas TOKENLAB_CONNECTION_OK. Não use ferramentas nem altere arquivos.

Essa requisição é cobrada. Confira a resposta e o modelo, horário e status nas requisições do TokenLab. Um modelo visível ou uma resposta sem registro correspondente não confirma esse caminho.

Se houver falhaCopy Anchor Link

• Modelo ausente ou recusado: confira o ID e o suporte BYOK; use a entrada integrada quando existir. Reiniciar não resolve incompatibilidade.
• Erro de autenticação: confira a chave TokenLab no campo OpenAI e a Base URL. Erros de saldo ou cota são diferentes de uma chave inválida.
• Sem registro no TokenLab: confira o modelo do chat, o override e o erro do Cursor. A conclusão Tab não testa essa conexão.
• Outro provedor parou: restaure a configuração OpenAI anterior ou desative o override e abra um novo chat.

Adicione MCP e Skills separadamenteCopy Anchor Link

MCP adiciona ferramentas pelas configurações MCP do Cursor ou por .cursor/mcp.json. Verifique a descoberta primeiro e só depois execute as gerações pagas desejadas. MCP não substitui o modelo principal.

Skills fornecem instruções de API. Coloque a pasta completa com SKILL.md e referências em .cursor/skills/tokenlab-api-integration/ e confira Customize → Skills. Um Skill não fornece chave nem instala servidor MCP. Consulte os guias oficiais de MCP e Skills para sua versão.