Configurar el servidor MCP en Cursor, ChatGPT, VS Code y Gemini CLI

Cursor MCP

Cursor integra servidores MCP mediante un bloque JSON en su configuración, lo que permite consultar los 2.875 códigos fiscales —1.186 epígrafes IAE, 1.060 códigos CNAE 2025 y 629 códigos CNAE 2009— directamente desde el panel de chat del editor. Las seis herramientas gratuitas del servidor quedan disponibles en cuanto se guarda la configuración, sin necesidad de clave ni registro previo.

En nuestra página del conector MCP tienes el botón «Añadir a Cursor» que configura el servidor automáticamente. Si prefieres hacerlo de forma manual, el bloque de configuración es el siguiente:

{
  "mcpServers": {
    "conversor-iae-cnae": {
      "type": "streamable-http",
      "url": "https://www.conversoriaecnae.es/api/mcp/mcp"
    }
  }
}

Para activar las cuatro herramientas premium —obligaciones_fiscales, modulos_irpf_iva, consulta_masiva y cuota_reta— añade la cabecera de autorización con la clave del plan Profesional (29 €/mes):

{
  "mcpServers": {
    "conversor-iae-cnae": {
      "type": "streamable-http",
      "url": "https://www.conversoriaecnae.es/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer cvr_tu_clave_api"
      }
    }
  }
}

La documentación oficial de Cursor sobre MCP está disponible en cursor.com/docs/context/mcp.

ChatGPT (Developer Mode)

ChatGPT permite añadir servidores MCP personalizados a través de su modo de desarrollador. Al configurar un conector nuevo con la URL https://www.conversoriaecnae.es/api/mcp/mcp, ChatGPT obtiene acceso a los datos fiscales oficiales de AEAT, INE y BOE. Las herramientas gratuitas como buscar_codigo, detalle_iae o calendario_fiscal se ejecutan sin clave del Conversor IAE CNAE.

Para las herramientas premium del Conversor IAE CNAE, necesitas una clave cvr_ del plan Profesional, obtenible en /api-precios. La documentación oficial de OpenAI no documenta actualmente la configuración de cabeceras de autenticación para conectores MCP; las herramientas premium están disponibles en clientes con soporte de cabeceras, como Cursor, Claude Desktop o Gemini CLI.

La documentación de OpenAI para desarrolladores está disponible en developers.openai.com/api/docs/mcp.

Visual Studio Code (GitHub Copilot en VS Code)

Visual Studio Code integra servidores MCP a través de GitHub Copilot en VS Code. La configuración se realiza en el archivo .vscode/mcp.json del espacio de trabajo (para compartir con el equipo) o en el perfil de usuario (disponible en todos los proyectos mediante el comando «MCP: Open User Configuration»).

{
  "servers": {
    "conversor-iae-cnae": {
      "type": "http",
      "url": "https://www.conversoriaecnae.es/api/mcp/mcp"
    }
  }
}

Las seis herramientas gratuitas del Conversor IAE CNAE quedan activas de inmediato. Para las herramientas premium, usa un cliente con soporte documentado de cabeceras de autenticación, como Cursor, Claude Desktop o Gemini CLI.

La guía completa de configuración está en code.visualstudio.com/docs/copilot/chat/mcp-servers.

Gemini CLI

Gemini CLI soporta el protocolo MCP con transporte Streamable HTTP. La configuración se realiza en el fichero ~/.gemini/settings.json (ámbito usuario) o .gemini/settings.json (ámbito proyecto).

{
  "mcpServers": {
    "conversor-iae-cnae": {
      "httpUrl": "https://www.conversoriaecnae.es/api/mcp/mcp"
    }
  }
}

Para acceder a las cuatro herramientas premium, Gemini CLI soporta cabeceras personalizadas vía el objeto "headers":

{
  "mcpServers": {
    "conversor-iae-cnae": {
      "httpUrl": "https://www.conversoriaecnae.es/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer cvr_tu_clave_api"
      }
    }
  }
}

(Fuente de la configuración de Gemini CLI: google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html)

Acceso premium con X-API-Key

Las herramientas obligaciones_fiscales, modulos_irpf_iva, consulta_masiva y cuota_reta requieren una clave cvr_ que se obtiene al contratar el plan Profesional desde la página api-precios. El método principal de autenticación es la cabecera Authorization con el token Bearer:

Authorization: Bearer cvr_tu_clave_api

Si el cliente admite cabeceras personalizadas pero no el esquema Bearer, existe una alternativa con X-API-Key:

X-API-Key: cvr_tu_clave_api

El plan Profesional cuesta 29 €/mes e incluye 2.000 peticiones diarias con un límite de ráfaga de 30 peticiones por minuto.

¿Y si tu cliente no está aquí?

MCP es un estándar abierto sin restricciones de cliente. Cualquier aplicación que implemente el transporte Streamable HTTP según la especificación MCP puede conectarse al servidor del Conversor IAE CNAE usando la misma URL de transporte y el mismo bloque JSON. La página del conector MCP recoge los listados oficiales donde el servidor está registrado —PulseMCP, Smithery, Glama y mcp.so— así como instrucciones adicionales de conexión.

Si se necesita construir un agente propio o un script personalizado, la guía del protocolo MCP explica los fundamentos del estándar y la guía para conectar Claude muestra el flujo completo de integración con datos fiscales.

Fuentes oficiales

Información elaborada a partir de la documentación oficial de MCP y de las fuentes primarias verificadas el 7 de junio de 2026.

• MCP — Introducción oficial (modelcontextprotocol.io)
• MCP — Arquitectura y transportes oficiales
• Claude — Documentación de conectores
• Cursor — Documentación MCP
• VS Code Copilot — MCP servers
• Conversor IAE CNAE — Servidor MCP (landing page)