Guia de Configuração

Adicione memória persistente em nuvem ao seu agente IA de código em 2 minutos. Funciona com Claude Code, Cursor, Windsurf e qualquer agente compatível com MCP.

Pré-requisitos

✓Um token API gratuito de agent-memo.ai — agent-memo.ai
✓Node.js 18+ (para npx)
✓Um agente compatível com MCP (Claude Code, Cursor, Windsurf, etc.)

Obtenha seu token API

Cadastre-se gratuitamente, depois copie seu token API do painel.

Criar conta gratuita

Adicione a configuração ao seu projeto

Selecione seu agente abaixo. A localização do arquivo de configuração e os recursos variam por agente.

.mcp.json

{
  "mcpServers": {
    "agent-memo": {
      "command": "npx",
      "args": ["-y", "@agent-memo/mcp-client"],
      "env": {
        "AGENTMEMO_TOKEN": "your-token-here",
        "AGENTMEMO_PROJECT": "my-project"
      }
    }
  }
}

.claude/settings.local.json

{
  "hooks": {
    "SessionStart": [{
      "matcher": "startup",
      "hooks": [{
        "type": "command",
        "command": "npx -y @agent-memo/mcp-client --hook recall",
        "timeout": 30
      }]
    }],
    "Stop": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "npx -y @agent-memo/mcp-client --hook save",
        "timeout": 30
      }]
    }],
    "PreCompact": [{
      "hooks": [{
        "type": "command",
        "command": "npx -y @agent-memo/mcp-client --hook precompact",
        "timeout": 30
      }]
    }]
  }
}

Hooks salvam contexto automaticamente em momentos-chave — é isso que torna Claude Code + Agent-Memo totalmente automático.

SessionStart: recupera memórias quando uma nova sessão começa.

Stop: salva contexto importante periodicamente.

PreCompact: salva informações críticas antes da compressão da janela de contexto.

Variáveis de ambiente

Variável	Obrigatório	Descrição
AGENTMEMO_TOKEN	Sim	Seu token API do painel
AGENTMEMO_PROJECT	Não	ID do projeto. Detectado automaticamente pelo URL remoto do git ou nome do diretório se omitido

Comece a programar

Inicie seu agente IA. Agora ele tem 14 ferramentas de memória disponíveis. Verifique com:

memory_stats()

> Conectado. 0 memórias armazenadas.

Ferramentas disponíveis (14)

Memória (7)

memory_store — Salvar uma memória
memory_recall — Busca semântica
memory_overview — Visão geral rápida no início da conversa
memory_expand — Expandir detalhes de uma memória
memory_update — Atualizar existente
memory_delete — Remover memória
memory_stats — Estatísticas de uso

Grafo de Conhecimento (5)

kg_add — Adicionar relacionamento de entidade
kg_query — Consultar relacionamentos
kg_invalidate — Invalidar fatos
kg_timeline — Ver histórico de fatos
kg_stats — Estatísticas do grafo

Descoberta (2)

memory_list_topics — Navegar por tópicos
memory_check_duplicate — Deduplicar antes de salvar

Let your agent do it

Send the setup guide URL to your agent and it will configure everything automatically:

https://agent-memo.ai/setup.md