Skip to Content
IntegraçõesOutros Agentes

Outros Agentes

Conecte o SpecForge ao Gemini CLI, Codex CLI, OpenCode e qualquer agente compatível com MCP.

O SpecForge funciona com qualquer ferramenta que suporte servidores MCP. Além do Claude Code e Cursor, a CLI auto-detecta e gera configuração para Gemini CLI, Codex CLI e OpenCode. Se sua ferramenta fala MCP, o SpecForge se conecta a ela.

O Padrão Universal

Toda integração segue os mesmos três passos:

  1. Configuração MCP — Aponte a configuração MCP da ferramenta para npx @specforge/cli@latest
  2. Chave de API — Defina SPECFORGE_API_KEY no ambiente da ferramenta
  3. Instruções do agente — Um arquivo markdown que diz ao agente como interagir com o SpecForge

O specforge init cuida dos três para cada ferramenta detectada. Os detalhes abaixo são para setup manual ou troubleshooting.

Gemini CLI

Automático

specforge init

Gera .gemini/settings.json e GEMINI.md.

Manual

Crie .gemini/settings.json na raiz do seu projeto:

{
  "mcpServers": {
    "specforge": {
      "command": "npx",
      "args": ["@specforge/cli@latest"]
    }
  }
}

⚠️ O Gemini CLI lê a chave de API do seu ambiente. Defina SPECFORGE_API_KEY no perfil do seu shell ou arquivo .env antes de iniciar o Gemini CLI.

GEMINI.md é o arquivo de instrução do agente — diz ao Gemini como trabalhar com ferramentas do SpecForge, quais tickets pegar e como estruturar seu trabalho.

Codex CLI

Automático

specforge init

Gera .codex/config.toml e AGENTS.md.

Manual

Crie .codex/config.toml na raiz do seu projeto:

[mcp_servers.specforge]
command = "npx"
args = ["@specforge/cli@latest"]
 
[mcp_servers.specforge.env]
SPECFORGE_API_KEY = "sf_live_..."

AGENTS.md é colocado na raiz do repositório. O Codex CLI o lê automaticamente.

OpenCode

Automático

specforge init

Gera opencode.json e AGENTS.md.

Manual

Crie opencode.json na raiz do seu projeto:

{
  "mcp": {
    "specforge": {
      "type": "local",
      "command": "npx",
      "args": ["@specforge/cli@latest"],
      "env": {
        "SPECFORGE_API_KEY": "sf_live_..."
      }
    }
  }
}

O OpenCode lê AGENTS.md da raiz do repositório.

Detectar Todas as Ferramentas de Uma Vez

Se você tem múltiplas ferramentas instaladas, o specforge scaffold detecta todas e gera tudo:

specforge scaffold

Isso cria arquivos de configuração para cada ferramenta detectada — .mcp.json para Claude Code e Cursor, .gemini/settings.json para Gemini CLI, .codex/config.toml para Codex CLI e opencode.json para OpenCode.

Pré-visualize sem escrever:

specforge scaffold --dry-run

Arquivos de Instrução de Agente

ArquivoUsado porPropósito
CLAUDE.mdClaude CodeÂncora de contexto do projeto + instruções de fluxo de trabalho do SpecForge
GEMINI.mdGemini CLIInstruções de fluxo de trabalho do SpecForge para Gemini
AGENTS.mdCodex CLI, OpenCode, outrosFallback universal — qualquer ferramenta sem formato dedicado de instrução lê este

✅ AGENTS.md é o arquivo de instrução universal. Ferramentas sem seu próprio formato dedicado (como CLAUDE.md ou GEMINI.md) fazem fallback para ler AGENTS.md na raiz do repositório.

Qualquer Agente Compatível com MCP

Se sua ferramenta suporta MCP mas não está listada aqui, o padrão é o mesmo:

  1. Aponte a configuração do servidor MCP para npx @specforge/cli@latest
  2. Defina SPECFORGE_API_KEY no ambiente
  3. Coloque um arquivo de instrução na raiz do repositório

O servidor MCP do SpecForge expõe 22 ferramentas via o protocolo MCP padrão. Qualquer cliente compatível pode descobrir e chamá-las.

Próximos Passos

Cursor & VS CodePadrões de Qualidade