Uma memória para todas as suas IAs

Integração MCP

O MemoryFirst expõe um servidor Model Context Protocol (MCP). Qualquer cliente compatível (Claude, ChatGPT, Cursor, LM Studio, um agente próprio) lê e escreve na memória da sua empresa com a sua identidade e com citações verificáveis. Um modelo local sem cliente MCP também pode usá-la: recebe o contexto como texto.

O atalho: peça à sua IA

Se não encontrar o menu de conectores, ou estiver no celular, cole esta mensagem no seu assistente: ele lerá esta página e vai ditar os passos exatos do seu cliente.

https://mcp.memoryfirst.ai Instale isto como conector MCP e me diga os passos exatos para o meu cliente de IA.

Duas formas de conectar

Remoto (recomendado)

Um único endpoint HTTP para todos os clientes e todos os membros da equipe. Não instala nada; funciona no celular e no claude.ai.

https://mcp.memoryfirst.ai

A URL anterior continua funcionando para quem já a tem configurada: https://api.memoryfirst.ai/mcp

Clientes somente stdio

Para clientes que só iniciam processos locais (Claude Desktop antigo, scripts), a ponte de código aberto mcp-remote conecta ao mesmo servidor remoto e entra com OAuth. Não há pacote próprio no npm.

npx -y mcp-remote https://mcp.memoryfirst.ai

Autenticação e identidade

  • Chave de API: para scripts, CLI e agentes. Criada em Configurações → Chaves de API. Enviada como Authorization: Bearer mf_live_…
  • OAuth: para pessoas: o cliente abre a tela de login do MemoryFirst, você entra com sua conta e cada chamada fica assinada com o seu nome e com a IA que a fez. Sem copiar chaves.
  • Equipe: cada membro do workspace tem uma função: proprietário, membro ou somente leitura. Um leitor pode lembrar e perguntar, mas não escrever. Os eventos guardam quem os escreveu (pessoa e modelo).

Configuração por cliente

  • Claude Code: claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai --header "Authorization: Bearer mf_live_…"
  • claude.ai, Claude Desktop, Claude iOS: Configurações → Conectores → Adicionar conector personalizado com a URL acima; o acesso é feito por OAuth.
  • ChatGPT: Configurações → Conectores → Criar com a URL acima. Use as ferramentas search e fetch do conector, além das mf_*.
  • Cursor, VS Code, Windsurf: adicione no arquivo de servidores MCP: { "mcpServers": { "memoryfirst": { "url": "https://mcp.memoryfirst.ai", "headers": { "Authorization": "Bearer mf_live_…" } } } }
  • LM Studio, Open WebUI, Jan: qualquer cliente desktop com suporte a MCP usa a mesma URL e a mesma chave; o modelo que roda na sua máquina lê e escreve na memória da empresa.
  • Agentes próprios: JSON-RPC 2.0 sobre HTTP (initialize, tools/list, tools/call), sem estado. Qualquer SDK de MCP funciona.

Conectar o ChatGPT

  1. No ChatGPT, abra Configurações → Apps e conectores. Se o seu plano exigir para conectores próprios, ative o modo desenvolvedor em Configurações avançadas.
  2. Clique em Criar, dê o nome MemoryFirst, escolha autenticação OAuth e cole como URL do servidor MCP: https://mcp.memoryfirst.ai
  3. O ChatGPT leva você à tela do MemoryFirst: entre com sua conta, escolha o espaço de trabalho, o nível de acesso (Somente leitura vem marcado), o escopo e, se quiser, uma expiração. Clique em Autorizar.
  4. Em um chat, ative o MemoryFirst no menu de ferramentas. O ChatGPT busca com search e fetch e pergunta com mf_query; com Leitura e escrita também pode registrar com mf_record.

Conectar o Claude

  1. No claude.ai, abra Configurações → Conectores → Adicionar conector personalizado e cole a URL (nos planos Team e Enterprise, quem adiciona é um administrador da organização): https://mcp.memoryfirst.ai
  2. Clique em Conectar: a tela do MemoryFirst é aberta. Entre, escolha espaço, nível de acesso, escopo e expiração, e clique em Autorizar.
  3. O conector fica disponível no claude.ai, no Claude Desktop e no app móvel com a mesma conta; ative-o em cada conversa pelo menu de ferramentas.
  4. No Claude Code, adicione o servidor e autorize com /mcp (ou use uma chave de API, como acima): claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai

Deixe sua própria sessão fora das respostas

Se você enviar o cabeçalho X-MemoryFirst-Session com o id da sua sessão do Claude Code, mf_query e search deixam de fora a transcrição dessa mesma sessão, e a resposta não é a pergunta que você acabou de fazer devolvida como eco. É opcional: sem ele nada muda. O valor deve ter de 8 a 128 caracteres entre letras, números, hífen ou sublinhado; qualquer outro é ignorado. O Claude Code expande as referências a variáveis de ambiente na configuração salva a cada vez que conecta, então o id é lido do ambiente da sessão em andamento. No terminal, use aspas simples para que a variável não seja expandida ao adicionar o servidor. Isso depende de o Claude Code expor CLAUDE_CODE_SESSION_ID no ambiente: se a sua versão não expõe, o cabeçalho sai vazio ou sem expandir e o servidor o ignora.

Pela linha de comando (adicione também o cabeçalho Authorization se conectar com uma chave de API):

claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai \
  --header 'X-MemoryFirst-Session: ${CLAUDE_CODE_SESSION_ID}'

Ou no .mcp.json:

{
  "mcpServers": {
    "memoryfirst": {
      "type": "http",
      "url": "https://mcp.memoryfirst.ai",
      "headers": { "X-MemoryFirst-Session": "${CLAUDE_CODE_SESSION_ID}" }
    }
  }
}

O servidor stdio (@memoryfirst/mcp-server) e os hooks do Claude Code já o enviam sozinhos quando conhecem o id da sessão.

O que significa cada nível de acesso

O aplicativo pede um máximo; você decide quanto dar. Ele nunca recebe mais do que a sua função permite: um membro somente leitura não escreve mesmo que escolha escrita.

  • Somente leitura (padrão): consulta a memória: mf_recall, mf_query, mf_projects, mf_state, search e fetch. Não pode registrar eventos, regenerar o estado nem mexer em tarefas.
  • Leitura e escrita: além disso registra decisões e eventos (mf_record), regenera o estado e cria ou atualiza tarefas, assinado com o seu nome. Risco: se a IA ler algo malicioso (um site, um e-mail), poderia ser induzida a gravar dados falsos na sua memória. Conceda apenas ao aplicativo que realmente precisar.
  • Apenas alguns projetos: a conexão só vê os projetos que você marcar. As ferramentas que percorrem o espaço inteiro (search, mf_morning, mf_assets, mf_skills) ficam fechadas para ela; no ChatGPT, pergunte com mf_query indicando o projeto.
  • Expiração: passada a data que você escolher, a conexão deixa de funcionar e o aplicativo precisa pedir permissão de novo.
  • Revogar: no seu painel, Apps conectados lista cada conexão com seu nível, seus projetos, quem a aprovou e seu último uso. Revogar interrompe a renovação e a conexão deixa de funcionar na próxima chamada.

Instalação em um clique

Abre o editor com o servidor já configurado. Na primeira vez que você usar, será pedido que entre com sua conta do MemoryFirst.

Modelos locais sem cliente MCP

Ollama, llama.cpp ou qualquer modelo que só aceite um system prompt: peça o contexto do projeto já limitado a um orçamento de tokens e passe a ele. É o mesmo estado que os demais veem; muda o cliente, não a memória.

# Estado do projeto em markdown, dentro do orçamento pedido
CONTEXT=$(curl -s "https://api.memoryfirst.ai/v1/brain/context?project=lexiel&max_tokens=3000" \
  -H "Authorization: Bearer $MEMORYFIRST_API_KEY")

ollama run llama3.1 --system "$CONTEXT"

No Claude Code isso já está automatizado (contexto ao iniciar, sessão destilada em eventos ao terminar) com @memoryfirst/claude-hooks.

Ferramentas

As mesmas no remoto e no local; a paridade é verificada em testes.

  • mf_recall · decisões, bloqueios, deploys e estado vigente de um projeto
  • mf_query · pergunta em linguagem natural com citações; pode ser limitada por partição e tipo de documento
  • mf_record · grava uma decisão, um bloqueio, um deploy, um contato com cliente; assinada com a sua identidade e a sua IA
  • mf_projects · lista os projetos da memória do workspace, com quantos eventos cada um tem
  • mf_morning · brief das últimas 24 h do workspace, por tipo
  • mf_skills · catálogo de skills compiladas a partir de perguntas repetidas e seu SKILL.md
  • mf_assets · registro de ativos e projetos do workspace
  • mf_state · estado vigente do projeto (o que continua em vigor, não o histórico)
  • search · busca para o conector do ChatGPT
  • fetch · um evento completo por id, para o conector do ChatGPT

Citações verificáveis

Cada resposta de mf_query traz um spanRef por citação: página e caixa em documentos, milissegundos em áudio, id do evento no brain. Seu cliente os mostra como links para a fonte.

{
  "answer": "The contract scope is fixed-fee €4,500.",
  "citations": [
    {
      "sourceType": "doc",
      "spanRef": { "page": 3, "bbox": [120, 450, 380, 60] },
      "snippet": "Fixed fee of €4,500 for the scope defined..."
    },
    {
      "sourceType": "ops",
      "spanRef": { "source": "brain.event:decision_taken:78048c2c-…", "eventId": "chunk:0" },
      "snippet": "Decision (Jose, claude-code): fixed fee confirmed with the client on 12 May."
    }
  ]
}

Esquemas detalhados, códigos de erro e limites por plano, na referência da API. Falta algo? Escreva para hola [at] memoryfirst.ai.