# GitHub Copilot

Conecte VS Code y GitHub Copilot a través de la configuración OAuth alojada cuando el host lo admita.

- Canonical: https://docs.xmemo.dev/es/docs/mcp/copilot
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: 89da3a37e97e05ec3cbc29a8fa3f11b3cedd4385b04602234bbe99594d360d2a
- Edition-Digest: 76d042bd1f0e0163cb878fe7927803187269a04fdfc370a82f8eea5be22d3e3f
- Source-Revision: sha256:79ae0e28c58efc497cff8929ba46d7fb7bcfdbf5c9e0b86c939e6f7182cd270b

## Requisitos previos

Utilice VS Code con GitHub Copilot Chat y soporte de MCP. Interfaz y requisitos previos:

- Interfaz concreta: VS Code con extensión GitHub Copilot Chat (ruta OAuth del editor).
- Archivo de configuración: %APPDATA%\Code\User\mcp.json (Windows), ~/Library/Application Support/Code/User/mcp.json (macOS) o ~/.config/Code/User/mcp.json (Linux).
- Utiliza la clave servers en lugar de mcpServers.
- Punto de conexión: https://xmemo.dev/mcp.
- Cuenta: Cuenta válida de XMemo en https://xmemo.dev.

## Instalación / configuración

Edite la configuración de usuario de VS Code mcp.json bajo la clave servers y agregue la URL de XMemo alojada. No utilice la configuración de Copilot CLI aquí; su ruta directa tiene su propia ruta (/docs/mcp/copilot-cli):

- Mantenga la entrada del editor solo con URL.
- La primera llamada a la herramienta abre OAuth en el navegador.
- No agregue un encabezado Authorization a esta entrada de VS Code.

## Establecer la credencial

Sin clave — complete OAuth en el navegador en VS Code / GitHub Copilot Chat. No configure XMEMO_KEY ni pegue un token de portador en mcp.json:

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

## Generar / confirmar XMEMO_AGENT_INSTANCE_ID

El listado revisado de OAuth de VS Code no tiene encabezado de identidad del lado del cliente. No agregue XMEMO_AGENT_INSTANCE_ID a mcp.json; confirme que esta ruta OAuth utilice su atribución administrada por la concesión.

## Conservar el bloque de configuración existente

Utilice el bloque de configuración revisado de VS Code / GitHub Copilot. Conserve la clave servers y la forma OAuth de solo URL; no copie la configuración de portador de Copilot CLI en ella:

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

## Reiniciar el cliente

Recargue la ventana de VS Code (Developer: Reload Window) o reinicie la conexión MCP después de guardar mcp.json para que Copilot lea la definición actual del servidor.

## Probar con una llamada real de recall

Haga que la primera llamada de MCP sea de solo lectura. Esta es una invocación de recall real, no un marcador de posición de verificación de estado, y no escribe memoria.

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

## Respuesta esperada (forma literal)

Una llamada exitosa devuelve la forma de texto clasificado público a continuación; la referencia y el contenido son valores reales del espacio de memoria autorizado.

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

## Primera tarea útil: Ciclo de vida de memoria sintética

Ejercite la tarea completa de memoria sintética dentro de GitHub Copilot Chat:

- 1. Guardar hecho sintético: Pida a Copilot Chat que recuerde la convención ("Demo project timestamps use UTC.") en "projects/demo-onboarding/conventions".
- 2. Transición sin estado: Abra una nueva sesión de chat en GitHub Copilot o recargue la ventana de VS Code.
- 3. Recall con atribución de origen: Consulte "demo project timestamp format". Confirme Reference y Location devueltos.
- 4. Corregir memoria: Actualice la convención al formato ISO 8601 mediante update_memory.
- 5. Limpieza opcional: Borre suavemente la convención a través de forget cuando concluya la verificación.

## Capacidades y herramientas de perfil

GitHub Copilot en VS Code tiene acceso a herramientas calificadas por perfil definidas en el contrato de documentación de MCP para el perfil generic-public:

- Herramientas de memoria principales: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
- Herramientas de espacio de trabajo: get_mcp_identity, get_project_summary, project, todo, open_project_workspace, open_todo_board, ledger, open_ledger.

## Limitaciones y límites

Límites operativos para GitHub Copilot en VS Code:

- Aislamiento del espacio de trabajo: Las operaciones están estrictamente confinadas al espacio de trabajo del usuario autorizado.
- Separación editor/CLI: La sesión OAuth de VS Code no se propaga a las herramientas de terminal externas.
- No mezclar encabezados: No agregue encabezados Authorization a la entrada servers en mcp.json.

## Errores comunes

VS Code / GitHub Copilot Chat utiliza la ruta OAuth del navegador y no debe depurarse con la configuración de token de Copilot CLI:

- invalid_grant — El código de autorización OAuth no es válido, ha caducado o ya se ha utilizado: vuelva a conectar el servidor MCP de VS Code y autorice de nuevo.
- invalid_target — El recurso OAuth no coincide con este servidor MCP: vuelva a conectarse utilizando https://xmemo.dev/mcp.
- 403 insufficient_scope — La concesión no incluye memory:read: apruebe el ámbito requerido y vuelva a conectarse.

## Actualización y eliminación

Procedimientos de mantenimiento para GitHub Copilot:

- Actualización: Recargue la ventana de VS Code después de actualizar la configuración.
- Eliminación: Elimine el bloque xmemo de mcp.json y recargue la ventana de VS Code.

## VS Code / GitHub Copilot

OAuth client: keep only the hosted server URL in mcp.json; first tool call opens browser OAuth, so no XMEMO_KEY or Authorization header belongs in this file.

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