Pular para o conteúdo principal

Configurar o cursor para Kanera MCP

O cursor se conecta ao Kanera através do Protocolo de Contexto do Modelo. O Cursor oferece suporte a servidores HTTP Streamable remotos com OAuth, para que você possa se conectar por meio de um navegador sem criar ou armazenar uma chave de API.

Instalação com um clique​

Com o Cursor instalado, abra este link para adicionar Kanera ao Cursor em uma única etapa:

Adicionar Kanera ao Cursor

O cursor mostra o servidor que está prestes a adicionar (https://mcp.kanera.app/mcp) e pede que você confirme. Em seguida, conclua o login no navegador descrito abaixo. Se o link não abrir o Cursor ou você auto-hospedar o Kanera, adicione a configuração manualmente. O Gerador de configuração MCP também cria o link para um endereço auto-hospedado.

Configuração manual​

Kanera mostra esta configuração, com seu endereço MCP preenchido, em Configurações de perfil -> Chaves de API -> Ou configure-o manualmente -> Cursor.

Adicione Kanera à configuração global do Cursor MCP em ~/.cursor/mcp.json, ou para .cursor/mcp.json em um projeto quando a conexão só deveria estar disponível lá:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp"
    }
  }
}

O cursor detecta que Kanera requer OAuth e pede para você se autenticar. No Cursor Agent, você pode iniciar o fluxo do navegador explicitamente:

cursor-agent mcp login kanera

Faça login no Kanera, revise o acesso solicitado e escolha Permitir acesso. Em seguida, verifique a conexão e as ferramentas disponíveis:

cursor-agent mcp list
cursor-agent mcp list-tools kanera

No editor Cursor, abra Configurações -> Ferramentas e MCP para inspecionar o servidor e suas ferramentas. Veja Conecte um agente de IA para escopos e desconectar um agente.

Instale a habilidade Kanera​

A conexão MCP dá ao Cursor acesso às ferramentas do Kanera. O opcional Habilidade do agente Kanera ensina-o a resolver nomes para IDs estáveis, ler o estado ativo antes de relatar ou alterar o trabalho, distinguir o trabalho concluído da atividade de criação, usar chaves de idempotência e lidar com falhas de permissão ou limite de taxa com segurança.

Instale a habilidade globalmente com o instalador aberto do Agent Skills:

npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global

Para uma instalação manual, baixe o arquivo completo kanera diretório de habilidades e coloque-o em um destes locais:

  • ~/.agents/skills/kanera/ ou ~/.cursor/skills/kanera/ para uma habilidade pessoal disponível em todos os projetos.
  • .agents/skills/kanera/ ou .cursor/skills/kanera/ em um repositório para compartilhar a habilidade com esse projeto.

Reinicie o Cursor se a habilidade não aparecer. O cursor pode carregá-lo automaticamente para solicitações relevantes ou você pode invocar /kanera explicitamente.

Exceção: conecte-se com uma chave de API​

Use OAuth sempre que puder Uma chave de API é um segredo de longa duração que você mesmo armazena e alterna, e o trabalho realizado com uma chave pessoal é registrado como você, sem o via <agente> rótulo. Use um somente quando o OAuth realmente não funcionar:
  • A versão do Cursor não pode concluir o fluxo OAuth remoto.
  • Você precisa de um servidor stdio local e não pode usar o Kanera CLI. kanera auth login faz login com OAuth e kanera mcp atende stdio com esse login, nenhuma chave é necessária.
  • A máquina não possui navegador para login. Experimente autorização do dispositivo primeiro se o seu cliente suportar.

Quando você usa uma chave, crie-a Somente leitura a menos que o agente precise alterar o trabalho e mantê-lo em uma variável de ambiente em vez de em um arquivo confirmado. :::

Leia a chave de uma variável de ambiente em vez de confirmá-la em uma configuração de projeto:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KANERA_API_KEY}"
      }
    }
  }
}

Definir KANERA_API_KEY no ambiente que inicia o Cursor. Crie uma chave pessoal em Configurações de perfil -> Chaves de API ou uma chave de espaço de trabalho Configurações do espaço de trabalho -> API.

Referência do cliente​