Recalld

Memória de longo prazo gerenciada para agentes de IA. Fatos evoluem conforme as informações mudam, e os agentes recuperam contexto relevante sem um sistema de memória personalizado.

Ver em recalld.ai

Servidor MCP hospedado

npx add-mcp 'https://eu.recalld.ai/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Integração MCP

O Recalld é fornecido como um servidor MCP nativo. Aponte qualquer cliente compatível com MCP para ele e seu assistente terá ferramentas de memória sem nenhum código de integração.

Endpoint

https://eu.recalld.ai/mcp

Transporte HTTP streamable, sem estado. Use o host para sua região.

Configurar um cliente

{
  "mcpServers": {
    "recalld": {
      "url": "https://eu.recalld.ai/mcp"
    }
  }
}

Essa é toda a configuração. Nenhuma chave vai no arquivo.

Autorização

MCP não usa chaves de API

O endpoint rejeita chaves rcd_. Ele é um recurso protegido por OAuth, e o token precisa vir do próprio servidor de autorização do Recalld.

Na primeira chamada, o servidor responde 401 com um cabeçalho WWW-Authenticate apontando para /.well-known/oauth-protected-resource. Clientes que implementam autorização MCP seguem isso automaticamente: eles descobrem o servidor de autorização, abrem um navegador para você aprovar a conexão e armazenam o token resultante por conta própria.

A aprovação é onde o agente é escolhido. O token está vinculado a um agente, então toda chamada de ferramenta dessa conexão lê e escreve a memória desse agente. Para conectar um segundo agente, autorize uma segunda conexão.

Ferramentas

Ferramenta	Função
memory_add	Ingere turnos de conversa ou documentos na memória.
memory_recall	Recupera fatos relevantes com seleção assistida por LLM. Retorna uma resposta concisa.
memory_search	Recuperação por embeddings sem seleção por LLM. Retorna candidatos para o agente processar.
memory_filters	Lista os tipos de fonte, autores e caminhos de documentos que o agente possui.

Os argumentos espelham os corpos REST. agent_id está ausente em todos os lugares, porque a conexão já o define.

Respondendo a partir de um documento

Ambas as ferramentas de recuperação aceitam os mesmos filtros source_kind, author e path que os endpoints REST. Eles restringem de quais fontes a resposta pode vir, antes da classificação.

Um cliente não consegue adivinhar esses valores, então memory_filters retorna aqueles que o agente realmente possui. Chame-o primeiro e depois passe um de volta. Um filtro que não corresponde a nada retorna nenhum resultado.

thread_id via MCP

memory_add aceita um thread_id opcional de formato livre. Reutilize o mesmo valor para agrupar as memórias de uma sessão, ou omita-o para memória ampla do agente. task_id funciona da mesma forma que na API REST e compartilha descobertas com outros agentes na mesma tarefa.