O servidor MCP é o motor que permite à sua IA agir como um engenheiro sênior que conhece cada detalhe do seu projeto na Brabrix.
Estas ferramentas permitem que a IA entenda o cenário atual do projeto e do workspace.
Descrição: Lê o arquivo .brabrix/config.json local.
Uso: Permite que a IA saiba automaticamente em qual projectId e taskId ela deve focar sem você precisar digitar.
Parâmetros: projectId? (string)
Retorno: Nome do projeto, cliente, stack tecnológica e objetivo principal.
Parâmetros: projectId?, taskId?
Descrição: A ferramenta mais poderosa para o desenvolvedor. Retorna um bundle contendo Projeto + Task + Spec + Docs relacionados.
Documentação técnica viva acessível por comandos.
| Tool | Parâmetros | O que a IA recebe |
|---|---|---|
brabrix_get_task_spec |
taskId |
Markdown completo com regras técnicas, diagramas e detalhes de implementação da tarefa. |
brabrix_get_prd |
projectId? |
Documento de Requisitos de Produto (Visão de Negócio). |
brabrix_get_technical_spec |
projectId? |
Especificação técnica global (Arquitetura, Padrões, DB). |
brabrix_get_backlog |
status?, type? |
Lista de itens filtrada por tipo (Task, Bug, Story) ou status. |
brabrix_get_board |
projectId? |
Resumo do board Kanban (Itens em TODO, IN_PROGRESS, DONE). |
Ferramentas exclusivas para acelerar o ciclo de desenvolvimento e garantir qualidade.
Ação: Gera branchName e commitMessage.
Lógica: Normaliza o título da tarefa para o padrão git (ex: feat/TASK-123-api-auth) e cria uma mensagem seguindo Conventional Commits.
Ação: Injeta um "Super-Prompt" de revisão.
Lógica: Cruza os Critérios de Aceite da Task com a Implementation Spec e pede para a IA fazer um self-check de compliance.
BRABRIX_MCP_ENABLE_WRITE_TOOLS=true nas variáveis de ambiente.
Inputs: taskId, status (Enum), comment?
Uso: "Mova a tarefa para DONE e adicione o comentário: 'Finalizado conforme spec'."
Inputs: taskId, comment
Uso: Registrar logs de progresso ou dúvidas diretamente na plataforma Brabrix.
Diferente das ferramentas, os Resources são "URLs" que a IA pode ler como se fossem arquivos locais.
brabrix://project/prd — O Documento de Requisitos de Produto.brabrix://project/tech-spec — A Especificação Técnica Global do Projeto.Copie e cole estes prompts no seu agente de IA (Gemini, Claude, Cursor) para extrair o máximo do contexto via MCP:
1. Onboarding de Tarefa (O Essencial):
2. Refinamento de Arquitetura:
3. Estimativa e Quebra (Breakdown):
4. Geração de Boilerplate Alinhado:
5. Resolução de Dúvidas de Negócio:
6. Contexto de Múltiplos Arquivos:
7. Quality Assurance (Self-Check):
8. Testes Orientados a Comportamento:
9. Geração de Git Metadata (Padronizado):
10. Atualização de Status:
11. Relatório de Progresso (Daily):
12. Análise de Dívida Técnica:
13. Refatoração Guiada pela Spec:
14. Geração de Documentação Local:
15. Triagem de Bug de Produção:
16. Mapeamento de Impacto (Risco):
17. Preparação para Pull Request (PR):
18. Sugestão de Comentário para o Time:
19. Geração de Change Log (Release Notes):
20. Brainstorming de Soluções:
21. Simulação de Cenário (What-If):
Como configurar o MCP da Brabrix nos editores de código mais populares.
O Cursor tem suporte nativo a MCP, o que o torna a melhor experiência para usar o Brabrix Dev.
brabrixstdionode /CAMINHO/ABSOLUTO/apps/brabrix-mcp-server/dist/index.jsAgora, no chat do Cursor, basta mencionar @brabrix ou simplesmente pedir para ele ler o backlog.
O Copilot no VS Code ainda não suporta MCP nativamente em todas as versões, mas você pode usar o **Copilot Extension SDK** ou uma bridge.
A forma mais eficiente hoje é via Custom Instructions:
copilot-mcp para criar a ponte.claude mcp add brabrix -- node /path/to/dist/index.js
Adicione ao arquivo ~/.gemini/settings.json na chave mcpServers o path para o servidor e suas credenciais.
No arquivo ~/.codex/config.json, adicione a configuração na chave mcp:
{
"mcp": {
"servers": {
"brabrix": {
"command": "node",
"args": ["/path/to/dist/index.js"],
"env": { "BRABRIX_TOKEN": "..." }
}
}
}
}
Descubra cada funcionalidade, atalho e configuração secreta da extensão que transforma o VS Code em uma plataforma de engenharia autônoma.
Ao clicar no ícone da Brabrix na Activity Bar, você encontra três painéis projetados para diferentes estágios do desenvolvimento:
Gerencie seus workspaces. Aqui você pode:
.brabrix/context/).A visão estrutural do seu produto. Suporta uma hierarquia complexa: EPIC > FEATURE > USER_STORY > TASK / BUG.
Foco na execução diária. Agrupa as tarefas ativas pelos status: TODO, READY, IN_PROGRESS, IN_REVIEW e DONE. Clique em Atualizar Status (Ícone de Play) para mover os cards pelo fluxo.
A Brabrix injeta "magias" contextuais em diferentes partes do editor. Veja a lista exaustiva do que você pode fazer clicando com o botão direito:
AGENTS.md) para a equipe e outras IAs seguirem.DONE na Brabrix, pede à IA para escrever uma mensagem de Conventional Commit com base nas suas alterações, e faz o commit no git local.A extensão não apenas gera prompts, ela orquestra Agentes de Linha de Comando (CLI) diretamente em um terminal integrado do VS Code.
No menu da tarefa, após gerar o prompt, você pode enviar o contexto inteiro com apenas um clique para:
gemini-cli. Excelente para mapeamento de arquitetura complexa e features inteiras.claude-code (da Anthropic). O melhor para refatoração cirúrgica e edição precisa de múltiplos arquivos.Você também tem a opção "Executar prompt em CLI local" que usará o agente padrão definido nas configurações.
Se você usa o Cursor, Claude Desktop ou o próprio Gemini CLI com suporte a Model Context Protocol (MCP), a extensão facilita o setup:
claude mcp add ... pronto para colar e executar no terminal.Acesse File > Preferences > Settings (ou digite Ctrl+,) e procure por "Brabrix" para customizar sua experiência:
| Chave da Configuração | O que faz (Valor Padrão) |
|---|---|
brabrix.docsFolder |
Define a pasta onde os artefatos locais (PRDs, Backlog) são salvos (Default: .brabrix). Recomendado adicionar ao .gitignore. |
brabrix.agent.defaultCli |
Qual agente usar quando você clica em "Executar prompt em CLI local" (Opções: gemini, claude, codex, custom). |
brabrix.agent.executionProfile |
Define como a Brabrix orienta o CLI local a executar o prompt: - plan (Padrão): A IA deve analisar e sugerir um plano antes de alterar arquivos.- edit: Permite que a IA altere arquivos livremente.- safe: Apenas gera ou copia o prompt, não executa no terminal.- manual: Força a IA a retornar blocos de código para você aplicar manualmente.
|
brabrix.agent.executionMode |
askBeforeRun (Escreve o comando no terminal e espera você apertar ENTER) ou copyOnly (Apenas copia o comando de execução para o clipboard). |
brabrix.agent.terminalName |
Nome da aba do terminal integrado que a Brabrix criará/usará (Default: "Brabrix Dev Agent"). |
brabrix.agent.*Command |
Permite customização livre dos comandos shell para cada IA. Exemplo do Gemini: gemini < "{promptFile}". |
brabrix.apiBaseUrl |
URL da API da Brabrix (Padrão Cloud). Altere caso esteja rodando uma versão Enterprise local. |
Pressione Ctrl+Shift+P (ou Cmd+Shift+P) e digite "Brabrix":
Brabrix: Login / Logout — Autentica ou desconecta seu ambiente do servidor web.Brabrix: Vincular workspace ao projeto — Faz a ponte entre seu código local e a nuvem.Brabrix: Desvincular workspace — Quebra o vínculo com o projeto atual.Brabrix: Sincronizar contexto do projeto — Força a atualização dos documentos Markdown.Brabrix: Selecionar tarefa atual — Define no contexto (para MCP e Prompts) em qual card você está trabalhando neste exato momento.Brabrix: Ver status de sincronização — Mostra quando o contexto foi baixado pela última vez.