Ligar 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 faz uma pergunta, com as permissões do utilizador da chave. Só consulta: não altera nada no sistema.

Quando usar

Está a desenvolver uma integração ou um site e quer consultar os dados reais do estúdio sem sair do editor.
Usa o chat do Cursor no dia a dia e quer perguntar sobre o movimento do estúdio.

Antes de começar

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

Passo a passo

Passo 1 — Adicionar o conector

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

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

Passo 2 — Verificar a ligação

Nas definições do Cursor, abra a secção MCP. O conector heya deverá aparecer como ativo, com as ferramentas listar_areas, buscar_ferramentas e executar_consulta.

Passo 3 — Fazer uma pergunta

No chat do Cursor, faça uma pergunta, por exemplo: “quais clientes foram atendidos hoje no estúdio?”.

O que acontece depois

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

Erros comuns e dúvidas

Q: O conector aparece com um erro nas definições do Cursor. O que faço? A: Verifique se o endereço termina em /mcp e se a chave foi copiada por inteiro, incluindo Bearer e um espaço a seguir. Depois de editar o mcp.json, desligue e volte a ligar o conector nas definições do Cursor.

Q: Posso usar uma variável de ambiente em vez da chave? A: Algumas versões do Cursor não substituem a variável pelo respetivo valor no cabeçalho e enviam o texto literal. Se o conector não ligar com a variável, coloque a chave diretamente no ficheiro do seu utilizador.

Q: Posso colocar a configuração no .cursor/mcp.json do projeto? A: Evite fazê-lo: esse ficheiro costuma ser incluído no controlo de versões, o que deixaria a chave exposta. Use o ficheiro do seu utilizador (~/.cursor/mcp.json).

Q: O Cursor diz que a chave tem de ter “Permitir uso como conector de IA”. Porquê? A: A chave foi criada sem essa opção. Edite a chave no separador API Key e selecione Permitir utilização como conector de IA.

Q: O Cursor abriu um ecrã de início de sessão em vez de usar a chave. O que faço? A: Verifique se o bloco headers com a chave está no mcp.json. Com a chave certa, o sistema responde diretamente e não é necessário iniciar sessão. Se o Cursor insistir no início de sessão e este falhar, use a chave no Claude Code ou no Gemini CLI, ou contacte o apoio.

Q: O Cursor pode alterar dados do sistema através do conector? A: Não. O conector só consulta. As alterações são feitas no sistema.