Devin Desktop (formerly Windsurf)

Pré-requisito

Use o Devin Desktop (anteriormente Windsurf) com suporte direto a configurações MCP. O Devin Desktop conecta-se diretamente usando um token de portador apoiado pelo ambiente com XMEMO_KEY no transporte Streamable HTTP configurado via serverUrl.

• Endpoint: https://xmemo.dev/mcp.
• Transporte: Streamable HTTP (configurado usando serverUrl).
• Modo de autenticação: token de portador direto de XMEMO_KEY.
• Arquivo de configuração: ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json no Windows; instalações anteriores à renomeação usavam ~/.codeium/windsurf/mcp_config.json).
• ID do cliente: windsurf (permanece windsurf para compatibilidade).
• Status de prontidão: Evidências necessárias (marketplace planejado, não certificado).

Instalação / configuração

Configurar manualmente: adicione o bloco do servidor XMemo a ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json no Windows) em mcpServers. Observação: npx @xmemo/client mcp add windsurf atualmente grava o local anterior à renomeação ~/.codeium/windsurf/mcp_config.json (útil apenas para instalações anteriores à renomeação), portanto, os usuários do Devin Desktop devem configurar manualmente ou mover o arquivo. O ID do cliente permanece como windsurf para compatibilidade.

• Cliente direto: configure manualmente em ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json no Windows) com XMEMO_KEY no ambiente.
• Observação: npx @xmemo/client mcp add windsurf atualmente grava o local anterior à renomeação ~/.codeium/windsurf/mcp_config.json (útil apenas para instalações anteriores à renomeação), portanto, os usuários do Devin Desktop devem configurar manualmente ou mover o arquivo.

{
  "mcpServers": {
    "XMemo": {
      "serverUrl": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "windsurf",
        "X-Memory-OS-Agent-Instance-ID": "${env:XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Definir a credencial

Defina XMEMO_KEY no ambiente antes de iniciar o Devin Desktop. Mantenha o token no ambiente em vez de codificá-lo diretamente no arquivo de configuração.

export XMEMO_KEY='<your-xmemo-token>'

Gerar / confirmar XMEMO_AGENT_INSTANCE_ID

Gere um identificador de instância estável e não secreto por instalação local do Devin Desktop para que a atribuição permaneça consistente após reinicializações.

export XMEMO_AGENT_INSTANCE_ID='<stable-local-devin-desktop-instance-id>'
# Persist and reuse this value for the same local install

Preservar o bloco de configuração existente

Use o bloco de configuração renderizado nesta página. Configure manualmente em ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json no Windows). O ID do cliente permanece como windsurf para compatibilidade.

Reiniciar o cliente

Reinicie o Devin Desktop após atualizar ~/.config/devin/mcp_config.json ou o ambiente para que a conexão com o servidor MCP seja estabelecida.

Testar com uma chamada real de recall

Faça a primeira chamada MCP somente para leitura. Esta é uma invocação real de recall, não um placeholder de verificação de integridade, e não grava memória.

recall({ query: "connection check", limit: 1 })

Resposta esperada (formato literal)

Uma chamada bem-sucedida retorna o formato de texto ranqueado público abaixo; a referência e o conteúdo são valores reais do espaço de memória autorizado.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Erros comuns

O Devin Desktop é um cliente de portador direto; verifique as variáveis de ambiente se ocorrerem problemas de conexão.

• 401 invalid_token — XMEMO_KEY está ausente, expirou, foi revogada ou é inválida: verifique XMEMO_KEY no ambiente e reinicie o Devin Desktop.
• 403 insufficient_scope — O token não concede memory:read: emita um token com o escopo necessário.
• Valores inválidos de XMEMO_AGENT_INSTANCE_ID são normalizados para nenhuma atribuição de instância em vez de gerar um erro de autenticação.

Certificação e prontidão

Status de certificação: Evidências necessárias. Status no marketplace: Planejado. Evidências de integração são necessárias antes que a certificação completa seja concedida.

• Status de certificação: Evidências necessárias.
• Status no marketplace: Planejado.
• Nota de prontidão: Consulte /product/docs#client-capability-matrix; configure manualmente em ~/.config/devin/mcp_config.json.