Ferramentas de código

Cursor

Configure o TokenLab para modelos de chat suportados no Cursor, verifique a conexão e adicione MCP ou Skills separadamente

O que esta conexão faz

Use o TokenLab para solicitações de chat suportadas no editor desktop Cursor no macOS, Windows ou Linux. O Cursor documenta o suporte a BYOK (Bring Your Own Key) da OpenAI para modelos de chat padrão, sem raciocínio; o preenchimento de código (Tab completion) ainda utiliza os modelos do Cursor. Uma substituição da Base URL da OpenAI não transforma o Cursor em um cliente para todos os modelos ou protocolos do TokenLab. Veja os limites de chave de API do Cursor.

Se você precisa apenas de ferramentas de imagem, vídeo ou outras APIs do TokenLab, mantenha seu provedor de chat atual e adicione o MCP em vez disso. Uma Skill ensina ao agente como usar as APIs; ela não altera o provedor de chat.

Dê esta tarefa ao seu agente

Read https://tokenlab.sh/docs/pt/integrations/cursor and check my installed version and operating system.
Confirm whether I need TokenLab as the main model, MCP tools, or API Skills.
Preserve existing accounts, provider configuration, and permissions; explain how to restore changed settings.
Keep API keys local; do not ask me to paste them into chat. I will enter the key locally and perform required UI steps.
Explain the cost of a small verification request. Only after I explicitly choose that test, help run it and match the TokenLab request record.

Abra as configurações corretas

  1. Instale ou atualize o editor desktop a partir de Cursor Downloads. Este guia não configura o Cursor CLI ou Cloud Agents.
  2. Abra as Cursor Settings a partir da paleta de comandos ou pressione Cmd/Ctrl + Shift + J. Cmd/Ctrl + , abre as configurações gerais do editor.
  3. Abra Models e anote sua chave da OpenAI e a configuração da Base URL existentes para que você possa restaurá-las. Mantenha as configurações de outros provedores intactas.
  4. Em OpenAI API Key, insira sua chave do TokenLab localmente e salve-a. Não cole a chave em uma conversa com o agente nem a envie (commit) para um projeto.
  5. Habilite Override OpenAI Base URL e insira:
https://api.tokenlab.sh/v1

O Cursor envia solicitações BYOK através de seu backend para montagem de prompts; esta não é uma conexão direta do seu editor para o TokenLab.

Selecione um modelo suportado

Copie o ID exato do modelo a partir do catálogo do TokenLab atual e verifique se o Cursor o aceita através do caminho BYOK da OpenAI. Um modelo listado como chat no TokenLab não estabelece compatibilidade com o Cursor.

Para um teste de texto inicial, escolha um modelo sem raciocínio: seus detalhes não listam a capacidade reasoning e ele aceita openai_chat_completions. grok-4.20-non-reasoning é um exemplo; confirme se ele ainda está listado antes de usá-lo. Habilite a entrada existente em Models ou use Add model se ela estiver ausente, então selecione esse modelo exato no seletor de chat. Não duplique um modelo nativo com uma grafia diferente e não presuma que as entradas do Claude ou Gemini usam a substituição da OpenAI. A orientação sobre modelos personalizados do Cursor explica esses limites de roteamento.

Verifique uma pequena solicitação

Inicie um novo chat com o modelo selecionado e envie:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

Esta é uma solicitação de modelo faturável. Verifique tanto a resposta quanto o modelo, horário e status correspondentes em TokenLab Requests. Uma chave salva, um modelo visível ou uma resposta sem uma solicitação correspondente no TokenLab não confirmam esta rota.

Se falhar

  • O modelo está ausente ou rejeitado: verifique o ID exato e o suporte BYOK atual do Cursor. Use uma entrada nativa existente quando disponível; reiniciar o editor por si só não torna um modelo não suportado compatível.
  • A autenticação falha: reinsira a chave do TokenLab no campo da OpenAI e verifique a Base URL. Um erro de saldo ou cota é diferente de uma chave inválida; siga o erro retornado e a solicitação correspondente no TokenLab.
  • Nenhuma solicitação do TokenLab aparece: confirme o modelo selecionado e a substituição, então inspecione o erro do Cursor. O preenchimento de código (Tab completion) e outros recursos gerenciados pelo Cursor não são um teste de conexão.
  • Outro provedor para de funcionar: restaure as configurações anteriores da OpenAI ou desabilite a substituição, então inicie um novo chat. Evite alterar chaves de provedores não relacionados para reparar esta rota.

Gere imagens e vídeos no mesmo agente

O Cursor também pode criar imagens e vídeos curtos com o servidor MCP do TokenLab. Cada geração é paga a partir do mesmo saldo do TokenLab. O MCP não substitui o modelo de chat principal. Salve isto como ~/.cursor/mcp.json ou mescle a entrada tokenlab no seu arquivo existente:

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
      }
    }
  }
}

Substitua <TOKENLAB_API_KEY> pela sua chave no seu próprio computador e não envie este arquivo para controle de versão. Verifique se tokenlab está habilitado nas configurações de MCP do Cursor. Em seguida, tente:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video retorna um ID de tarefa. O agente chama get_task_status até que o vídeo esteja pronto.

Adicione instruções de API separadamente

As TokenLab Skills fornecem instruções de API. Para uma instalação local no projeto, mantenha o diretório completo da Skill em .cursor/skills/tokenlab-api-integration/, incluindo SKILL.md e seus arquivos referenciados. Verifique Customize → Skills para descoberta. As Skills não fornecem uma chave nem instalam um servidor MCP. Veja os guias oficiais de MCP e Skills para a sua versão do Cursor.

Nesta página