MCP

Um servidor Model Context Protocol remoto (Streamable HTTP) que dá ao cliente MCP as tools do conhecimento.

Endpoint

Cada credencial vale para uma organização. Se você participa de mais de uma, use o endereço com o apelido da organização — assim o mesmo cliente mantém as duas conexões ao mesmo tempo, cada uma com sua credencial:

O apelido é o mesmo que aparece na URL do aplicativo, e o endereço pronto para copiar fica em Configurações → Chaves de API de cada organização. Uma credencial usada no endereço de outra organização é recusada com org_mismatch.

O endereço sem organização (https://memoraxapp.com.br/mcp) continua valendo: ali a organização vem da própria credencial. Ele atende bem quem participa de uma só — o que ele não faz é sustentar duas conexões ao mesmo tempo.

Autenticação

Duas opções: OAuth (o cliente se registra sozinho via Dynamic Client Registration) ou Bearer com uma chave de API. Nos dois casos o escopo é por projeto.

Conectar no Claude

1. No Claude (app ou web), abra Configurações → Conectores e escolha Adicionar conector personalizado.
2. Dê um nome (ex.: Memorax) e cole a URL do endpoint: https://memoraxapp.com.br/mcp.
3. Ao ativar, o Claude abre o login do Memorax e a tela de consentimento — escolha quais projetos essa conexão pode ler e autorize.
4. Pronto: as tools passam a aparecer no Claude, escopadas ao que você liberou. (Fluxo OAuth — o Claude se registra sozinho, sem você criar chave.)

Conectar no Claude Code

Adicione o servidor pelo terminal — --transport http é o Streamable HTTP (sse é o formato antigo):

Depois, reabra a sessão (a configuração é lida na abertura) e autorize com /mcp dentro do Claude Code — ou claude mcp login memorax pelo terminal. Para conferir e remover: claude mcp list e claude mcp remove memorax.

Duas organizações ao mesmo tempo

Adicione um conector por organização, com nomes diferentes, cada um apontando para o endereço dela. Como os endereços são diferentes, cada conexão guarda a própria autorização — antes, conectar a segunda organização apagava a primeira em silêncio.

No Claude (aplicativo ou web) vale a mesma ideia: adicione dois conectores personalizados, cada um com o endereço de uma organização. O apelido da organização é o mesmo que aparece na URL do aplicativo, e o endereço pronto para copiar fica em Configurações → Chaves de API de cada uma.

No CLI do Memorax é um comando só: cada memorax login guarda a credencial sob o apelido da organização, e memorax org mostra e troca a organização ativa.

Conectar no Codex

Adicione um servidor MCP remoto na configuração do Codex apontando para https://memoraxapp.com.br/mcp. Autentique com uma chave de API como Bearer (o Codex envia o header em cada requisição).

Conectar com outros agentes

Qualquer cliente que fale MCP via Streamable HTTP (Cursor, Cline, etc.): configure um servidor MCP remoto em https://memoraxapp.com.br/mcp. Autentique por OAuth (se o cliente fizer o fluxo de registro/consentimento) ou por Bearer com uma chave de API.

Tools

Uma tool por rota de /api/v1: mesmos nomes, mesmos parâmetros, mesmos códigos de erro. O projectId aceita o slug do projeto ou o UUID.

• me — org e projetos do token (id, slug, espaços). Comece por aqui.
• buscar — busca híbrida (trechos + score).
• ler_pagina — conteúdo completo de uma página.
• listar_paginas — inventário por tipo/tag.
• relacionadas — vizinhança no grafo (outbound + backlinks).
• backlinks — só quem cita a página.
• dependencias — grafo de dependências do código (wiki técnica).

O guia já vem junto

Todo cliente que conecta recebe, no instructions do servidor (no momento do initialize), o padrão grafo-aware de uso. Ou seja: o agente já “sabe usar bem” as tools sem você instalar nada — a skill é um extra opcional.