Configurando o Servidor MCP do Codehabits no Cursor (5 Minutos)
O servidor Codehabits MCP fornece ao Cursor seis ferramentas que leem de .codehabits/ em seu repositório — pesquisa de convenções, validação de código, conhecimento de domínio, sugestões de revisores e um ciclo de feedback para atualização de convenções.
A configuração leva cerca de cinco minutos se você já executou codehabits enable.
Pré-requisitos
- Node.js 20+
-
.codehabits/meta.jsonem seu repositório (a partir denpx @codehabits/cli enable) - Cursor com suporte a MCP habilitado
Se você ainda não tem arquivos de inteligência, execute o enable primeiro — veja o quickstart.
Passo 1: Instalar o servidor MCP
Do diretório raiz do seu repositório:
npx @codehabits/cli mcp-install
Isso grava em .cursor/mcp.json. Faça o commit para que os colegas de equipe tenham a mesma configuração:
git add .cursor/mcp.json
git commit -m "chore: adicionar servidor Codehabits MCP"
git push
Passo 2: Reiniciar o Cursor
Os servidores MCP carregam na inicialização. Saia completamente e reabra o Cursor (ou recarregue a janela) antes de testar as ferramentas.
Passo 3: Verificar se as ferramentas aparecem
Abra o Cursor Agent e verifique se o servidor codehabits MCP está conectado. Você deve ver estas ferramentas:
| Ferramenta | Propósito |
|---|---|
get_team_context |
Convenções e anti-padrões |
check_code |
Validar um trecho contra as regras da equipe |
get_knowledge |
Conhecimento de domínio por tópico |
suggest_reviewers |
Roteamento de revisores baseado em expertise |
record_feedback / approve_proposal
|
Propor e mesclar atualizações de convenções |
Referência completa: documentação do servidor MCP.
Passo 4: Usar na prática
Tente estes comandos no Cursor Agent:
- "Use get_team_context para o escopo da API antes de escrever este endpoint."
- "Execute check_code neste manipulador antes de eu fazer o commit."
- "Quem deve revisar as alterações nos arquivos sob src/auth/? Use suggest_reviewers."
MCP vs Habilidades do Agente
Habilidades do Agente carregam passivamente quando o Cursor inicia uma tarefa. As ferramentas MCP são pesquisas explícitas — use-as quando precisar de validação ou conhecimento durante a tarefa.
A maioria das equipes habilita ambas: habilidades para contexto básico, MCP para verificações ativas.
Integração com um comando
A página codehabits.dev/agents tem um comando de bootstrap que executa enable, mcp-install e lê seus arquivos de inteligência em uma única ação. Cole-o ao integrar um novo repositório ou colega de equipe.
Solução de problemas
Se as ferramentas retornarem "Nenhum dado de inteligência disponível," confirme que .codehabits/ existe e que o diretório de trabalho do servidor MCP é a raiz do seu repositório. Execute codehabits enable se arquivos estiverem faltando.
Correções comuns:
| Sintoma | Correção |
|---|---|
| Servidor não listado | Reinicie o Cursor após editar mcp.json
|
| Convenções erradas | Verifique se o cwd do MCP é a raiz do repositório, não uma subpasta |
| Regras desatualizadas | Execute npx @codehabits/cli sync
|
O que é Codehabits?
Codehabits extrai convenções de codificação da equipe a partir do histórico de PR do GitHub e as entrega a ferramentas de IA via Habilidades do Agente e MCP — para que toda a sua equipe compartilhe os mesmos padrões baseados em evidências, e não arquivos de regras mantidos manualmente.
Publicado originalmente em codehabits.dev.
O artigo apresenta uma configuração prática que pode ser útil para equipes de desenvolvimento no Brasil. A implementação do servidor MCP pode melhorar a colaboração e a padronização de convenções de código entre os membros da equipe.
