Skip to Content
IntegraçõesCursor & VS Code

Cursor & VS Code

Conecte o SpecForge ao Cursor e VS Code com GitHub Copilot via MCP para assistência de código ciente da especificação.

Tanto o Cursor quanto o VS Code (com GitHub Copilot) suportam servidores MCP. O SpecForge integra com ambos os editores para que você possa consultar sua especificação, verificar status de tickets e acessar contexto de dependência sem sair do seu ambiente de desenvolvimento.

Como Difere do Claude Code

As integrações com Cursor e VS Code são conversacionais — você dirige o fluxo de trabalho e o agente assiste. Você decide em qual ticket trabalhar, pede contexto, implementa com ajuda do agente e marca progresso.

O Claude Code com Agent Teams é autônomo — você dá uma instrução e o agente dirige a implementação inteira.

Ambos são fluxos de trabalho válidos. Use Cursor/VS Code quando quiser manter as mãos na massa. Use Claude Code quando quiser delegar.

Setup

Automático (recomendado)

specforge init

A CLI detecta Cursor e/ou VS Code e gera .mcp.json na raiz do repositório. Ambos os editores leem este arquivo na inicialização.

Manual

Crie .mcp.json na raiz do seu projeto:

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

Para Cursor: Reinicie o editor. Você também pode adicionar via Settings > MCP na UI do Cursor.

Para VS Code com Copilot: Certifique-se de que as extensões GitHub Copilot e Copilot Chat estão instaladas. Reinicie o VS Code. As ferramentas do SpecForge aparecem no modo agente do Copilot Chat.

✅ O formato .mcp.json é compartilhado entre Claude Code, Cursor e VS Code. Um único arquivo de configuração funciona para todos.

Ferramentas Disponíveis

Todas as 22 ferramentas MCP do SpecForge estão disponíveis em ambos os editores. Enquanto codifica, você pode:

  • Consultar os critérios de aceite e contexto de implementação do ticket atual
  • Verificar quais tickets estão bloqueados e no que trabalhar a seguir
  • Consultar a árvore de dependência para entender como componentes se relacionam
  • Vincular commits e pull requests a tickets
  • Buscar na especificação por palavra-chave

Fluxo de Trabalho

Um fluxo de trabalho típico no Cursor ou VS Code com SpecForge:

  1. “What tickets are ready for implementation?” — O agente chama get_next_actionable_tickets e mostra a wave atual
  2. Escolha um ticket — “Give me the full context for ticket tkt_abc123” — O agente retorna passos, critérios de aceite, dependências e blueprints
  3. Implemente com assistência — Code com ajuda do agente, usando o contexto do ticket como guia
  4. Rastreie progresso — “Mark steps 1 and 2 as complete for this ticket” — O agente chama action_work_session
  5. Complete e passe adiante — “Complete this ticket” — O agente chama complete_work_session, e tickets dependentes desbloqueiam
  6. “What’s next?” — O agente mostra tickets recém-desbloqueados

A especificação dirige o fluxo de trabalho. Em vez de perguntar “o que devo construir a seguir?” a um agente sem contexto, você está perguntando a um agente que conhece seu grafo de dependência inteiro.

Scaffolding

Para regenerar configuração do editor sem o fluxo completo de init:

specforge scaffold --target cursor

Isso cria ou atualiza .mcp.json e gera um arquivo AGENTS.md com instruções adaptadas para o modo agente do editor.

Próximos Passos

  • Claude Code — Para implementação totalmente autônoma
  • Outros Agentes — Gemini CLI, Codex CLI, OpenCode e qualquer ferramenta compatível com MCP
Claude DesktopOutros Agentes