Visão geral do MCP

Conecte o XMemo ao seu ambiente de IA

O XMemo oferece memória persistente de projetos para Claude, ChatGPT, Codex, GitHub Copilot, OpenClaw, Hermes, DeepSeek Harness, Microsoft Agent Framework e runtimes abertos de agentes de IA. Os clientes se conectam diretamente ao endpoint Streamable HTTP hospedado ou por meio do proxy stdio oficial xmemo-mcp, incluído em @xmemo/client.

• Claude no claude.ai e Claude Desktop (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration; Directory listing pending): Conector personalizado em https://xmemo.dev/mcp com OAuth; nenhuma API key no conector (/docs/mcp/claude).
• Claude (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): Fluxos de trabalho de memória, pontos de verificação de ciclo de vida e continuidade entre agentes para Claude Code e Cowork (/docs/mcp/claude-code).
• ChatGPT (Axis A: Hosted beta pilot; Evidence required for any refreshed external claim · Axis B: Manual MCP Configuration; Marketplace pending): Fluxos de trabalho de memória e espaços de trabalho interativos (TODO Board, Ledger, Project Workspace) (/docs/mcp/chatgpt).
• Codex (Axis A: Config supported; Evidence required · Axis B: Manual MCP Configuration): Memória de projeto guiada por Skill e autorização MCP (/docs/mcp/codex).
• OpenClaw (Axis A: Released; Pilot tested · Axis B: Official Marketplace, Native Integration): Orientação de habilidades com prioridade para Recall além de um plugin nativo de memória OpenClaw no ClawHub (/docs/connect/openclaw).
• Hermes (Axis A: Released; Pilot tested · Axis B: Native Integration): Plug-in de memória nativo do Hermes (hermes-xmemo) no PyPI com pontos de verificação de sessão e captura automática (/docs/connect/hermes).
• DeepSeek Harness (Axis A: Released; Pilot tested · Axis B: Native Integration): Plug-in nativo de harness de agente dsh (dsh-xmemo) no npm para memória de loop de execução de CLI (/docs/connect/deepseek-harness).
• Microsoft Agent Framework (Disponibilidade: planejada; publicação do pacote pendente · Modo de integração: integração nativa): integração comunitária independente para recuperação de contexto em Python e captura opcional; não é um produto nem uma distribuição oficial da Microsoft (/docs/connect/microsoft-agent-framework).
• GitHub Copilot & VS Code (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): Integração MCP para agentes de IDE e CLI (/docs/mcp/copilot).
• Gemini CLI (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): Configuração com prioridade para OAuth sem colocar credenciais Bearer em settings.json.

Dois eixos ortogonais de entrega: disponibilidade e modo de distribuição

As integrações de clientes são classificadas ao longo de dois eixos independentes: Axis A representa a prontidão empírica e o status de disponibilidade (Released, Pilot / Entitled, ou Planned), enquanto Axis B define o modo de integração e distribuição (Official Marketplace, Community Directory, Native Integration ou Manual MCP Configuration). O canal de entrega não determina a disponibilidade, e os recursos do roteiro permanecem estritamente diferenciados dos runtimes de produção.

• Axis A (Availability / Evidence Status): Released (totalmente operacional em produção), Pilot / Entitled (piloto beta hospedado ou autorização comercial necessária), Planned (itens do roteiro que exigem divulgação prospectiva explícita).
• Axis B (Integration / Distribution Mode): Official Marketplace (listagens revisadas por fornecedores, como a skill oficial do ClawHub), Community Directory (listagens de índices de terceiros), Native Integration (suporte de runtime incorporado), Manual MCP Configuration (snippets JSON configurados pelo usuário).

Quatro caminhos de conexão unificados

Escolha o caminho de conexão correspondente à arquitetura do seu cliente e ao seu modelo operacional:

• Caminho 1 (Peça ao seu agente — Skill independente): Para agentes compatíveis (Claude Code, Codex). Instala o Skill verificado no diretório de skills do cliente via https://xmemo.dev/skill/install.
• Caminho 2 (MCP hospedado via OAuth): Para clientes desktop e hospedados (ChatGPT, conector personalizado do Claude no claude.ai e no Claude Desktop, Cursor, VS Code Copilot). Conecta https://xmemo.dev/mcp sem tratamento manual de tokens.
• Caminho 3 (MCP direto com XMEMO_KEY): Para executores headless e ambientes de CI. Passa tokens Bearer com segurança por meio de variáveis de ambiente locais via Streamable HTTP.
• Caminho 4 (Proxy stdio oficial (first-party) — xmemo-mcp): Para clientes desktop somente stdio, configurações do Claude Desktop que não usam o conector personalizado ou ferramentas sem suporte direto a Streamable HTTP. O pacote oficial da CLI @xmemo/client fornece o xmemo-mcp (executável via npx -y -p @xmemo/client xmemo-mcp ou xmemo mcp serve) como um proxy stdio local independente que faz a ponte para o serviço hospedado (https://xmemo.dev).

Configuração de cliente OAuth

A URL hospedada é toda a configuração; a concessão fornece os escopos.

{
  "servers": {
    "XMemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp"
    }
  }
}

Configuração com token direto

Executores headless que não podem concluir o OAuth leem o token do ambiente em vez disso.

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "transport": "streamable-http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "${XMEMO_AGENT_ID}",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Configuração de proxy stdio oficial (first-party) (xmemo-mcp)

No Claude Desktop, comece pelo conector personalizado com OAuth (/docs/mcp/claude); esta configuração com API key é a alternativa. Para clientes que utilizam apenas stdio, o pacote oficial da CLI @xmemo/client inclui o xmemo-mcp como um proxy stdio local independente que faz a ponte para https://xmemo.dev. Cole sua API key real; o Claude Desktop não expande variáveis ${env:...}:

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "@xmemo/client",
        "xmemo-mcp"
      ],
      "env": {
        "XMEMO_KEY": "<your-xmemo-api-key>",
        "XMEMO_URL": "https://xmemo.dev"
      }
    }
  }
}

Superfícies de ferramentas qualificadas por perfil

As ferramentas disponíveis são qualificadas por perfil de acordo com os recursos do cliente em config/mcp-documentation-contract.json:

• Perfil do Cursor (cursor-plugin): fornece ferramentas para resolução de conflitos, snapshots e Cloud Skills.
• Perfil do ChatGPT (chatgpt-public): fornece ferramentas para espaços de trabalho interativos (TODO Board, Ledger, Project Workspace).
• Perfil público do Claude (claude-public): fornece ferramentas para memória de projeto, resumos de livro-razão e recuperação ativa.
• Perfil de plug-in do Claude (claude-plugin): fornece ferramentas para snapshots, registros de decisões e continuidade de projeto.
• Perfil público genérico (generic-public): fornece ferramentas para clientes MCP padrão.

Integrações candidatas e distribuição não verificada

O XMemo acompanha integrações emergentes de clientes e extensões de editor por meio de evidências verificadas. Os seguintes caminhos candidatos permanecem não verificados ou com revisão pendente pelos mantenedores; nenhuma disponibilidade em marketplace ou endosso oficial é reivindicada:

• Extensão nativa do VS Code (xmemo-vscode): O repositório de origem (yonro/xmemo-vscode @ bf08e7c237, v0.1.1) e os fluxos de trabalho de CI existem, mas a publicação no Visual Studio Marketplace não foi confirmada e o Open VSX retornou 404. Os usuários devem conectar o VS Code por meio da configuração verificada de MCP hospedado ou Copilot Chat (/docs/mcp/copilot) em vez de pacotes de extensão não verificados.
• Cindy Ghost Plugin (xmemo-cindy-plugin): O candidato a plug-in Ghost (yonro/xmemo-cindy-plugin @ 0cbbac5a53, v1.0.0) continua pendente de revisão pelos mantenedores, sem GitHub Releases públicas ou canais de distribuição verificados observados.
• Shared Skills Package (@xmemo/skills): Embora a fonte do repositório exista, a consulta pública do npm retornou 404; use o Skill independente verificado (@xmemo/skill) em vez disso.

Deixe o runner se configurar

Um executor autônomo pode buscar sua própria predefinição em vez de solicitar que um humano insira valores de identidade.

curl -s https://xmemo.dev/api/v1/mcp/config/autonomous-agent