GitHub Copilot

Pré-requisitos

Use o VS Code com GitHub Copilot Chat e suporte a MCP. Interface e pré-requisitos:

• Interface concreta: VS Code com extensão GitHub Copilot Chat (caminho OAuth do editor).
• Arquivo de configuração: %APPDATA%\Code\User\mcp.json (Windows), ~/Library/Application Support/Code/User/mcp.json (macOS) ou ~/.config/Code/User/mcp.json (Linux).
• Usa a chave servers em vez de mcpServers.
• Endpoint: https://xmemo.dev/mcp.
• Conta: Conta válida do XMemo em https://xmemo.dev.

Instalação / configuração

Edite a configuração de usuário do VS Code mcp.json sob a chave servers e adicione a URL hospedada do XMemo. Não use a configuração do Copilot CLI aqui; seu caminho direto possui sua própria rota (/docs/mcp/copilot-cli):

• Mantenha a entrada do editor apenas com URL.
• A primeira chamada de ferramenta abre o OAuth no navegador.
• Não adicione um cabeçalho Authorization a esta entrada do VS Code.

Definir a credencial

Nenhuma chave — conclua o OAuth no navegador no VS Code / GitHub Copilot Chat. Não defina XMEMO_KEY nem cole um token de portador em mcp.json:

No XMEMO_KEY
Complete browser OAuth in VS Code / GitHub Copilot Chat

Gerar / confirmar XMEMO_AGENT_INSTANCE_ID

A listagem OAuth revisada do VS Code não possui cabeçalho de identidade no lado do cliente. Não adicione XMEMO_AGENT_INSTANCE_ID a mcp.json; confirme que este caminho OAuth usa sua atribuição gerenciada pela concessão.

Preservar o bloco de configuração existente

Use o bloco de configuração revisado do VS Code / GitHub Copilot. Preserve a chave servers e o formato OAuth apenas de URL; não copie a configuração de portador do Copilot CLI nele:

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

Reiniciar o cliente

Recarregue a janela do VS Code (Developer: Reload Window) ou reinicie a conexão MCP após salvar mcp.json para que o Copilot leia a definição atual do servidor.

Testar com uma chamada real de recall

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

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

Resposta esperada (formato literal)

Uma chamada bem-sucedida retorna o formato de texto classificado 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>

Primeira tarefa útil: Ciclo de vida de memória sintética

Exercite a tarefa completa de memória sintética dentro do GitHub Copilot Chat:

• 1. Salvar fato sintético: Peça ao Copilot Chat para lembrar da convenção ("Demo project timestamps use UTC.") em "projects/demo-onboarding/conventions".
• 2. Transição sem estado: Abra uma nova sessão de chat no GitHub Copilot ou recarregue a janela do VS Code.
• 3. Recall com atribuição de fonte: Consulte "demo project timestamp format". Confirme Reference e Location retornados.
• 4. Corrigir memória: Atualize a convenção para a formatação ISO 8601 usando update_memory.
• 5. Limpeza opcional: Realize exclusão lógica da convenção por meio de forget quando a verificação for concluída.

Recursos e ferramentas de perfil

O GitHub Copilot no VS Code tem acesso a ferramentas qualificadas por perfil definidas no contrato de documentação do MCP para o perfil generic-public:

• Ferramentas de memória principais: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
• Ferramentas de espaço de trabalho: get_mcp_identity, get_project_summary, project, todo, open_project_workspace, open_todo_board, ledger, open_ledger.

Limitações e limites

Limites operacionais para o GitHub Copilot no VS Code:

• Isolamento do espaço de trabalho: As operações são estritamente confinadas ao espaço de trabalho do usuário autorizado.
• Separação editor/CLI: A sessão OAuth do VS Code não se propaga para ferramentas de terminal externas.
• Não misturar cabeçalhos: Não adicione cabeçalhos Authorization à entrada servers em mcp.json.

Erros comuns

O VS Code / GitHub Copilot Chat usa o caminho OAuth do navegador e não deve ser depurado com as configurações de token do Copilot CLI:

• invalid_grant — O código de autorização OAuth é inválido, expirou ou já foi usado: reconecte o servidor MCP do VS Code e autorize novamente.
• invalid_target — O recurso OAuth não corresponde a este servidor MCP: reconecte usando https://xmemo.dev/mcp.
• 403 insufficient_scope — A concessão não inclui memory:read: aprove o escopo necessário e reconecte.

Atualização e remoção

Procedimentos de manutenção para o GitHub Copilot:

• Atualização: Recarregue a janela do VS Code após atualizar a configuração.
• Remoção: Remova o bloco xmemo de mcp.json e recarregue a janela do VS Code.