# Conectar VS Code a Nodary

El agente de GitHub Copilot en VS Code puede leer las especificaciones y decisiones de tu equipo en Nodary y escribir en ellas, con tus permisos.

Comprobado con la documentación de cada proveedor el 22 de octubre de 2026.

## Antes de empezar

- VS Code con GitHub Copilot. En Copilot Free, Pro, Pro+ y Max, ninguna directiva de organización rige los servidores MCP.
- En Copilot Business y Enterprise, la directiva MCP servers in Copilot de la organización debe estar activada; viene desactivada por defecto. Una lista de permitidos de la empresa también puede limitar los servidores que añades.
- Una cuenta de Nodary. El servidor MCP está en todos los planes; en Free, mientras el espacio de trabajo siga dentro del plan: 1 proyecto, 10 documentos y carpetas, 2 miembros. Copilot no gasta Cometas: usa su propio modelo.

¿Aún no tienes espacio? Crea uno y vuelve aquí para conectarte. [Crear un espacio gratis](https://nodary.ai/sign-up)

## Añadir Nodary

1. Abre la paleta de comandos (Ctrl+Mayús+P, o Cmd+Mayús+P en Mac) y ejecuta MCP: Add Server.
2. Elige HTTP (HTTP or Server-Sent Events) e introduce la dirección del servidor:

   ```
   https://nodary.ai/api/mcp
   ```
3. Escribe nodary como ID del servidor.
4. Elige Global y luego Copilot Global para usar Nodary en todos tus espacios de trabajo. VS Code lo escribe en ~/.copilot/mcp-config.json:

   ```
   {
     "mcpServers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp",
         "tools": [
           "*"
         ]
       }
     }
   }
   ```
5. Cuando el servidor arranque, acepta las solicitudes de confianza y de inicio de sesión: la página de consentimiento de Nodary se abre en tu navegador.

**Configuraciones antiguas:** VS Code sigue leyendo .vscode/mcp.json y el mcp.json de tu perfil de usuario, que usan servers en vez de mcpServers, y los marca como obsoletos.

## Iniciar sesión y elegir los espacios

La página de consentimiento de Nodary indica la app que pide acceso y la dirección a la que volverá. Inicia sesión si hace falta y elige los espacios de trabajo a los que Copilot podrá llegar: con un solo espacio, lo seleccionas; con varios, ninguno viene marcado, así que marca cada uno que Copilot pueda usar. Si iniciaste sesión hace más de 10 minutos, Nodary vuelve a pedirte la contraseña. Aprueba, y el navegador te devuelve a Copilot.

Copilot actúa entonces como tú: ve y cambia solo lo que tu rol permite, en los espacios marcados. Su acceso dura 60 minutos cada vez y Copilot lo renueva solo.

## Usar Nodary en Copilot Chat

En Copilot Chat, comprueba que las herramientas de Nodary están activadas (Configure Tools, o Chat: Open Customizations y luego Tools) y pide las cosas con tus palabras. Algunas peticiones para empezar:

- Lee el documento de diseño de la API en Nodary y comprueba este endpoint con él.
- Escribe un registro de decisión sobre el paso a Postgres, guárdalo en Arquitectura y enlázalo con la especificación.
- ¿Qué documentos del proyecto Backend siguen siendo borradores y quién es su responsable?

## Con una clave de API en su lugar

Añade el encabezado a ~/.copilot/mcp-config.json, un archivo de tu carpeta personal que nunca versionas:

```json
{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer gdc_..."
      },
      "tools": [
        "*"
      ]
    }
  }
}
```

**En claro:** VS Code no lee de este archivo variables que se pidan al usuario, así que la clave queda escrita tal cual. Dale una caducidad de 30 o 90 días y revócala en Nodary si pierdes el ordenador.

Crea la clave en Nodary, en Perfil, Claves de API y MCP. Empieza por gdc_, se muestra una sola vez, actúa con tus permisos, puede limitarse a un proyecto y caduca a los 30, 90 o 365 días, o nunca, como elijas.

![La sección Claves de API y MCP de un perfil de Nodary: la dirección del servidor MCP para pegar en un cliente de IA, y una clave de agente con su alcance.](https://nodary.ai/marketing/mcp-connect.webp)

## Si algo no funciona

- VS Code dice que una restricción de empresa bloquea el servidor: pregunta a tu administrador por la directiva MCP servers in Copilot y la lista de permitidos de la empresa.
- No aparece ningún inicio de sesión: ejecuta MCP: List Servers, reinicia nodary y acepta las solicitudes. Si el inicio de sesión sigue sin terminar, usa una clave de API.
- Que una primera petición reciba la respuesta 401 es normal: le dice al cliente dónde iniciar sesión.
- quota_locked: el espacio de trabajo supera el plan Free tras su prueba y queda bloqueado hasta que el propietario se suscribe. Después vuelve a funcionar al instante.
- billing_locked: un pago falló, así que el espacio de trabajo queda bloqueado hasta que el propietario lo resuelva en la facturación del espacio. Vuelve a funcionar en cuanto se cobra el pago.
- workspace_suspended: Nodary ha suspendido el espacio de trabajo y nada llega a él, ni siquiera los agentes. El propietario puede escribir a support@nodary.ai.
- workspace_required: la conexión llega a varios espacios de trabajo, así que indica en cuál trabajar, o vuelve a conectar marcando solo uno.

## Preguntas

### ¿Conectar Copilot cuesta algo?

No por parte de Nodary. El servidor MCP está en todos los planes, Free incluido dentro de sus límites, y Copilot no gasta Cometas: las Cometas solo cuentan Studio AI. Tu plan de Copilot decide si puedes añadir el servidor.

### Copilot Business dice que los servidores MCP están desactivados. ¿Qué hago?

Un administrador de la organización o de la empresa activa la directiva MCP servers in Copilot, desactivada por defecto. Copilot Free, Pro, Pro+ y Max no dependen de ella.

### ¿Necesito instalar Node.js u otra cosa?

No. Nodary es un servidor remoto: VS Code habla con él por HTTPS y no se ejecuta nada en tu ordenador.

### ¿Puede Copilot borrar o sobrescribir mis documentos?

Solo donde tu rol lo permite, y un cambio se puede deshacer: cada sesión de edición de hasta diez minutos forma una versión, igual que cada escritura de un agente. Un documento conserva sus 50 versiones más recientes hechas por personas y sus 50 más recientes hechas por agentes (las de los agentes nunca desplazan las de las personas), que comparas y restauras, y un documento borrado vuelve durante 30 días. Los enlaces para compartir, los accesos, los miembros, los roles, las claves, la facturación y borrar un proyecto siguen siendo decisiones humanas: ningún agente puede tomarlas.

### ¿Cómo lo desconecto?

En Nodary, abre Perfil, Seguridad, Aplicaciones conectadas y desconéctalo: se detiene al instante. En VS Code, quita nodary de ~/.copilot/mcp-config.json o detenlo desde MCP: List Servers. Una clave se revoca en Perfil, Claves de API y MCP, y los propietarios y administradores pueden revocar cualquier clave del espacio en sus ajustes, en MCP.

### ¿Usa Nodary mis documentos para entrenar IA?

No. Nodary no usa el contenido de los espacios de trabajo para entrenar modelos de IA. Lo que Copilot hace con lo que lee depende de las condiciones de su fabricante.

## Sigue leyendo

- [Conectar Cursor a Nodary](https://nodary.ai/es/docs/mcp/cursor): Añade Nodary al mcp.json de Cursor e inicia sesión desde Cursor.
- [Conectar Claude Code a Nodary](https://nodary.ai/es/docs/mcp/claude-code): Un comando añade Nodary a Claude Code y /mcp inicia tu sesión.
- [El servidor MCP de Nodary](https://nodary.ai/es/docs/mcp): El servidor, el inicio de sesión, las 98 herramientas, la seguridad y todos los clientes de un vistazo.
- [MCP (Model Context Protocol)](https://nodary.ai/es/glossary/model-context-protocol): Model Context Protocol (MCP) es un estándar abierto que conecta las aplicaciones de IA con herramientas y datos externos mediante una interfaz común.
- [OAuth](https://nodary.ai/es/glossary/oauth): OAuth es un estándar que permite a una aplicación actuar por ti en otro servicio, con el acceso que apruebas, sin ver nunca tu contraseña.

https://nodary.ai/es/docs/mcp/vs-code