Claude Desktop

Use ferramentas do SpecForge dentro do Claude Desktop para planejamento de projetos, revisão de especificações e monitoramento de progresso.

O Claude Desktop suporta servidores MCP, dando acesso ao toolkit completo do SpecForge diretamente na conversa. Ideal para sessões de planejamento, revisões de especificação e monitoramento de progresso de implementação — tudo sem sair do app desktop.

Quando Usar o Claude Desktop

O Claude Desktop é melhor para trabalho que envolve pensar e revisar, não escrever código:

Planejar uma especificação — Descreva o que você quer construir, deixe o Claude ajudar a decompor em épicos e tickets, refine dependências e critérios de aceite através de conversa
Revisar uma especificação — Peça ao Claude para avaliar completude, verificar dependências faltando, identificar tickets sem critérios de aceite, sinalizar problemas estruturais
Monitorar progresso — Peça uma atualização de status da sua especificação. O Claude mostra contagem de tickets por status, identifica itens bloqueados e destaca o caminho crítico
Explorar o grafo de dependência — “Quais tickets estão bloqueados?” “Qual é o caminho crítico?” “Quais épicos podem rodar em paralelo?” — todos respondíveis através de ferramentas MCP na conversa

ℹ️ O Claude Desktop não suporta Agent Teams. Agent Teams requer a capacidade do Claude Code de executar código, gerenciar branches e rodar testes na sua máquina local. Use o Claude Desktop para planejamento e review; use o Claude Code para implementação.

Setup

Adicione o servidor do SpecForge ao arquivo de configuração do Claude Desktop:

SO	Caminho do config
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Adicione a entrada do SpecForge em mcpServers:


{
  "mcpServers": {
    "specforge": {
      "command": "npx",
      "args": ["-y", "@specforge/cli@latest"],
      "env": {
        "SPECFORGE_API_KEY": "your-api-key"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar. As ferramentas do SpecForge aparecem no seletor de ferramentas.

✅ Gere uma chave de API dedicada para o Claude Desktop em Settings > API Keys para poder revogá-la independentemente da sua chave da CLI.

Ferramentas Disponíveis

Todas as 22 ferramentas MCP do SpecForge funcionam em conversas do Claude Desktop. Você pode:

Criar e editar especificações, épicos e tickets
Consultar o grafo de dependência e identificar bloqueadores
Revisar progresso de implementação e histórico de sessões
Gerar relatórios sobre completude da especificação
Buscar tickets por palavra-chave ou status

Fluxo de Trabalho: Planejar no Desktop, Implementar no Code

Um fluxo de trabalho produtivo usa tanto o Claude Desktop quanto o Claude Code:

Planeje no Claude Desktop — Defina sua especificação, crie épicos e tickets, vincule blueprints, valide o grafo de dependência, execute o Planning Review
Implemente no Claude Code — Vá para seu terminal, abra o Claude Code e deixe o Agent Teams executar o plano

Ambas as ferramentas se conectam ao mesmo projeto SpecForge. Mudanças feitas no Claude Desktop são imediatamente visíveis no Claude Code. A especificação que você refinou na conversa é a mesma que os agentes implementam no terminal.

Essa separação é natural — planejamento é deliberado, visual, conversacional. Implementação é autônoma, baseada em terminal, focada em código. Ferramentas diferentes para fases diferentes.

Próximos Passos

Claude Code — Configure o Claude Code para implementação
Cursor & VS Code — Integração baseada em editor