Conectar o Cursor ao seu estúdio

O que é

O Cursor é um editor com IA integrada. Com o conector de IA, o chat do Cursor consulta os dados do seu estúdio (vendas, clientes, agenda, financeiro) quando você pergunta, com as permissões do usuário da chave. Ele só consulta: não altera nada no sistema.

Quando usar

Você desenvolve uma integração ou um site e quer conferir os dados reais do estúdio sem sair do editor.
Você usa o chat do Cursor no dia a dia e quer perguntar sobre o movimento do estúdio.

Antes de começar

Tenha em mãos o endereço do conector e uma chave de API com “Permitir uso como conector de IA”, criados conforme o artigo Conector de IA.

Passo a passo

Passo 1 — Adicionar o conector

Abra (ou crie) o arquivo ~/.cursor/mcp.json e acrescente o trecho abaixo, trocando o endereço pelo que você copiou em Copiar endereço e hk_... pela sua chave:

{
  "mcpServers": {
    "heya": {
      "url": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Passo 2 — Conferir a conexão

Nas configurações do Cursor, abra a seção de MCP. O conector heya deve aparecer ativo, com as ferramentas listar_areas, buscar_ferramentas e executar_consulta.

Passo 3 — Perguntar

No chat do Cursor, pergunte, por exemplo: “quais clientes foram atendidos hoje no estúdio?”.

O que acontece depois

O Cursor busca a consulta certa para a pergunta, executa e responde com os números do sistema.
A chave aparece na aba API Key com o Último uso atualizado.
Para cortar o acesso, revogue a chave na aba API Key: o Cursor perde o acesso em até 30 segundos.

Erros comuns e dúvidas

P: O conector aparece com erro nas configurações do Cursor. O que faço? R: Confira se o endereço termina em /mcp e se a chave foi colada inteira, com Bearer e um espaço antes. Depois de editar o mcp.json, desligue e ligue o conector nas configurações do Cursor.

P: Posso usar uma variável de ambiente no lugar da chave? R: Algumas versões do Cursor não trocam a variável pelo valor no cabeçalho e mandam o texto literal. Se o conector não conectar com a variável, coloque a chave direto no arquivo do seu usuário.

P: Posso colocar a configuração no .cursor/mcp.json do projeto? R: Evite: esse arquivo costuma ir para o controle de versão, e a chave ficaria exposta. Use o arquivo do seu usuário (~/.cursor/mcp.json).

P: O Cursor diz que a chave precisa ter “Permitir uso como conector de IA”. Por quê? R: A chave foi criada sem essa opção. Edite a chave na aba API Key e marque Permitir uso como conector de IA.

P: O Cursor abriu uma tela de login em vez de usar a chave. O que faço? R: Confira se o bloco headers com a chave está no mcp.json. Com a chave certa, o sistema responde direto e o login não é necessário. Se o Cursor insistir no login e ele falhar, use a chave no Claude Code ou no Gemini CLI, ou fale com o suporte.

P: O Cursor pode alterar dados do sistema pelo conector? R: Não. O conector só consulta. Alterações são feitas no sistema.