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.

Comece com um teste gratuito pelo npm

O cliente npm não precisa de e-mail nem chave API. Com permissão para alterar a configuração da sua ferramenta de IA, execute setup, reinicie o cliente e descreva o repositório e a tarefa reais. Adicione --dry-run para visualizar as mudanças antes. Preserve qualquer espaço Engram já conectado.

npx -y engram-tools@latest --setup

Chame engram_start, salve uma decisão confirmada com engram_store e recupere-a em uma nova sessão.

A primeira chamada de memória inicia o teste de 7 dias: 25 registros privados, 20 chamadas por dia e 100 no total.

Para manter o mesmo espaço, execute depois npx -y engram-tools@latest connect e confirme seu e-mail.

Conexões OAuth remotas, como as de marketplaces, verificam o e-mail ao conectar.

Ou crie um espaço com propriedade verificada por e-mail

Passo 1

Digite seu email

Comece grátis com 100 memórias privadas, 1 desenvolvedor e o banco público de 100.000 memórias. Sem cartão de crédito.

Passo 2

Verifique o código OTP

Enviamos primeiro um código de 6 dígitos para que ninguém crie contas com o email de outra pessoa.

Passo 3

Receba sua API key

Após a verificação, Engram cria seu workspace automaticamente e envia sua chave de setup por email.

Onde obtenho uma chave de API?

Crie um espaço de trabalho gratuito e confirme seu email. O Engram envia sua chave de API pessoal e o comando de instalação pronto no email de boas-vindas. Se você já se cadastrou, use o mesmo email para receber sua chave atual.

Obter uma chave grátis
Passo 4

Inicie seu agente

Execute npx engram-tools@latest --setup com sua chave de API, reinicie a ferramenta de IA e descreva o projeto e a tarefa normalmente. O Engram orienta o agente automaticamente via MCP.

npx -y engram-tools@latest --setup

Verifique a conexão e a primeira memória útil

Descreva o projeto e a tarefa ao agente. Após trabalho real, peça para guardar uma decisão duradoura e recuperá-la em uma nova sessão. A instalação sozinha não cria memória privada.

npx -y engram-tools@latest --doctor
  • Ferramentas ausentes? Feche completamente e reabra o cliente. Verifique Node.js 20+ e npx. Normalmente não é necessário reinstalar.
  • Cada cliente tem sua configuração. Execute a verificação abaixo e use --setup --client codex com a chave do workspace correto. --update preserva as conexões existentes.
  • Gemini pode exigir confiança na pasta e consentimento MCP. Convide colegas pelo dashboard: cada pessoa recebe sua chave para o mesmo workspace compartilhado.

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@latest", "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@latest", "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@latest", "mcp"]
Mensagem opcional para a primeira sessão

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.

Memória, atualidade e feedback

O funcionamento prático das ferramentas. As tabelas de parâmetros vêm do esquema MCP. Os exemplos de resposta são trechos HTTP sem dados sensíveis. O MCP retorna JSON, Markdown ou confirmações curtas por text/format; confira format antes de interpretar.

Escolha a ferramenta conforme a necessidade

Começar o trabalho em um repositório

engram_start

Visão do espaço e memória relevante

Responder a uma pergunta concreta

engram_recall

Memórias ordenadas para essa pergunta

Mudar de tarefa com o contexto preservado

engram_smarter

Resumo focado na nova tarefa

Retomar após perder o contexto

engram_rehydrate

Recuperação segura do diário e apoio na memória atual

Registrar um marco do trabalho

engram_reflect

Checkpoint; a sessão continua aberta

O cliente npm pode iniciar um teste gratuito isolado sem e-mail nem chave API. As conexões OAuth remotas verificam o e-mail. Nunca invente credenciais. repo é um filtro no espaço autorizado, não uma permissão para acessar outro espaço.

Use engram_start ao começar, engram_recall para uma pergunta, engram_smarter ao mudar de tarefa e engram_rehydrate após compactação do contexto ou interrupção. Smarter busca memória duradoura para a nova tarefa; não reconstrói o diário anterior. Ambos podem registrar eventos de sessão. Rehydrate pode ler sessões fechadas ou o histórico de colegas, mas não reabri-las nem escrever nelas. engram_reflect mantém a sessão aberta; engram_close_session a encerra explicitamente.

Os padrões focused são start=8, recall=5, smarter=5 e cross_pollinate=5 registros. Com deep, são 16, 12, 12 e 12, respectivamente. Um limit explícito substitui esses valores dentro do máximo da ferramenta. Sem include_skills explicitamente true ou false, os guias são inferidos das palavras-chave da tarefa.

Rehydrate usa outro orçamento: depth=brief retorna até 12 eventos e 2 resumos; standard, 30 e 4; full, 60 e 8. Não aceita limit nem os valores de busca focused/deep.

Se recall retornar count=0, diga que nenhuma memória correspondente foi encontrada. Confira repo e a consulta, reformule ou use depth=deep quando fizer sentido. Mais resultados não tornam relevante uma informação alheia. Use cross_pollinate se outro repositório provavelmente contém uma lição transferível. get_context serve à inspeção deliberada por categoria, não é o próximo passo automático de toda busca vazia.

Separe regras de fatos que podem mudar

Prefira um fato que possa ser mantido separadamente por memória. Uma regra de autorização e um estado de implantação devem ter IDs próprios. Para uma unidade, use type, content e claim opcional; para 1–32 unidades independentes, use claims, cada uma com type, content e claim. Não misture os formatos. Memórias antigas sem tipagem continuam legacy_unassessed; adicionar metadados não prova que uma nota contém só um fato.

type é a categoria de busca, como CONVENTION ou SOLUTION; claim.kind distingue rule, decision, state, lesson e reference. Só state possui stage: proposed, implemented, tested ou deployed. Exige observed_at em ISO com fuso horário, no máximo um minuto à frente do relógio do servidor. UTC e deslocamentos explícitos são aceitos; mantenha o relógio do cliente sincronizado. tested/deployed também exigem evidence, fornecida pelo agente, sem verificação independente pelo Engram. review_after é opcional e não pode anteceder observed_at. É uma data de revisão, não expiração automática nem permissão para retirar uma regra.

kind=rule não concede autoridade humana nem substitui instruções atuais. Use supersedes_memory_ids e change_reason somente para substituição verificada. Uma divisão legada usa split_from com memory_id e content_sha256; por padrão só visualiza o plano. Aplique apenas com dry_run=false e a confirmação recebida split:<id>:<plan_hash>. Partes históricas continuam históricas; não copie votos de sucesso para fatos novos sem relação.

Exemplo: substitua os marcadores pelos valores realmente retornados.

{
  "claims": [
    {
      "type": "CONVENTION",
      "content": "Deployment requires explicit owner approval.",
      "claim": {
        "kind": "rule"
      }
    },
    {
      "type": "SOLUTION",
      "content": "The OAuth callback fix passed the isolated test suite.",
      "claim": {
        "kind": "state",
        "stage": "tested",
        "observed_at": "2026-11-15T09:00:00Z",
        "evidence": "Commit abc1234; isolated OAuth regression receipt"
      }
    }
  ]
}
Revise uma nota mista sem perder a regra válida

Se uma nota junta uma regra válida e um estado de publicação obsoleto, não retire tudo só para esconder esse estado. Revise cada fato independente. Mantenha a regra ativa e marque como histórica apenas a parte obsoleta de claims. O criador ou proprietário humano pode dividir a nota; a fonte deve ser privada, ativa e ainda não declarada como claim.

Para visualizar o plano, envie claims e split_from juntos. Calcule content_sha256 sobre o texto exato armazenado, não uma versão resumida ou paráfrase. A prévia não grava memórias. Confira claims, active_claims e historical_claims antes de aplicar. O exemplo é pseudocódigo do SDK MCP: source é o registro real e claims sua lista revisada; historical:true só nas partes obsoletas.

Reenvie a fonte e o plano sem mudanças com dry_run=false e a confirmation da prévia copiada exatamente. Não invente uma confirmação. Fonte ou plano alterados exigem nova prévia. O original fica no histórico; as unidades novas recebem IDs separados sem herdar votos. A prévia verifica a estrutura da gravação, não a veracidade da revisão.

Exemplo: substitua os marcadores pelos valores realmente retornados.

const plan = {
  split_from: {
    memory_id: source.id,
    content_sha256: sha256(source.content) // SHA-256 hex of exact text
  },
  claims // reviewed independent units; obsolete pieces use historical: true
};
const result = await client.callTool({ name: "engram_store", arguments: plan });
if (result.isError) throw new Error("Split preview failed");
if (result.structuredContent?.format !== "json") throw new Error("Expected JSON preview");
const preview = JSON.parse(result.structuredContent.text);
// Review preview.claims, active_claims and historical_claims before applying.
await client.callTool({
  name: "engram_store",
  arguments: { ...plan, dry_run: false, confirmation: preview.confirmation }
});
Útil não significa verificado nem atual

success=true significa que a memória ajudou na tarefa. Não prova que ainda seja verdadeira, esteja em produção ou que toda frase de uma nota antiga mista esteja correta. trust=validated e confidence são rótulos de compatibilidade para utilidade relatada, não verificação independente. Leia claim.stage, observed_at, evidence e last_outdated_report_at; confira fatos críticos no código e no sistema atuais.

A relevância inicial é relevant, irrelevant ou uncertain. A utilidade real é helpful, unhelpful, not_used ou not_evaluated. Apenas helpful/unhelpful cria voto e altera confidence. Um resultado pode ser irrelevant e not_used sem voto negativo de uso. Sem feedback, fica não avaliado. Notas de relevância e evidências de uso são separadas.

Os sinais useful/noisy/stale/missing_context/too_long em engram_reflect.feedback ou POST /api/v1/feedback avaliam o Engram como produto. São separados dos resultados de cada memória e não alteram a confidence individual.

Vincule o feedback à consulta exata e trate repetições

retrieval_id identifica a apresentação registrada de uma lista de resultados; session_id identifica um diário. Mantenha cada retrieval_id com sua lista, sobretudo se a mesma memória aparecer em consultas paralelas. retrieval_id null indica que não há atribuição exata nessa resposta. Fontes antigas ou fechadas podem receber feedback explícito se recibo, memória e solicitante continuarem acessíveis; não reabra o diário.

Para um uso real, chame engram_report_outcome com memory_id, success e retrieval_id. Use outcomes para até 20 pares consulta/memória únicos. Também é possível anexar os mesmos itens como pending_feedback à próxima chamada start, recall, smarter, store, reflect, cross_pollinate, get_context, skill ou report_outcome. Exige outcome:write e não consome quota adicional de chamadas. Omita o que não consegue avaliar, em vez de inventar um julgamento.

Para repetir um relato exato, envie os mesmos retrieval_id, memory_id e campos de uso. Engram responde duplicate=true sem novo voto. duplicate é campo da resposta, não entrada; não existe sinalizador retry. A repetição não é erro 409; mudar um voto já gravado retorna 409. Sem retrieval_id, o formato antigo escolhe a apresentação mais recente dessa memória para o membro e espaço autenticados nas últimas 24 horas. session_id restringe a busca ao diário. Repetições antigas podem adicionar votos; atribuição inferida não é exata. Um uso realmente novo deve ter uma nova apresentação.

O lote de feedback é confirmado antes da ação principal. Confira feedback_receipt mesmo se ela falhar: o feedback pode ter sido salvo. MCP remoto e cliente npm preservam o recibo nos erros. Falha com feedback já confirmado não é repetida automaticamente; a ação principal ainda pode não ser idempotente. Em reflect.used_memories, cada item de um lote exato atômico de até 20 deve ter retrieval_id; mantenha o formato antigo em outra reflexão. Aprendizado ou checkpoint posterior pode falhar; feedback_receipt mostra os resultados aceitos.

Exemplo: substitua os marcadores pelos valores realmente retornados.

{
  "repo": "example",
  "query": "Which deployment rule applies?",
  "pending_feedback": [
    {
      "retrieval_id": "<id from the previous result list>",
      "memory_id": "<memory in that list>",
      "relevance": "irrelevant",
      "usefulness": "not_used"
    }
  ]
}

Recomendado: resultados ligados à consulta exata (argumentos de engram_reflect)

{
  "store": false,
  "summary": "Applied the recalled approval rule.",
  "used_memories": [
    {
      "retrieval_id": "<id from that result list>",
      "memory_id": "<memory in that list>",
      "success": true,
      "detail": "Checked owner approval before releasing."
    }
  ]
}

Só para compatibilidade: reflexão legada separada (argumentos de engram_reflect)

{
  "store": false,
  "summary": "Reported a use without a retained query receipt.",
  "used_memories": [
    {
      "memory_id": "<accessible memory id>",
      "success": true,
      "detail": "This use has inferred attribution, not an exact query link."
    }
  ]
}
Retirada, exclusão permanente e recuperação segura

engram_retract_memory retira conhecimento privado de forma reversível; pode ser usado pelo criador ou proprietário humano. engram_restore_memory exige um registro retirado ainda preservado e verifica quota e substituições confirmadas. Nem gravar o mesmo texto nem rehydrate o restaura silenciosamente. Registros excluídos não podem ser restaurados.

Um token OAuth não pode visualizar nem executar a exclusão permanente, mesmo que o membro seja OWNER. Ambas as operações exigem o caminho separado da credencial API do proprietário humano. Não obtenha nem substitua a chave dele para contornar OAuth. engram_delete_memory mostra o impacto por padrão; execute só com dry_run=false e confirmation=delete:<exact memory_id>. Remove a memória ativa, cópias ligadas conhecidas e texto livre dos diários afetados. Contexto já enviado a clientes, registros independentes, paráfrases sem vínculo, provedores e backups ficam fora dessa exclusão direcionada.

A busca de sessões oculta tarefas ligadas a conhecimento retirado, expirado ou excluído. Se não for possível reconstruir o diário com segurança, use memória atual segura ou abra um diário limpo com engram_start(new_session=true); não contorne a ocultação. Restaurar uma fonte preservada pode devolver acesso ao seu histórico seguro.

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

No início de uma sessão relevante; use rehydrate para recuperar contexto perdido.

engram_start

Inicie o trabalho em um repositório.

No início de uma sessão relevante; use rehydrate para recuperar contexto perdido.

session_id
opcional
string

ID exato do diário retornado por start/rehydrate/list_sessions. Separa trabalhos paralelos; escrever exige sua sessão ativa. Rehydrate pode ler histórico compartilhado ou fechado.

agent_tool
opcional
string

Cliente que chama, como codex, claude-code, cursor ou gemini. Omita se desconhecido.

project
recomendado
string

Nome do produto/projeto. Sem repo, start/setup usam como pista do repositório.

repo
recomendado
string

Identificador do repositório no espaço autorizado. Filtro de memória, não caminho nem seletor de espaço.

role
opcional
string

Responsabilidade do agente, como desenvolvedor backend. start/setup usam agente de implementação por padrão.

market
opcional
string

Contexto de negócio/domínio; não controla acesso geográfico.

task
recomendado
string

Objetivo ou decisão concreta atual para orientar contexto e recuperação.

stack
opcional
string[]

Tecnologias do projeto; omita se desconhecidas.

context
opcional
string

Contexto completo opcional; substitui a consulta gerada por project, role, market, stack e task.

new_session
opcional
boolean

false reutiliza diário ativo adequado. true cria outro para trabalho paralelo; repetições podem criar sessões. Guarde session_id.

include_skills
opcional
boolean

Inclui guias relevantes. Se omitido, o servidor infere por palavras-chave; false exclui.

limit
opcional
number

Máximo de 1–30 memórias. Padrões focused=8, deep=16; limit explícito substitui.

depth
opcional
focused | deep

focused usa orçamento pequeno; deep amplia se insuficiente. Um limit explícito substitui o padrão.

pending_feedback
opcional
object[]

Lote de retrieval_ids anteriores, confirmado separadamente antes desta ação. Exige outcome:write; repetir o mesmo uso é seguro. Sem quota extra; omita itens não avaliados.

Continue lendo

O que é MCP?

O padrao que torna Engram possivel.

📡

Um padrao aberto da Anthropic

MCP (Model Context Protocol) e um padrao aberto criado pela Anthropic. Permite que agentes AI se conectem a ferramentas externas e fontes de dados atraves de uma interface simples e universal.

🔌

USB para AI

Pense nele como USB para AI: um padrao, toda ferramenta funciona. Sem integracoes personalizadas, sem SDKs proprietarios, sem dependencia de fornecedor. Se sua ferramenta fala MCP, simplesmente funciona.

🧠

Engram e um servidor MCP

Qualquer ferramenta AI compativel com MCP pode se conectar ao Engram. Claude Code, Cursor, Gemini, Antigravity, Copilot, OpenCode, Windsurf, Devin. Se suporta MCP, suporta Engram.

⚡

Zero esforco de integracao

Sem necessidade de SDK. Sem código de integração personalizado. Basta adicionar Engram à configuração MCP do seu agente e ele recebe 8 novas ferramentas de memória instantaneamente.

Como se conecta

Seu Agente

Claude, Cursor etc.

MCP
➞

Engram

Servidor MCP

guardar/recuperar
➞

Memoria da Equipe

PostgreSQL + pgvector

Workspaces são o limite da equipe

Use um workspace por equipe. Repos organizam a memória de projeto dentro dele. Convide colegas pelo dashboard para cada pessoa ter sua própria chave.

Repo frontend

Ferramentas

Claude CodeCursorCopilot
Memórias45

Repo API

Ferramentas

Claude CodeWindsurf
Memórias128

Repo mobile

Ferramentas

CursorDevin
Memórias67

O que um workspace significa

  • ✓O workspace é o limite de memória privada de uma equipe ou empresa.
  • ✓Repos e projetos organizam memórias dentro desse limite.
  • ✓Convide colegas pelo dashboard para cada pessoa usar uma chave separada.
  • ✓Agentes do mesmo workspace podem reutilizar lições privadas entre repos.
  • ✓Workspaces diferentes ficam isolados; a memória pública ainda pode enriquecer resultados.
workspace-sync.sh
$ engram_get_context({ repo: "api-backend" })

Comece na frente, nao do zero

Cada novo espaço de trabalho começa com 100.000 memórias públicas com fonte sobre ferramentas de agentes, MCP, RAG/busca, segurança, operações, documentação de engenharia e produto/devex.

100K
Memórias públicas
7
Famílias de fontes
20
Guias de skills
🔄
330+
Padrões
Abordagens comprovadas
Padrões

Abordagens comprovadas para tarefas comuns. Exemplo: "Padrao de rota API: wrapper try-catch, validar entrada, verificar auth, depois logica de negocios." Padroes dizem COMO fazer algo do jeito certo.

📏
170+
Convenções
Regras e padroes da equipe
Convenções

Regras da equipe e padroes de codificacao. Exemplo: "Sempre use migracoes Prisma, nunca SQL ALTER TABLE direto." Convencoes mantem seu codigo consistente.

⚠️
155+
Armadilhas
Armadilhas e surpresas
Armadilhas

Coisas que quebram ou surpreendem. Exemplo: "async/await dentro de forEach NAO funciona como esperado. Use for...of." Armadilhas economizam horas de depuracao.

🔧
215+
Soluções
Correcoes testadas
Soluções

Correcoes testadas em batalha para problemas comuns. Exemplo: "Incompatibilidade de hidratacao no Next.js: use useEffect para logica apenas do cliente." Solucoes dao a resposta, nao apenas a dica.

📦
100+
Dependencias
Especificas do framework
Dependencias

Conhecimento especifico de versao para frameworks. Exemplo: "Prisma 7 requer padrao de adaptador PrismaPg." Dependencias previnem surpresas de atualizacao.

🎓
20
Guias de Habilidades
Guias passo a passo
Guias de Habilidades

Guias passo a passo para tarefas complexas. Exemplo: "Habilidade de Revisao de Codigo: 15 passos desde puxar o branch ate aprovar." Habilidades dao ao seu agente expertise sob demanda.

Fontes: Cobertura: React, Next.js, Vue, Angular, Python, Go, Rust, TypeScript, PostgreSQL, Docker, Kubernetes, AWS e mais de 25 tecnologias. Mais habilidades de negocios: Gestao de Produtos, Vendas, Marketing, RH, Juridico, Financas e mais.

Outros agentes começam vazios. O seu começa com 100.000 memórias públicas com fonte, 20 guias passo a passo e uma memória privada do time que cresce desde o primeiro dia.

Dois bancos de memória. Um agente inteligente.

Conhecimento público para todos. Conhecimento privado para sua equipe.

🌍
100K

Banco público de memória

  • ✓100.000 memórias públicas com fonte
  • ✓Ferramentas de agentes, MCP, RAG/busca, segurança, operações e devex
  • ✓20 guias passo a passo
  • ✓Padrões de boas práticas, armadilhas conhecidas, soluções e verificações de evidência
  • ✓Atualiza conforme o banco público cresce
  • ✓Disponible para todos los usuarios de Engram
Gratis en todos los planes
🔒
isolado

Banco privado de memória

  • ✓Conhecimento próprio da sua equipe
  • ✓Convenções específicas do seu código
  • ✓Decisiones internas de arquitectura
  • ✓Aprendizajes de incidentes y post-mortems
  • ✓Nunca compartilhado fora do seu workspace
  • ✓Isolado, criptografado e limitado ao workspace
Tu ventaja competitiva
El agente hace recall
↓
Busca primero en privado
↓
Enriquece con público
↓
Mejores resultados combinados
Recall combinado

Memória privada primeiro. O conhecimento público preenche as lacunas.

Engram busca primeiro o conhecimento do seu espaço de trabalho e, quando ajuda, adiciona práticas públicas com fonte e guias.

engram_start

Suporte e feedback

Ajude-nos a melhorar o Engram

Se o setup está confuso, uma ferramenta age estranho ou um limite de preço parece errado, escreva aqui. A mensagem chega direto até nós.

Suporte e feedback

O que devemos melhorar?

Bugs, passos de setup confusos, dúvidas de preço e ideias de produto chegam direto ao time Engram.

Verifique seu e-mail antes de seu feedback chegar à nossa equipe. Isso não cria uma conta.

Faltam 10 caracteres0/4000