Conecta Hostinger con Claude Code: guía paso a paso con API y MCP

Aprende a conectar Hostinger con Claude Code usando la API y el servidor MCP. Guía paso a paso para gestionar tu hosting compartido sin salir del terminal, sin necesidad de VPS.

conectar-hostinger-con-claude

Juanma Aranda

Si ya usas Claude Code para programar y tienes tu web en Hostinger, conectar ambas herramientas te permite gestionar tu hosting sin salir del terminal. Claude Code puede listar tus dominios, crear bases de datos, instalar WordPress, gestionar registros DNS y mucho más, todo mediante la API de Hostinger y su servidor MCP.

El problema es que casi toda la documentación que existe sobre Claude Code y Hostinger asume que tienes un VPS. Pero la mayoría de creadores y freelancers que conozco están en un plan de hosting compartido, que es lo más económico para empezar. Esta guía cubre exactamente ese caso: cómo conectar tu cuenta de hosting compartido de Hostinger con Claude Code usando la API, sin necesidad de un VPS ni acceso SSH avanzado.

TL;DR: Para conectar Hostinger con Claude Code necesitas generar un token de API en hPanel (Dev Tools > API), instalar el servidor MCP hostinger-api-mcp con npm, y configurarlo en tu archivo .claude.json con el token. Una vez configurado, Claude Code puede gestionar tu hosting compartido directamente desde el terminal.

Qué es el MCP de Hostinger y por qué lo necesitas

Hostinger ha publicado un servidor MCP (Model Context Protocol) oficial que actúa como puente entre Claude Code y la API de Hostinger. Este servidor expone 153 herramientas que cubren seis dominios de la API: billing, DNS, dominios, hosting, reach (email marketing) y VPS.

Para una cuenta de hosting compartido, el dominio que más te interesa es hosting, que incluye 37 herramientas específicas. Con ellas puedes:

  • Listar y gestionar tus sitios web (hosting_listWebsitesV1)
  • Crear bases de datos (hosting_createAccountDatabaseV1)
  • Instalar WordPress automáticamente (hosting_installWordPressV1)
  • Gestionar tareas cron (hosting_listAccountCronJobsV1)
  • Importar sitios WordPress existentes (hosting_importWordpressWebsite)
  • Desplegar aplicaciones Node.js (hosting_deployJsApplication)

El servidor MCP se ejecuta localmente en tu máquina, no en el servidor de Hostinger. Claude Code se comunica con él mediante el protocolo MCP, y el servidor traduce esas peticiones en llamadas a la API REST de Hostinger usando tu token de autenticación.

Requisitos previos

Node.js 20 o superior

El servidor MCP de Hostinger requiere Node.js versión 20 o superior. Para comprobar si ya lo tienes instalado, abre tu terminal y ejecuta:

node --version

Si no lo tienes o la versión es anterior a la 20, descárgalo desde nodejs.org o usa NVM (Node Version Manager) para gestionar varias versiones:

nvm install v24
nvm use v24

Claude Code CLI

Necesitas tener Claude Code instalado y funcionando en tu terminal. Si aún no lo tienes, sigue las instrucciones oficiales en code.claude.com. La instalación se hace con un solo comando:

curl -fsSL https://claude.ai/install.sh | bash

Después, inicia sesión con claude /login y verifica que funciona con claude --version.

Cuenta de Hostinger con acceso a la API

Necesitas una cuenta activa de Hostinger. Si aún no la tienes, puedes aprovechar el código descuento Hostinger con 20% extra que tengo disponible en la web. La API está disponible en todos los planes, incluido el hosting compartido más básico.

Paso 1: Generar tu token de API en hPanel

El primer paso es generar un token de API desde el panel de control de Hostinger (hPanel). Este token es lo que autentica a Claude Code ante la API de Hostinger.

  1. Inicia sesión en tu cuenta de Hostinger y accede a hPanel.
  2. En la barra lateral izquierda, busca la sección Dev Tools y haz clic en API.
  3. Verás una pestaña Claude Code. Selecciónala y elige tu sistema operativo (Mac, Windows o Linux).
  4. En Select MCP tools, marca solo los productos que vas a usar. Para hosting compartido, activa Websites y, si lo necesitas, Domains and DNS. No actives todo.
  5. Haz clic en Generate Token.
  6. Introduce un nombre descriptivo para el token (por ejemplo, «Claude Code MCP») y selecciona una fecha de expiración.
  7. Haz clic en Generate.
  8. Copia el token generado y guárdalo en un lugar seguro. Hostinger no lo volverá a mostrar después de recargar la página.

Hostinger generará automáticamente un bloque de configuración JSON con tu token ya insertado. Puedes copiarlo directamente desde ahí para el siguiente paso.

Paso 2: Instalar el servidor MCP de Hostinger

El servidor MCP se distribuye como un paquete de npm. Instálalo globalmente con tu gestor de paquetes preferido:

npm install -g hostinger-api-mcp

Si usas yarn:

yarn global add hostinger-api-mcp

Si usas pnpm:

pnpm add -g hostinger-api-mcp

Para verificar que se instaló correctamente:

hostinger-api-mcp --help

Deberías ver las opciones disponibles del servidor, incluyendo --http, --host, --port y --login.

Paso 3: Configurar Claude Code con el servidor MCP

Ahora necesitas decirle a Claude Code que use el servidor MCP de Hostinger. Hay dos formas de hacerlo: editando el archivo de configuración manualmente o con un comando de una sola línea.

Opción A: Editar el archivo .claude.json manualmente

Localiza tu archivo de configuración global de Claude Code:

  • Windows: %USERPROFILE%.claude.json
  • Mac/Linux: ~/.claude.json

Abre el archivo y añade la configuración del servidor MCP. Si ya tienes otros servidores MCP configurados, fusiona este bloque dentro del diccionario mcpServers existente:

{
  "mcpServers": {
    "hostinger-hosting": {
      "command": "npx",
      "args": ["--package=hostinger-api-mcp@latest", "hostinger-hosting-mcp"],
      "env": {
        "HOSTINGER_API_TOKEN": "TU_TOKEN_AQUI"
      }
    }
  }
}

En Windows, cambia "command": "npx" por "command": "npx.cmd".

Reemplaza TU_TOKEN_AQUI con el token que generaste en el paso 1. No lo compartas ni lo subas a ningún repositorio público.

Opción B: Comando de una sola línea

Si prefieres no editar archivos manualmente, puedes registrar el servidor MCP directamente desde el terminal con este comando:

claude mcp add hostinger -e HOSTINGER_API_TOKEN=TU_TOKEN -- npx -y hostinger-api-mcp@latest

Sustituye TU_TOKEN por tu token real. Este comando hace exactamente lo mismo que la opción A, pero sin tocar el archivo de configuración a mano.

Paso 4: Reiniciar Claude Code y verificar la conexión

Después de configurar el servidor MCP, reinicia tu sesión de Claude Code. Cierra el terminal y vuelve a abrirlo, o simplemente ejecuta claude de nuevo.

Para verificar que la conexión funciona, prueba con un prompt sencillo:

claude "Lista mis sitios web de Hostinger"

Si todo está bien configurado, Claude Code usará la herramienta hosting_listWebsitesV1 del servidor MCP y te mostrará la lista de sitios web de tu cuenta de hosting compartido.

Otros prompts de prueba que puedes usar:

  • "Muéstrame el estado de mis dominios en Hostinger"
  • "Crea una base de datos MySQL llamada mi_proyecto"
  • "Instala WordPress en mi sitio web principal"
  • "Lista las tareas cron de mi cuenta de hosting"

El límite de 100 herramientas y cómo evitarlo

Hay un detalle importante que la documentación oficial no menciona claramente: la mayoría de modelos de IA, incluido Claude, tienen un límite de aproximadamente 100 herramientas por sesión de trabajo. El servidor MCP completo de Hostinger expone 153 herramientas si activas todos los productos. Si superas el límite, Claude Code puede volverse lento o fallar al cargar las herramientas.

La solución es activar solo los productos que realmente vas a usar. Para una cuenta de hosting compartido, normalmente necesitarás:

  • Websites (gestión de sitios, bases de datos, WordPress, cron)
  • Domains and DNS (si gestionas dominios desde Hostinger)

No actives VPS, Ecommerce ni Email Marketing si no los usas. Puedes volver a hPanel y regenerar la configuración con más productos activos más adelante si lo necesitas.

Qué puedes hacer con Claude Code y tu hosting compartido de Hostinger

Una vez configurada la conexión, estas son algunas de las tareas más útiles que puedes automatizar desde Claude Code:

Gestión de sitios web

Puedes listar tus sitios, crear nuevos, verificar el estado de cada uno y gestionar la configuración de cada sitio web sin entrar en hPanel. Esto es especialmente útil si tienes varios dominios en la misma cuenta de hosting compartido.

Bases de datos MySQL

Claude Code puede crear bases de datos, listar las existentes y gestionar usuarios con permisos. Si estás desarrollando un proyecto y necesitas provisionar una base de datos nueva, puedes hacerlo con un prompt en lenguaje natural en lugar de navegar por hPanel.

Instalación y migración de WordPress

Con las herramientas hosting_installWordPressV1 e hosting_importWordpressWebsite, puedes instalar WordPress en un dominio nuevo o importar un sitio WordPress existente desde otro hosting. Claude Code gestiona todo el proceso a través de la API.

Despliegue de aplicaciones Node.js

Si estás construyendo una aplicación con IA, por ejemplo usando herramientas como Lovable IA para crear una web sin programar, puedes desplegarla en tu hosting compartido de Hostinger con la herramienta hosting_deployJsApplication. Esto te permite tener tu proyecto funcionando sin migrar a un VPS.

Gestión de DNS

Si gestionas tus DNS desde Hostinger, puedes crear, modificar y eliminar registros DNS directamente desde Claude Code. Útil si estás configurando un nuevo dominio o ajustando registros para servicios externos.

Diferencias entre hosting compartido y VPS para Claude Code

Es importante entender qué puedes y qué no puedes hacer con Claude Code en un plan de hosting compartido frente a un VPS:

CaracterísticaHosting compartidoVPS
Gestión vía API de Hostinger (MCP)Sí, 37 herramientas de hostingSí, 62 herramientas de VPS
Instalar Claude Code en el servidorNo (sin acceso root)
SSH para ejecutar Claude Code remotoLimitado (planes Sencillo no tienen SSH)Acceso completo
Crear bases de datos, instalar WordPressSí, vía APISí, vía API o terminal
Desplegar apps Node.jsSí, vía APISí, vía API o terminal
Configurar firewall, snapshots, backupsNo

La diferencia clave es que en hosting compartido gestionas tu cuenta a través de la API de Hostinger (lo que cubre esta guía), mientras que en un VPS puedes además instalar Claude Code directamente en el servidor y trabajar con él por SSH. Para la mayoría de creadores que solo necesitan gestionar sus sitios web, el hosting compartido con la API es más que suficiente.

Si tu plan de hosting compartido es el Sencillo y no tiene acceso SSH, no te afecta para esta guía. La conexión con Claude Code se hace a través de la API, no de SSH. El SSH solo sería necesario si quisieras ejecutar Claude Code dentro del servidor, que no es lo que estamos haciendo aquí.

Problemas comunes y soluciones

Claude Code no reconoce las herramientas de Hostinger

Si después de configurar el servidor MCP Claude Code no encuentra las herramientas de Hostinger, verifica que:

  1. El token de API es correcto y no ha expirado.
  2. El archivo .claude.json tiene la sintaxis JSON válida (sin comas sobrantes ni llaves sin cerrar).
  3. En Windows, estás usando npx.cmd en lugar de npx.
  4. Has reiniciado la sesión de Claude Code después de cambiar la configuración.

Error de autenticación 401

Si recibes un error 401 al intentar usar las herramientas, el token probablemente ha expirado o se ha revocado. Vuelve a hPanel, genera un nuevo token y actualiza la variable HOSTINGER_API_TOKEN en tu configuración.

El servidor MCP no arranca

Si el servidor MCP no se inicia, comprueba que tienes Node.js 20 o superior y que el paquete hostinger-api-mcp se instaló correctamente. Ejecuta hostinger-api-mcp --help para verificar. Si el problema persiste, prueba reinstalar el paquete:

npm uninstall -g hostinger-api-mcp
npm install -g hostinger-api-mcp

Seguridad: buenas prácticas con tu token de API

Tu token de API de Hostinger tiene los mismos permisos que tu cuenta de usuario. Cualquiera que tenga acceso al token puede gestionar tus sitios, dominios y bases de datos. Sigue estas prácticas:

  • No lo subas a repositorios públicos de GitHub o GitLab. Si trabajas con repos, usa variables de entorno o un archivo .env que esté en .gitignore.
  • Usa fechas de expiración cortas si solo necesitas el token para un proyecto temporal.
  • Revoca tokens que no uses desde hPanel > Dev Tools > API.
  • No compartas tu archivo .claude.json con nadie, ya que contiene el token en texto plano.

Conclusión

Conectar Hostinger con Claude Code a través de la API y el servidor MCP es un proceso de 10 minutos que te ahorra horas de gestión manual. No necesitas un VPS ni acceso SSH avanzado: tu plan de hosting compartido ya tiene todo lo necesario. Generas el token en hPanel, instalas el paquete npm, configuras el archivo .claude.json y listo.

Si todavía no tienes cuenta en Hostinger, puedes crear tu cuenta aquí con un 20% de descuento extra. Y si después de configurar la conexión quieres sacarle más partido a Claude Code en tu día a día como creador, echa un vistazo a mi guía sobre ElizaWP, la IA que hace SEO en WordPress automáticamente, o a las mejores herramientas de IA para editar videos que tengo analizadas en la web.

Preguntas frecuentes

¿Necesito un VPS para conectar Hostinger con Claude Code?

No. Esta guía cubre específicamente la conexión con un plan de hosting compartido usando la API de Hostinger y su servidor MCP. El VPS solo es necesario si quieres instalar Claude Code directamente dentro del servidor y trabajar por SSH, que es un caso de uso diferente.

¿Puedo conectar Claude Code a Hostinger sin saber programar?

Sí. El proceso no requiere escribir código. Solo necesitas generar un token en hPanel, instalar un paquete de npm y editar un archivo de configuración JSON. Si sabes copiar y pegar comandos en el terminal, puedes hacerlo.

¿Es seguro dar acceso a Claude Code a mi cuenta de Hostinger?

Sí, siempre que sigas las buenas prácticas de seguridad. El token de API se almacena localmente en tu máquina y solo se usa para autenticar las peticiones a la API de Hostinger. No se envía a terceros. Usa fechas de expiración y revoca los tokens que no uses.

¿La API de Hostinger tiene coste adicional?

No. La API de Hostinger está incluida en todos los planes, incluido el hosting compartido más básico. Actualmente está en fase beta, pero es totalmente funcional y gratuita para los usuarios de Hostinger.

¿Puedo gestionar varios sitios web de Hostinger con Claude Code?

Sí. La herramienta hosting_listWebsitesV1 lista todos los sitios web de tu cuenta, y puedes gestionar cada uno individualmente. Si tienes varios dominios en el mismo plan de hosting compartido, todos serán accesibles desde Claude Code.

¿Qué pasa si activo demasiadas herramientas del MCP?

Si activas más de 100 herramientas, Claude Code puede volverse lento o fallar al cargarlas. Activa solo los productos que vas a usar. Para hosting compartido, normalmente basta con Websites y, opcionalmente, Domains and DNS.