MCP DIAN en tu IDE: guía de configuración para Cursor, VS Code, Windsurf y Zed

Cada IDE implementa el soporte MCP de forma diferente: algunos leen un archivo de configuración en el workspace, otros tienen un panel de configuración gráfico, y algunos requieren una extensión adicional. Esta guía cubre la configuración específica para Cursor, VS Code, Claude Desktop, Windsurf y Zed.

Para entender la arquitectura MCP antes de configurar el IDE, ver Cómo conectar un agente de IA a la DIAN con MCP.

Cursor

Cursor tiene soporte MCP nativo desde la versión 0.43. La configuración se gestiona desde la interfaz gráfica — no requiere editar archivos de configuración manualmente.

Pasos de configuración en Cursor

1. Abrir Settings (Cmd/Ctrl + ,) → buscar MCP en la barra de búsqueda. 2. En la sección MCP Servers, hacer clic en Add Server. 3. Seleccionar el tipo de transporte: SSE (para servidores remotos vía HTTP) o stdio. 4. Ingresar la URL del endpoint y el API key en los campos correspondientes. 5. Guardar — Cursor conecta al servidor y carga las herramientas disponibles.

Verificar la conexión en Cursor

En el panel del agente de Cursor, las herramientas del servidor MCP aparecen listadas bajo el nombre del servidor. Si el servidor no aparece, revisar que la URL no tenga trailing slash y que el API key esté completo. Un servidor SSE activo responde con Content-Type: text/event-stream.

VS Code

VS Code requiere la extensión MCP Client para soportar servidores MCP. Una vez instalada, la configuración se hace mediante un archivo JSON en el workspace.

Instalar la extensión y configurar el servidor

1. En el panel de extensiones, buscar e instalar MCP Client (publisher: microsoft). 2. En la raíz del workspace, crear el archivo .vscode/mcp.json con la siguiente estructura:

{
  "servers": {
    "fiscal-dian": {
      "type": "sse",
      "url": "https://[endpoint-del-servidor]/mcp/co",
      "headers": {
        "Authorization": "Bearer TU_API_KEY"
      }
    }
  }
}

3. VS Code detecta el archivo automáticamente y conecta al servidor. Las herramientas aparecen disponibles para el agente de Copilot en el workspace.

Configuración a nivel de usuario (no solo workspace)

Para que el servidor esté disponible en todos los workspaces, agregar la configuración en Settings → MCP (usuario) en lugar del archivo .vscode/mcp.json. Esto es útil si el mismo servidor se usa en múltiples proyectos.

Claude Desktop

Claude Desktop soporta MCP mediante un archivo de configuración global. A diferencia de los IDEs de desarrollo, Claude Desktop está optimizado para flujos conversacionales, no para integración con código fuente.

Archivo de configuración

Editar claude_desktop_config.json ubicado en:
- macOS/Linux: ~/.config/claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fiscal-dian": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sse"],
      "env": {
        "MCP_SERVER_URL": "https://[endpoint-del-servidor]/mcp/co",
        "MCP_API_KEY": "TU_API_KEY"
      }
    }
  }
}

Verificar herramientas disponibles

Después de reiniciar Claude Desktop, escribir en el chat: «¿Qué herramientas tienes disponibles?» — el agente lista todas las herramientas cargadas desde el servidor con su descripción y parámetros.

Windsurf

Windsurf implementa MCP con soporte SSE nativo. La configuración se realiza desde Settings → AI → MCP Servers. El proceso es similar a Cursor: ingresar la URL del endpoint y el API key en el formulario del panel. Windsurf recarga las herramientas automáticamente sin necesidad de reiniciar.

Zed

Zed soporta MCP a través del archivo de configuración settings.json del editor. Agregar la sección context_servers con la configuración del servidor:

{
  "context_servers": {
    "fiscal-dian": {
      "command": {
        "path": "npx",
        "args": ["-y", "@modelcontextprotocol/server-sse"],
        "env": {
          "MCP_SERVER_URL": "https://[endpoint-del-servidor]/mcp/co",
          "MCP_API_KEY": "TU_API_KEY"
        }
      }
    }
  }
}

En Zed, el servidor aparece como un contexto disponible en el panel del asistente. Las herramientas se invocan desde el asistente de Zed de la misma forma que en otros IDEs.

Comparativa de soporte MCP por IDE

Cursor y Windsurf tienen la experiencia más fluida: configuración gráfica, recarga automática y detección de herramientas sin reinicio. VS Code requiere la extensión adicional pero ofrece la ventaja de la configuración por workspace, útil cuando diferentes proyectos usan diferentes servidores MCP. Claude Desktop es el más sencillo de configurar para flujos conversacionales puros, sin integración con código fuente. Zed es el más minimalista: configuración en JSON, sin interfaz gráfica, orientado a desarrolladores que prefieren control total sobre la configuración.

Preguntas frecuentes

¿Puedo conectar más de un servidor MCP en el mismo IDE?

Sí. Todos los IDEs soportan múltiples servidores MCP simultáneamente. Cada servidor se registra bajo un nombre distinto en el archivo de configuración o en el panel del IDE. El agente tiene acceso a las herramientas de todos los servidores conectados y puede invocarlas en la misma sesión.

¿La configuración MCP se sincroniza entre máquinas?

Depende del IDE. En VS Code, si la configuración está en .vscode/mcp.json dentro del repositorio, se sincroniza con git. Si está en la configuración de usuario, no se sincroniza a menos que uses Settings Sync. En Claude Desktop y Zed, el archivo de configuración es local — hay que replicarlo manualmente en cada máquina.

¿Qué pasa si el servidor MCP no está disponible cuando abro el IDE?

El IDE muestra el servidor en estado desconectado pero no falla el inicio. Las herramientas del servidor no estarán disponibles para el agente hasta que el servidor responda. Cuando el servidor vuelve a estar disponible, la mayoría de los IDEs reconectan automáticamente en el siguiente intento de uso.

¿Puedo usar el mismo API key en múltiples IDEs o máquinas?

Generalmente sí, pero depende de la política del proveedor del servidor MCP. Algunos proveedores limitan el número de conexiones simultáneas por token. Si trabajas en equipo, consulta con el proveedor si necesitas tokens separados por desarrollador o si un token compartido cubre el caso de uso.