Zen MCP

Um servidor com inteligência artificial que fornece acesso a múltiplos modelos para análise de código, resolução de problemas e desenvolvimento colaborativo com fluxos de trabalho guiados.

GitHub
41
Experimente este MCPPatrocinado

Documentação

Zen MCP: Muitos Fluxos de Trabalho. Um Contexto.

zen_web.webm

🤖 Claude OU Gemini CLI + [Gemini / OpenAI / Grok / OpenRouter / DIAL / Ollama / Qualquer Modelo] = Sua Equipe Definitiva de Desenvolvimento de IA

Os parceiros de desenvolvimento definitivos para seu Agente de Codificação favorito (Claude OU Gemini CLI) - um servidor Model Context Protocol que dá acesso a múltiplos modelos de IA para análise de código aprimorada, resolução de problemas e desenvolvimento colaborativo.

Apresenta verdadeira orquestração de IA com conversas que continuam entre fluxos de trabalho - Dê a Claude um fluxo de trabalho complexo e deixe-o orquestrar entre modelos automaticamente. Claude mantém o controle, realiza o trabalho real, mas obtém perspectivas da melhor IA para cada subtarefa. Com ferramentas como planner para dividir projetos complexos, analyze para entender bases de código, codereview para auditorias, refactor para melhorar a estrutura do código, debug para resolver problemas complexos e precommit para validar alterações, Claude pode alternar entre diferentes ferramentas e modelos no meio da conversa, com o contexto sendo transportado perfeitamente.

Exemplo de Fluxo de Trabalho - Claude Code:

  1. Perform a codereview using gemini pro and o3 and use planner to generate a detailed plan, implement the fixes and do a final precommit check by continuing from the previous codereview
  2. Isso aciona um fluxo de trabalho de codereview onde Claude percorre o código, procurando todos os tipos de problemas
  3. Após múltiplas passagens, coleta o código relevante e anota os problemas ao longo do caminho
  4. Mantém um nível de confidence entre exploring, low, medium, high e certain para rastrear com que confiança conseguiu encontrar e identificar problemas
  5. Gera uma lista detalhada de problemas críticos -> baixos
  6. Compartilha os arquivos relevantes, descobertas, etc. com Gemini Pro para realizar uma análise aprofundada para uma segunda codereview
  7. Volta com uma resposta e em seguida faz o mesmo com o3, adicionando ao prompt se uma nova descoberta vier à tona
  8. Quando termina, Claude recebe todo o feedback e combina uma única lista de todos os problemas críticos -> baixos, incluindo bons padrões no seu código. A lista final inclui novas descobertas ou revisões caso Claude tenha entendido mal ou perdido algo crucial e um dos outros modelos tenha apontado isso
  9. Em seguida, usa o fluxo de trabalho planner para dividir o trabalho em etapas mais simples se uma grande refatoração for necessária
  10. Claude então realiza o trabalho real de corrigir os problemas destacados
  11. Quando termina, Claude retorna à Gemini Pro para uma revisão de precommit

Tudo dentro de uma única thread de conversa! A Gemini Pro na etapa 11 sabe o que foi recomendado pela O3 na etapa 7! Levando esse contexto e essa revisão em consideração para auxiliar em sua revisão final pré-commit.

Pense nisso como Claude Code para Claude Code. Este MCP não é mágica. É apenas super-cola.

Lembre-se: Claude mantém controle total — mas VOCÊ dá as ordens. Zen foi projetado para fazer Claude acionar outros modelos apenas quando necessário — e para dar continuidade com idas e vindas significativas. É você quem cria o prompt poderoso que faz Claude trazer Gemini, Flash, O3 — ou voar solo. Você é o guia. O criador de prompts. O manipulador.

Você é a IA - Realmente Inteligente.

Porque esses modelos de IA claramente não são quando ficam tagarelas →

Navegação Rápida

Por que Este Servidor?

Claude é brilhante, mas às vezes você precisa de:

  • Fluxos de trabalho guiados - Processos centrados no desenvolvedor que impõem investigação sistemática, prevenindo análises apressadas ao garantir que Claude examine o código minuciosamente em cada fase (debug, precommit, refactor, analyze, codereview)
  • Múltiplas perspectivas de IA - Deixe Claude orquestrar entre diferentes modelos para obter a melhor análise
  • Seleção automática de modelo - Claude escolhe o modelo certo para cada tarefa (ou você pode especificar)
  • Um parceiro desenvolvedor sênior para validar e expandir ideias (chat)
  • Uma segunda opinião em decisões arquiteturais complexas - aumente o pensamento de Claude com perspectivas da Gemini Pro, O3, ou dezenas de outros modelos via endpoints personalizados (thinkdeep)
  • Obtenha múltiplas opiniões de especialistas - Faça diferentes modelos de IA debaterem suas ideias (alguns apoiando, outros criticando) para ajudá-lo a tomar melhores decisões (consensus)
  • Revisões de código profissionais com feedback acionável em repositórios inteiros (codereview)
  • Validação pré-commit com análise profunda usando o melhor modelo para a tarefa (precommit)
  • Depuração especializada - O3 para problemas lógicos, Gemini para problemas arquiteturais (debug)
  • Janelas de contexto estendidas além dos limites do Claude - Delegue análise à Gemini (1M de tokens) ou O3 (200K de tokens) para bases de código inteiras, grandes conjuntos de dados ou documentação abrangente
  • Pontos fortes específicos de cada modelo - Pensamento estendido com Gemini Pro, iteração rápida com Flash, raciocínio forte com O3, privacidade local com Ollama
  • Suporte a modelos locais - Execute modelos como Llama 3.2 localmente via Ollama, vLLM ou LM Studio para privacidade e controle de custos
  • Colaboração dinâmica - Modelos podem solicitar contexto adicional e respostas de acompanhamento de Claude no meio da análise
  • Manipulação inteligente de arquivos - Expande diretórios automaticamente, gerencia limites de tokens com base na capacidade do modelo
  • Suporte a visão - Analise imagens, diagramas, capturas de tela e conteúdo visual com modelos com capacidade de visão
  • Ignore os limites de tokens do MCP - Contorne o limite de 25K do MCP automaticamente
  • Revivificação de contexto entre sessões - Continue conversas mesmo após o contexto de Claude ser redefinido, com outros modelos mantendo o histórico completo

Dica de Especialista: Revivificação de Contexto

Este é um recurso extremamente poderoso que não pode ser destacado o suficiente:

O efeito colateral mais incrível deste sistema de continuação de conversa é que mesmo DEPOIS que o contexto de Claude é redefinido ou compactado, como as informações de continuação são mantidas na memória do MCP, você pode pedir que ele continue discutindo o plano com o3, e ele reviverá Claude de repente, porque O3 saberia do que estava sendo falado e transmitiria isso de volta de uma forma que reacende o entendimento de Claude. Tudo isso sem desperdiçar contexto pedindo que Claude ingira novamente documentos / código extensos e sem re-prompting para se comunicar com outro modelo. Zen gerencia isso internamente. A resposta do modelo revive Claude com melhor contexto sobre a discussão do que um resumo automático jamais conseguiria.

📖 Leia o mergulho técnico completo sobre como este sistema revolucionário funciona

Este servidor orquestra múltiplos modelos de IA como sua equipe de desenvolvimento, com Claude selecionando automaticamente o melhor modelo para cada tarefa ou permitindo que você escolha modelos específicos para diferentes pontos fortes.

Prompt Utilizado:

Study the code properly, think deeply about what this does and then see if there's any room for improvement in
terms of performance optimizations, brainstorm with gemini on this to get feedback and then confirm any change by
first adding a unit test with `measure` and measuring current code and then implementing the optimization and
measuring again to ensure it improved, then share results. Check with gemini in between as you make tweaks.

A implementação final resultou em uma melhoria de 26% no desempenho de análise JSON para a biblioteca selecionada, reduzindo o tempo de processamento por meio de otimizações colaborativas direcionadas, guiadas pela análise da Gemini e pelo refinamento do Claude.

Início Rápido (5 minutos)

Pré-requisitos

  • Python 3.10+ (3.12 recomendado)
  • Git
  • Usuários Windows: WSL2 é necessário para o Claude Code CLI

1. Obtenha Chaves de API (pelo menos uma é necessária)

Opção A: OpenRouter (Acesse múltiplos modelos com uma única API)

Opção B: APIs Nativas

  • Gemini: Visite Google AI Studio e gere uma chave de API. Para melhores resultados com Gemini 2.5 Pro, use uma chave de API paga, pois o nível gratuito tem acesso limitado aos modelos mais recentes.
  • OpenAI: Visite Plataforma OpenAI para obter uma chave de API para acesso ao modelo O3.
  • X.AI: Visite Console X.AI para obter uma chave de API para acesso ao modelo GROK.
  • DIAL: Visite Plataforma DIAL para obter uma chave de API para acessar múltiplos modelos através de sua API unificada. DIAL é uma plataforma de orquestração de IA de código aberto que fornece acesso agnóstico de fornecedor a modelos de grandes provedores, da comunidade de código aberto e de implantações auto-hospedadas. Documentação da API

Opção C: Endpoints de API Personalizados (modelos locais como Ollama, vLLM) Consulte o guia de configuração. Com uma API personalizada, você pode usar:

  • Ollama: Execute modelos como Llama 3.2 localmente para inferência gratuita
  • vLLM: Servidor de inferência auto-hospedado para inferência de alto rendimento
  • LM Studio: Hospedagem local de modelos com interface de API compatível com OpenAI
  • Text Generation WebUI: Interface local popular para executar modelos
  • Qualquer API compatível com OpenAI: Endpoints personalizados para sua própria infraestrutura

Nota: Usar múltiplas opções de provedores pode criar ambiguidade sobre qual provedor / modelo usar se houver sobreposição. Se todas as APIs estiverem configuradas, as APIs nativas terão prioridade quando houver conflito no nome do modelo, como para gemini e o3. Configure seus aliases de modelo e dê a eles nomes exclusivos em conf/custom_models.json

2. Escolha Seu Método de Instalação

Opção A: Instalação Rápida com uvx

Pré-requisitos: Instale uv primeiro (necessário para uvx)

Configuração do Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "zen": {
      "command": "sh",
      "args": [
        "-c",
        "exec $(which uvx || echo uvx) --from git+https://github.com/BeehiveInnovations/zen-mcp-server.git zen-mcp-server"
      ],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin:~/.local/bin",
        "OPENAI_API_KEY": "your_api_key_here"
      }
    }
  }
}
Configuração do Claude Code CLI Crie um arquivo `.mcp.json` na raiz do seu projeto para [configuração no escopo do projeto](https://docs.anthropic.com/en/docs/claude-code/mcp#project-scope): ```json { "mcpServers": { "zen": { "command": "sh", "args": [ "-c", "exec $(which uvx || echo uvx) --from git+https://github.com/BeehiveInnovations/zen-mcp-server.git zen-mcp-server" ], "env": { "PATH": "/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin:~/.local/bin", "OPENAI_API_KEY": "your_api_key_here" } } } } ```
Configuração do Gemini CLI

Edite ~/.gemini/settings.json e adicione:

{
  "mcpServers": {
    "zen": {
      "command": "sh",
      "args": [
        "-c",
        "exec $(which uvx || echo uvx) --from git+https://github.com/BeehiveInnovations/zen-mcp-server.git zen-mcp-server"
      ],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin:~/.local/bin",
        "OPENAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Nota: Embora o servidor Zen MCP se conecte com sucesso ao Gemini CLI, a invocação de ferramentas ainda não está funcionando corretamente. Veja Configuração do Gemini CLI para atualizações.

O que isso faz:

  • Nenhuma configuração necessária - o uvx cuida de tudo automaticamente
  • Sempre atualizado - Baixa a versão mais recente a cada execução
  • Sem dependências locais - Funciona sem configuração de ambiente Python
  • Disponibilidade imediata - Pronto para uso imediatamente

Opção B: Clonagem e Configuração Tradicionais

# Clone to your preferred location
git clone https://github.com/BeehiveInnovations/zen-mcp-server.git
cd zen-mcp-server

# One-command setup installs Zen in Claude
./run-server.sh

# Or for Windows users using PowerShell:
./run-server.ps1

# To view MCP configuration for Claude
./run-server.sh -c

# PowerShell:
./run-server.ps1 -Config

# See help for more
./run-server.sh --help

# PowerShell:
./run-server.ps1 -Help

O que isso faz:

  • Configura tudo automaticamente - ambiente Python, dependências, configuração
  • Configura integrações do Claude - Adiciona ao Claude Code CLI e orienta a configuração Desktop
  • Pronto para uso imediato - Nenhuma configuração manual necessária
  • Também funciona com Gemini CLI - Veja Configuração do Gemini CLI para configuração

Após atualizações: Sempre execute ./run-server.sh novamente após git pull para garantir que tudo permaneça atualizado.

Usuários Windows: Usando WSL? Veja o Guia de Configuração do WSL para instruções detalhadas.

3. Adicione Suas Chaves de API

# Edit .env to add your API keys (if not already set in environment)
nano .env

# The file will contain, at least one should be set:
# GEMINI_API_KEY=your-gemini-api-key-here  # For Gemini models
# OPENAI_API_KEY=your-openai-api-key-here  # For O3 model
# OPENROUTER_API_KEY=your-openrouter-key  # For OpenRouter (see docs/custom_models.md)
# DIAL_API_KEY=your-dial-api-key-here      # For DIAL platform

# For DIAL (optional configuration):
# DIAL_API_HOST=https://core.dialx.ai      # Default DIAL host (optional)
# DIAL_API_VERSION=2024-12-01-preview      # API version (optional)
# DIAL_ALLOWED_MODELS=o3,gemini-2.5-pro    # Restrict to specific models (optional)

# For local models (Ollama, vLLM, etc.):
# CUSTOM_API_URL=http://localhost:11434/v1  # Ollama example
# CUSTOM_API_KEY=                                      # Empty for Ollama
# CUSTOM_MODEL_NAME=llama3.2                          # Default model

# Note: At least one API key OR custom URL is required

Nenhuma reinicialização necessária: O servidor lê o arquivo .env toda vez que o Claude chama uma ferramenta, então as alterações são aplicadas imediatamente.

Próximo passo: Agora execute claude a partir da pasta do seu projeto usando o terminal para conectá-lo ao novo servidor MCP adicionado. Se você já estava executando uma sessão de código claude, saia e inicie uma nova sessão.

Se Configurando para o Claude Desktop

Precisa da configuração exata? Execute ./run-server.sh -c para exibir instruções de configuração específicas da plataforma com os caminhos corretos.

  1. Abra a configuração do Claude Desktop: Settings → Developer → Edit Config
  2. Copie a configuração mostrada por ./run-server.sh -c para o seu claude_desktop_config.json
  3. Reinicie o Claude Desktop para que as alterações tenham efeito

4. Comece a Usar!

Basta perguntar ao Claude naturalmente:

  • "Pense mais profundamente sobre este design de arquitetura com zen" → O Claude escolhe o melhor modelo + thinkdeep
  • "Usando zen, faça uma revisão de código deste código para problemas de segurança" → O Claude pode escolher o Gemini Pro + codereview
  • "Use zen e depure por que este teste está falhando, o bug pode estar em my_class.swift" → O Claude pode escolher O3 + debug
  • "Com zen, analise estes arquivos para entender o fluxo de dados" → O Claude escolhe o modelo apropriado + analyze
  • "Use flash para sugerir como formatar este código com base nas especificações mencionadas em policy.md" → Usa o Gemini Flash especificamente
  • "Pense profundamente sobre isso e use o o3 para depurar este erro de lógica que encontrei na função checkOrders()" → Usa o O3 especificamente
  • "Faça um brainstorming de estratégias de escalabilidade com pro. Estude o código, escolha sua estratégia preferida e debata com pro para decidir as duas melhores abordagens" → Usa o Gemini Pro especificamente
  • "Use local-llama para localizar e adicionar traduções ausentes a este projeto" → Usa o Llama 3.2 local via URL personalizado
  • "Primeiro use local-llama para uma análise local rápida, depois use opus para uma revisão de segurança completa" → Usa ambos os provedores em sequência

Ferramentas Disponíveis

Estas não são apenas ferramentas — são como você faz o Claude pensar como um desenvolvedor real. Em vez de se apressar para responder com análises superficiais ou insights rasos, esses fluxos de trabalho fazem o Claude pausar, mergulhar no seu código e raciocinar através de problemas passo a passo.

É a diferença entre um palpite apressado e um segundo par de olhos focado que realmente entende seu código. Experimente-os e sinta a diferença.

Guia Rápido de Seleção de Ferramentas:

  • Precisa de um parceiro de pensamento? → chat (fazer brainstorming de ideias, obter segundas opiniões, validar abordagens)
  • Precisa de um pensamento mais profundo? → thinkdeep (estende a análise, encontra casos extremos)
  • Quer evitar respostas "Você está absolutamente certo!"? → challenge (desafia suposições, incentiva reavaliação cuidadosa)
  • Precisa dividir projetos complexos? → planner (planejamento passo a passo, estrutura de projeto, divisão de ideias complexas)
  • Precisa de múltiplas perspectivas? → consensus (obter opiniões diversas de especialistas sobre propostas e decisões)
  • O código precisa de revisão? → codereview (bugs, segurança, problemas de desempenho)
  • Validação antes do commit? → precommit (validar alterações git antes de commitar)
  • Algo está quebrado? → debug (investigação sistemática, análise de causa raiz passo a passo)
  • Quer entender o código? → analyze (arquitetura, padrões, dependências)
  • O código precisa ser refatorado? → refactor (refatoração inteligente com foco em decomposição)
  • Precisa de análise de fluxo de chamadas? → tracer (gera prompts para rastreamento de execução e mapeamento de dependências)
  • Precisa de testes abrangentes? → testgen (gera suítes de teste com casos extremos)
  • Preocupações de segurança? → secaudit (análise OWASP, avaliação de conformidade, avaliação de vulnerabilidades)
  • O código precisa de documentação? → docgen (gera documentação abrangente com análise de complexidade)
  • Quais modelos estão disponíveis? → listmodels (mostra todos os provedores e modelos configurados)
  • Informações do servidor? → version (versão e detalhes de configuração)

Modo Automático: Quando DEFAULT_MODEL=auto, o Claude escolhe automaticamente o melhor modelo para cada tarefa. Você pode substituir com: "Use flash para análise rápida" ou "Use o3 para depurar isso".

Exemplos de Seleção de Modelo:

  • Revisão de arquitetura complexa → O Claude escolhe o Gemini Pro
  • Verificação rápida de formatação → O Claude escolhe o Flash
  • Depuração lógica → O Claude escolhe o O3
  • Explicações gerais → O Claude escolhe o Flash por velocidade
  • Análise local → O Claude escolhe seu modelo Ollama

Dica Pro: Os modos de pensamento (para modelos Gemini) controlam a profundidade versus o custo de tokens. Use "minimal" ou "low" para tarefas rápidas, "high" ou "max" para problemas complexos. Saiba mais

Visão Geral das Ferramentas:

  1. chat - Conversas colaborativas de pensamento e desenvolvimento
  2. thinkdeep - Raciocínio estendido e resolução de problemas
  3. challenge - Prompt de desafio crítico, evita Você está absolutamente certo!
  4. planner - Planejamento sequencial interativo para projetos complexos
  5. consensus - Análise de consenso multi-modelo com direcionamento de postura
  6. codereview - Revisão de código profissional com níveis de severidade
  7. precommit - Validar alterações git antes de commitar
  8. debug - Investigação sistemática e depuração
  9. analyze - Análise de arquivos e código de propósito geral
  10. refactor - Refatoração de código com foco em decomposição
  11. tracer - Gerador de prompt de análise estática para mapeamento de fluxo de chamadas
  12. testgen - Geração abrangente de testes com cobertura de casos extremos
  13. secaudit - Auditoria de segurança abrangente com análise OWASP Top 10
  14. docgen - Geração abrangente de documentação com análise de complexidade
  15. listmodels - Exibir todos os modelos de IA disponíveis organizados por provedor
  16. version - Obter versão e configuração do servidor

1. chat - Chat Geral de Desenvolvimento e Pensamento Colaborativo

Seu parceiro de pensamento para brainstorming, obtenção de segundas opiniões e validação de abordagens. Perfeito para comparações de tecnologia, discussões de arquitetura e resolução colaborativa de problemas.

Chat with zen about the best approach for user authentication in my React app

📖 Leia Mais - Recursos detalhados, exemplos e melhores práticas

2. thinkdeep - Parceiro de Raciocínio Estendido

Obtenha uma segunda opinião para aumentar o próprio pensamento estendido do Claude. Usa modelos de pensamento especializados para desafiar suposições, identificar casos extremos e fornecer perspectivas alternativas.

The button won't animate when clicked, it seems something else is intercepting the clicks. Use thinkdeep with gemini pro after gathering related code and handing it the files
and find out what the root cause is

📖 Leia Mais - Capacidades de análise aprimoradas e processo de avaliação crítica

3. challenge - Prompt de Desafio Crítico

Incentiva uma reavaliação cuidadosa das declarações em vez de concordância automática, especialmente quando você está errado. Envolve sua entrada com instruções para pensamento crítico e análise honesta.

challenge isn't adding this function to the base class a bad idea?

Normalmente, seu agente de codificação favorito responderá entusiasticamente com “Você está absolutamente certo!”—e depois prosseguirá para reverter completamente a estratégia correta, sem nunca explicar por que você está errado.

📖 Leia Mais - Ferramenta de pensamento crítico para validar ideias

4. planner - Planejamento Interativo Passo a Passo

Divida projetos ou ideias complexas em planos estruturados e gerenciáveis através do pensamento passo a passo. Perfeito para adicionar novos recursos a um sistema existente, escalar design de sistema, estratégias de migração, e planejamento arquitetônico com capacidades de ramificação e revisão.

Dica Pro

O Claude suporta sub-tasks onde ele criará e executará tarefas de segundo plano separadas. Você pode pedir ao Claude para executar o planejador do Zen com duas ideias separadas. Depois, quando terminar, use a ferramenta consensus do Zen para passar o plano inteiro e obter a perspectiva de especialistas de dois modelos de IA poderosos sobre qual trabalhar primeiro! Como fazer teste AB de uma só vez, sem espera!

Create two separate sub-tasks: in one, using planner tool show me how to add natural language support
to my cooking app. In the other sub-task, use planner to plan how to add support for voice notes to my cooking app.
Once done, start a consensus by sharing both plans to o3 and flash to give me the final verdict. Which one do
I implement first?

📖 Leia Mais - Metodologia de planejamento passo a passo e continuação em múltiplas sessões

5. consensus - Coleta de Perspectiva Multi-Modelo

Obtenha opiniões diversas de especialistas de múltiplos modelos de IA sobre propostas técnicas e decisões. Suporta direcionamento de postura (a favor/contra/neutro) e tomada de decisão estruturada.

Get a consensus with flash taking a supportive stance and gemini pro being critical to evaluate whether we should
migrate from REST to GraphQL for our API. I need a definitive answer.

📖 Leia Mais - Orquestração multi-modelo e análise de decisão

6. codereview - Revisão de Código Profissional

Análise abrangente de código com feedback priorizado e níveis de severidade. Esta ferramenta de fluxo de trabalho guia o Claude por etapas sistemáticas de investigação com pausas forçadas entre cada etapa para garantir exame minucioso do código, identificação de problemas e avaliação de qualidade antes de fornecer análise especializada.

Perform a codereview with gemini pro especially the auth.py as I feel some of the code is bypassing security checks
and there may be more potential vulnerabilities. Find and share related code."

Dicas:

  • Para evitar custos extras de API, adicione do not use another model para executar todo o fluxo de trabalho de revisão de código localmente.
  • Se você quiser sempre consultar um modelo externo (recomendado para revisões de código) independentemente do nível de confiança do Claude em identificar problemas, use must codereview using <model name>. Isso garante que o modelo seja consultado mesmo que o Claude esteja certo sobre os problemas identificados.

📖 Leia Mais - Fluxo de trabalho de revisão profissional com análise passo a passo

7. precommit - Validação Pré-Commit

Revisão abrangente de alterações git em estágio/não em estágio em múltiplos repositórios. Esta ferramenta de fluxo de trabalho guia o Claude por uma investigação sistemática de alterações git, status do repositório e modificações de arquivos em múltiplas etapas antes de fornecer validação especializada para garantir que as alterações atendam aos requisitos e evitem regressões.

Perform a thorough precommit with o3, we want to only highlight critical issues, no blockers, no regressions. I need
100% confidence this covers all the edge cases listed in FIX_ISSUE_ABC.md

Exemplo Real:

  • Pedi ao claude (sonnet-4) para refatorar um código para corrigir um bug conhecido; dei instruções exatas
  • A correção parecia correta — e, à primeira vista, as alterações também.
  • Mais importante, todos os testes de unidade existentes passaram (540+ testes) sem problemas. Zero regressões. O Claude parecia confiante e ansioso para commitar. Tudo parecia perfeito.

Então executei:

Run a precommit with o3 confirm our changes are sound and diffs are valid. Confirm this won't cause breakage or
regressions and codesmells are out

Isso passou as alterações rastreadas e não rastreadas / diffs e o código relacionado para o o3 para uma revisão completa via ferramenta precommit do Zen.

Saída:

⏺ Precommit Analysis Results - CRITICAL ISSUE FOUND

  The O3 model has identified one HIGH-severity regression and several medium/low issues in our refactor. Here's the summary:

  🚨 HIGH SEVERITY - MUST FIX BEFORE COMMIT

  ...

O problema relatado era, na verdade, um bug muito sutil que passou despercebido na revisão rápida — e aparentemente faltava um teste unitário para exatamente esse caso (de 540 testes existentes!) — o que explica os zero regressões reportadas. A correção acabou sendo simples, mas o fato de Claude (e, por extensão, eu) ter deixado passar isso foi um lembrete claro: nenhum número de olhos é suficiente. Corrigi o problema, executei precommit com o3 novamente e obtive:

RECOMENDAÇÃO: PROSSEGUIR COM O COMMIT

Legal! Este é apenas um exemplo — dê uma olhada em outro exemplo aqui.

Dicas:

  • Para evitar custos extras de API, adicione do not use another model para executar todo o fluxo de precommit localmente.
  • Se você quiser sempre consultar um modelo externo (recomendado para análise de pré-commit), independentemente do nível de confiança do Claude em identificar problemas, use must precommit using <model name>. Isso garante que o modelo seja consultado mesmo se Claude estiver certo sobre os problemas identificados.

📖 Leia mais - Validação multi-repositório e análise de mudanças

8. debug - Assistente Especialista em Depuração

Depuração guiada por investigação sistemática que conduz Claude passo a passo pela análise de causa raiz. Esta ferramenta de workflow impõe um processo estruturado de investigação no qual Claude realiza exame metódico do código, coleta de evidências e formulação de hipóteses em múltiplas etapas antes de receber análise especializada do modelo de IA selecionado. Quando a confiança de Claude atinge 100% de certeza durante o fluxo investigativo, a análise especializada por outro modelo é pulada para economizar tokens e custo, e Claude prossegue diretamente para a correção do problema.

See logs under /Users/me/project/diagnostics.log and related code under the sync folder.
Logs show that sync works but sometimes it gets stuck and there are no errors displayed to
the user. Using zen's debug tool with gemini pro, find out why this is happening and what the root
cause is and its fix

Dicas:

  • Para evitar custos extras de API, adicione do not use another model para executar todo o fluxo de depuração localmente. Isso é recomendado na maioria dos casos, pois Claude normalmente identifica a causa raiz com alta confiança ao final.
  • Se você quiser sempre consultar um modelo externo, independentemente do nível de confiança do Claude, use must debug using <model name>. Isso garante que o modelo seja consultado mesmo se Claude estiver certo sobre o problema.

Em caso de dúvida, você sempre pode continuar com um novo prompt e pedir ao Claude para compartilhar suas descobertas com outro modelo:

Use continuation with thinkdeep, share details with o4-mini to find out what the best fix is for this

📖 Leia mais - Metodologia de investigação passo a passo com imposição de workflow

9. analyze - Análise Inteligente de Arquivos

Compreensão geral de código e exploração. Esta ferramenta de workflow orienta Claude pela investigação sistemática da estrutura do código, padrões e decisões arquiteturais em múltiplas etapas, reunindo insights abrangentes antes de fornecer análise especializada para avaliação de arquitetura, detecção de padrões e recomendações estratégicas de melhoria.

Use gemini to analyze main.py to understand how it works

📖 Leia mais - Fluxo de análise abrangente com investigação passo a passo

10. refactor - Refatoração Inteligente de Código

Análise abrangente de refatoração com estratégia de decomposição de cima para baixo. Esta ferramenta de workflow impõe investigação sistemática de code smells, oportunidades de decomposição e possibilidades de modernização em múltiplas etapas, garantindo análise completa antes de fornecer recomendações especializadas de refatoração com orientação precisa de implementação.

Use gemini pro to decompose my_crazy_big_class.m into smaller extensions

📖 Leia mais - Refatoração orientada por workflow com análise progressiva

11. tracer - Gerador de Prompts para Análise de Código Estático

Cria prompts de análise detalhados para mapeamento de fluxo de chamadas e rastreamento de dependências. Gera solicitações estruturadas de análise para execução precisa do fluxo ou mapeamento de dependências.

Use zen tracer to analyze how UserAuthManager.authenticate is used and why

📖 Leia mais - Geração de prompts e modos de análise

12. testgen - Geração Abrangente de Testes

Gera suítes de teste completas com cobertura de casos extremos, baseadas no código existente e no framework de testes. Esta ferramenta de workflow orienta Claude pela investigação sistemática da funcionalidade do código, caminhos críticos, casos extremos e pontos de integração em múltiplas etapas antes de gerar testes abrangentes com análise realista de modos de falha.

Use zen to generate tests for User.login() method

📖 Leia mais - Geração de testes baseada em workflow com cobertura abrangente

13. secaudit - Auditoria de Segurança Abrangente

Avaliação de segurança sistemática baseada em OWASP com avaliação de conformidade. Esta ferramenta de workflow orienta Claude por etapas metódicas de investigação de segurança com pausas forçadas entre cada etapa para garantir avaliação completa de vulnerabilidades, análise de padrões de segurança e verificação de conformidade antes de fornecer análise especializada.

Perform a secaudit with o3 on this e-commerce web application focusing on payment processing security and PCI DSS compliance

📖 Leia mais - Análise OWASP Top 10 com suporte a frameworks de conformidade

14. docgen - Geração Abrangente de Documentação

Gera documentação completa com análise de complexidade e identificação de armadilhas. Esta ferramenta de workflow orienta Claude pela investigação sistemática da estrutura do código, complexidade das funções e necessidades de documentação em múltiplas etapas antes de gerar documentação abrangente que inclui complexidade algorítmica, informações de fluxo de chamadas e comportamentos inesperados que os desenvolvedores devem conhecer.

# Includes complexity Big-O notiation, documents dependencies / code-flow, fixes existing stale docs
Use docgen to documentation the UserManager class

# Includes complexity Big-O notiation, documents dependencies / code-flow
Use docgen to add complexity analysis to all the new swift functions I added but don't update existing code

📖 Leia mais - Geração de documentação baseada em workflow com detecção de armadilhas

15. listmodels - Listar Modelos Disponíveis

Exibe todos os modelos de IA disponíveis organizados por provedor, mostrando capacidades, janelas de contexto e status de configuração.

Use zen to list available models

📖 Leia mais - Capacidades dos modelos e detalhes de configuração

16. version - Informações do Servidor

Obtenha versão do servidor, detalhes de configuração e status do sistema para depuração e solução de problemas.

What version of zen do I have

📖 Leia mais - Diagnóstico do servidor e verificação de configuração

Para parâmetros detalhados das ferramentas e opções de configuração, consulte o Guia de Uso Avançado.

Suporte a Prompts

Zen oferece suporte a prompts estruturados poderosos no Claude Code para acesso rápido a ferramentas e modelos:

Prompts de Ferramentas

  • /zen:chat ask local-llama what 2 + 2 is - Usar a ferramenta de chat com modelo auto-selecionado
  • /zen:thinkdeep use o3 and tell me why the code isn't working in sorting.swift - Usar a ferramenta thinkdeep com modelo auto-selecionado
  • /zen:planner break down the microservices migration project into manageable steps - Usar a ferramenta planner com modelo auto-selecionado
  • /zen:consensus use o3:for and flash:against and tell me if adding feature X is a good idea for the project. Pass them a summary of what it does. - Usar a ferramenta consensus com configuração padrão
  • /zen:codereview review for security module ABC - Usar a ferramenta codereview com modelo auto-selecionado
  • /zen:debug table view is not scrolling properly, very jittery, I suspect the code is in my_controller.m - Usar a ferramenta debug com modelo auto-selecionado
  • /zen:analyze examine these files and tell me what if I'm using the CoreAudio framework properly - Usar a ferramenta analyze com modelo auto-selecionado
  • /zen:docgen generate comprehensive documentation for the UserManager class with complexity analysis - Usar a ferramenta docgen com modelo auto-selecionado

Prompts de Continuação

  • /zen:chat continue and ask gemini pro if framework B is better - Continuar conversa anterior usando a ferramenta de chat

Exemplos Avançados

  • /zen:thinkdeeper check if the algorithm in @sort.py is performant and if there are alternatives we could explore
  • /zen:planner create a step-by-step plan for migrating our authentication system to OAuth2, including dependencies and rollback strategies
  • /zen:consensus debate whether we should migrate to GraphQL for our API
  • /zen:precommit confirm these changes match our requirements in COOL_FEATURE.md
  • /zen:testgen write me tests for class ABC
  • /zen:docgen document the payment processing module with gotchas and complexity analysis
  • /zen:refactor propose a decomposition strategy, make a plan and save it in FIXES.md

Formato de Sintaxe

O formato do prompt é: /zen:[tool] [your_message]

  • [tool] - Qualquer nome de ferramenta disponível (chat, thinkdeep, planner, consensus, codereview, debug, analyze, docgen, etc.)
  • [your_message] - Sua solicitação, pergunta ou instruções para a ferramenta

Observação: Todos os prompts aparecerão como "(MCP) [ferramenta]" no Claude Code para indicar que são fornecidos pelo servidor MCP.

Recursos Avançados

Encadeamento de Conversas IA-para-IA

Este servidor permite verdadeira colaboração de IA entre Claude e múltiplos modelos de IA, onde eles podem coordenar e construir uns sobre os insights dos outros entre ferramentas e conversas.

📖 Leia mais - Coordenação multi-modelo, encadeamento de conversas e workflows colaborativos

Configuração

Configure o servidor Zen MCP por meio de variáveis de ambiente no arquivo .env. Suporta múltiplos provedores de IA, restrições de modelos, configurações de conversa e opções avançadas.

# Quick start - Auto mode (recommended)
DEFAULT_MODEL=auto
GEMINI_API_KEY=your-gemini-key
OPENAI_API_KEY=your-openai-key
DIAL_API_KEY=your-dial-key  # Optional: Access to multiple models via DIAL

Principais Opções de Configuração:

  • Chaves de API: APIs nativas (Gemini, OpenAI, X.AI), OpenRouter, DIAL ou endpoints personalizados (Ollama, vLLM)
  • Seleção de Modelo: Modo automático ou padrões específicos de modelo
  • Restrições de Uso: Controle quais modelos podem ser usados para gerenciamento de custo
  • Configurações de Conversa: Timeout, limites de turnos, configuração de memória
  • Modos de Pensamento: Alocação de tokens para raciocínio estendido
  • Registro: Níveis de depuração e visibilidade operacional

📖 Leia mais - Referência completa de configuração com exemplos

Testes

Para informações sobre como executar testes, consulte o Guia de Testes.

Contribuindo

Aceitamos contribuições! Por favor, consulte nossos guias abrangentes:

Licença

Licença Apache 2.0 - consulte o arquivo LICENSE para detalhes.

Agradecimentos

Construído com o poder da IA Multi-Modelo 🤝

Histórico de Estrelas

Star History Chart