Referência de ferramentas MCP

Um comando de início.
Ferramentas de memória claras.

Execute o setup uma vez e reinicie sua ferramenta de IA. O Engram aparece como ferramentas MCP com orientação inicial; consulte as ferramentas focadas quando precisar.

1. Ação humana

Instale uma vez

Você executa um comando no terminal: npx engram-tools@0.3.6 --setup <api-key>. Ele grava a config MCP para Claude Code, Cursor, Gemini, Antigravity, Codex, OpenCode e VS Code/Copilot quando possível.

$ npx -y engram-tools@0.3.6 --setup <api-key>

2. Ação do agente

Chame ferramentas dentro do app de IA

Você não roda engram_start no shell. Depois do setup, o cliente mostra as ferramentas do Engram e a orientação inicial ao agente. Você descreve a tarefa normalmente; se o cliente ignorar a orientação, cole uma vez um prompt curto de contexto.

Você: Trabalhe neste repo/tarefa. Use o contexto do Engram antes de planejar.

3. Por que funciona

MCP expõe Engram como ferramentas

Depois de reiniciar, o cliente de IA carrega o servidor MCP da Engram. O agente vê ferramentas como engram_start, engram_store e engram_recall, além de AGENTS.md e helpers slash do Claude.

O agente vê: engram_start, engram_store, engram_recall...

A melhor primeira mensagem para o agente

Engram também orienta o agente via MCP. Este prompt deixa a primeira sessão clara e ajuda o agente a usar recall, cross-pollination e rehydrate no momento certo.

O email de boas-vindas também inclui isto. Aqui fica como fallback se o cliente AI ignorar a orientação inicial do MCP.

Chame engram_start com este contexto:
  project: <produto ou cliente>
  repo: <repo>
  role: <papel>
  market: <domínio ou mercado>
  stack: <tecnologias principais>
  task: <tarefa atual>
Antes de escolher abordagem, chame engram_recall.
Se outro repo pode ter resolvido este padrão, chame engram_cross_pollinate.
Se o chat foi compactado ou retomado, chame engram_rehydrate.

Configuração por cliente

O comando de setup cuida disso automaticamente. Estes exemplos mostram os formatos exatos de clientes que não usam o JSON padrão.

Antigravity

O fluxo atual do Gemini pode levar usuários ao Antigravity. O Engram grava a config compartilhada do Gemini e os arquivos específicos do Antigravity.

// ~/.gemini/config/mcp_config.json
// ~/.gemini/antigravity/mcp_config.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"]
    }
  }
}

OpenCode

OpenCode usa um array de comando em vez do formato mcpServers. O setup grava esse formato automaticamente.

// ~/.config/opencode/opencode.json
{
  "mcp": {
    "engram": {
      "type": "local",
      "command": ["npx", "-y", "engram-tools", "mcp"],
      "enabled": true
    }
  }
}

Codex

Codex usa TOML. O Engram substitui apenas a tabela engram e preserva o restante da config do Codex.

# ~/.codex/config.toml
[mcp_servers.engram]
type = "stdio"
command = "npx"
args = ["-y", "engram-tools", "mcp"]

Ferramentas

Escolha uma ferramenta para inspecionar

Loop principal

Ferramentas do fluxo normal e recuperação após compactação.

Avançadas e checkpoints

Ficam disponíveis, mas só devem ser usadas com gatilho real.

Escolha uma ferramenta para inspecionar

engram_start

Use quando o agente precisa iniciar uma sessão.

engram_start

Ferramenta Engram para iniciar uma sessão.

Use quando o agente precisa iniciar uma sessão.

agent_tool

opcional

string