Kinsta MCP

Servidor del Protocolo de Contexto de Modelo (MCP) para el alojamiento WordPress de Kinsta

Documentación

Servidor MCP de Kinsta

Un servidor de Protocolo de Contexto de Modelo (MCP) para la plataforma de alojamiento WordPress de Kinsta.

Este servidor permite que los asistentes de IA (como Claude) interactúen con tus sitios e infraestructura de Kinsta de forma segura a través de la API de Kinsta.

Es compatible con MCP 2026-07-28 y sigue siendo compatible con clientes stdio anteriores.

Inicio Rápido

Requisitos Previos

Node.js v22 o superior
Una cuenta de Kinsta con acceso a la API
Una clave de API de Kinsta (consulta Generar una Clave de API)

Paso 1: Genera una Clave de API de Kinsta

Inicia sesión en MyKinsta
Ve a Tu nombre > Configuración de la empresa > Claves de API
Haz clic en Crear clave de API
Elige una fecha de expiración y asigna un nombre a la clave
Haz clic en Generar y copia la clave (solo se muestra una vez)

También necesitarás tu ID de empresa, que puedes encontrar en MyKinsta en la configuración de la empresa.

Paso 2: Configura tu Cliente MCP

Elige la configuración que coincida con tu cliente MCP:

Claude Desktop (Recomendado)

Agrega a tu claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kinsta": {
      "command": "npx",
      "args": ["-y", "kinsta-mcp"],
      "env": {
        "KINSTA_API_KEY": "your-api-key",
        "KINSTA_COMPANY_ID": "your-company-id"
      }
    }
  }
}

Claude Code (CLI)

Agrega a la configuración de MCP de Claude Code (~/.claude/mcp.json o a nivel de proyecto):

{
  "mcpServers": {
    "kinsta": {
      "command": "npx",
      "args": ["-y", "kinsta-mcp"],
      "env": {
        "KINSTA_API_KEY": "your-api-key",
        "KINSTA_COMPANY_ID": "your-company-id"
      }
    }
  }
}

Cursor

En la configuración de Cursor, agrega un servidor MCP:

{
  "mcpServers": {
    "kinsta": {
      "command": "npx",
      "args": ["-y", "kinsta-mcp"],
      "env": {
        "KINSTA_API_KEY": "your-api-key",
        "KINSTA_COMPANY_ID": "your-company-id"
      }
    }
  }
}

Referencia de Configuración

Variables de Entorno

Variable	Requerida	Predeterminado	Descripción
`KINSTA_API_KEY`	Sí	-	Clave de API de Kinsta (token Bearer)
`KINSTA_COMPANY_ID`	Sí	-	Tu ID de empresa de Kinsta
`KINSTA_API_BASE_URL`	No	`https://api.kinsta.com/v2`	URL base de la API (anulación para pruebas)

Características

Herramientas

El servidor proporciona 101 herramientas que cubren la API de Kinsta 1.110.0.

Cambio importante en 1.1.0: los nombres de las herramientas usan guiones bajos en lugar de puntos para que funcionen en clientes con validación estricta de nombres MCP. Por ejemplo, kinsta.sites.list ahora es kinsta_sites_list.

Conectividad

Herramienta	Descripción
`kinsta_ping`	Verifica el estado del servidor y la configuración de credenciales de la API

Autenticación

Herramienta	Descripción
`kinsta_auth_validate`	Valida la clave de API de Kinsta actual y devuelve información de la cuenta si es válida

Operaciones

Herramienta	Descripción
`kinsta_operations_status`	Verifica el estado de una operación asíncrona de Kinsta por ID de operación

Empresa

Herramienta	Descripción
`kinsta_company_users`	Lista todos los usuarios de tu empresa de Kinsta
`kinsta_company_regions`	Lista todas las regiones de implementación disponibles para tu empresa
`kinsta_company_api-keys`	Lista todas las claves de API de tu empresa de Kinsta
`kinsta_company_activity-logs`	Lista los registros de actividad de la empresa (admite filtrado y paginación)
`kinsta_company_plugins`	Lista los plugins de WordPress en todos los sitios (admite búsqueda/filtro/paginación)
`kinsta_company_themes`	Lista los temas de WordPress en todos los sitios (admite búsqueda/filtro/paginación)

Sitios

Herramienta	Descripción
`kinsta_sites_list`	Lista todos los sitios de WordPress (opcionalmente incluye detalles del entorno)
`kinsta_sites_get`	Obtiene detalles de un sitio específico de Kinsta por ID
`kinsta_sites_create`	Crea un nuevo sitio de WordPress (devuelve un `operation_id`)
`kinsta_sites_create-plain`	Crea un nuevo sitio simple (vacío) sin WordPress instalado (devuelve un `operation_id`)
`kinsta_sites_clone`	Clona un sitio existente (devuelve un `operation_id`)
`kinsta_sites_delete`	Elimina un sitio de Kinsta permanentemente (no se puede deshacer)
`kinsta_sites_reset`	Restablece un sitio a una instalación nueva de WordPress (destructivo)

Entornos

Herramienta	Descripción
`kinsta_environments_list`	Lista todos los entornos de un sitio
`kinsta_environments_create`	Crea un nuevo entorno de WordPress para un sitio (devuelve un `operation_id`)
`kinsta_environments_create-plain`	Crea un nuevo entorno simple (vacío) para un sitio (devuelve un `operation_id`)
`kinsta_environments_clone`	Clona un entorno existente (devuelve un `operation_id`)
`kinsta_environments_push`	Empuja un entorno a otro (destructivo; devuelve un `operation_id`)
`kinsta_environments_delete`	Elimina un entorno (no se puede deshacer)
`kinsta_environments_php-allocation`	Cambia la asignación de trabajadores PHP para un entorno (devuelve un `operation_id`)
`kinsta_environments_php-allocation-site`	Cambia la asignación de trabajadores PHP para todos los entornos de un sitio (devuelve un `operation_id`)
`kinsta_environments_webroot`	Cambia la subcarpeta de la raíz web para un entorno (devuelve un `operation_id`)
`kinsta_environments_files`	Lista archivos en el sistema de archivos de un entorno
`kinsta_environments_redirects`	Lista reglas de redirección para un entorno (admite filtrado/paginación)
`kinsta_environments_redirects_update`	Crea, actualiza o elimina reglas de redirección para un entorno
`kinsta_environments_ssh_status`	Obtiene el estado de SSH/SFTP para un entorno
`kinsta_environments_ssh_toggle`	Habilita o deshabilita el acceso SSH/SFTP para un entorno
`kinsta_environments_ssh_password-access`	Habilita o deshabilita el acceso por contraseña SSH
`kinsta_environments_ssh_generate-password`	Genera una nueva contraseña SSH/SFTP
`kinsta_environments_ssh_password`	Obtiene la contraseña SSH/SFTP actual
`kinsta_environments_ssh_ip-allowlist`	Obtiene la lista de permitidos de IP SSH
`kinsta_environments_ssh_ip-allowlist_update`	Actualiza la lista de permitidos de IP SSH
`kinsta_environments_ssh_config`	Obtiene la configuración de conexión SSH para un entorno
`kinsta_environments_ssh_password-expiration`	Cambia el intervalo de expiración de la contraseña SSH
`kinsta_environments_wp-cli`	Ejecuta un comando WP-CLI en un entorno (debe comenzar con `wp` )
`kinsta_environments_phpmyadmin`	Obtiene un token de inicio de sesión de phpMyAdmin para un entorno
`kinsta_environments_wpa_login-url`	Crea una URL de inicio de sesión de administrador de WordPress para un usuario existente
`kinsta_environments_wpa_create-user`	Crea un usuario administrador de WordPress
`kinsta_environments_wpa_user-exists`	Verifica si existe un usuario administrador de WordPress

Herramientas del Sitio

Herramienta	Descripción
`kinsta_tools_clear-cache`	Limpia la caché del servidor para un entorno (devuelve un `operation_id`)
`kinsta_tools_restart-php`	Reinicia PHP para un entorno (devuelve un `operation_id`)
`kinsta_tools_php-version`	Cambia la versión de PHP para un entorno (devuelve un `operation_id`)
`kinsta_tools_denied-ips`	Obtiene la lista de direcciones IP denegadas (bloqueadas) para un entorno
`kinsta_tools_denied-ips_update`	Actualiza la lista de direcciones IP denegadas (bloqueadas) para un entorno
`kinsta_tools_force-https_get`	Obtiene el estado de Forzar HTTPS para un entorno
`kinsta_tools_force-https_set`	Establece el estado de Forzar HTTPS para un entorno
`kinsta_tools_search-and-replace`	Previsualiza o realiza una búsqueda y reemplazo en la base de datos

Plugins y Temas

Herramienta	Descripción
`kinsta_plugins_list`	Lista todos los plugins de un entorno
`kinsta_plugins_update`	Actualiza un solo plugin (devuelve un `operation_id`)
`kinsta_plugins_bulk-update`	Actualiza varios plugins a la vez (devuelve un `operation_id`)
`kinsta_plugins_list-wp`	Lista plugins con detalles del repositorio de WordPress.org
`kinsta_themes_list`	Lista todos los temas de un entorno
`kinsta_themes_update`	Actualiza un solo tema (devuelve un `operation_id`)
`kinsta_themes_bulk-update`	Actualiza varios temas a la vez (devuelve un `operation_id`)
`kinsta_themes_list-wp`	Lista temas con detalles del repositorio de WordPress.org

Dominios

Herramienta	Descripción
`kinsta_domains_list`	Lista todos los dominios personalizados de un entorno
`kinsta_domains_add`	Agrega un dominio personalizado a un entorno
`kinsta_domains_delete`	Elimina dominios personalizados de un entorno
`kinsta_domains_verification`	Obtiene registros de verificación DNS para un dominio
`kinsta_domains_set-primary`	Establece el dominio principal de un entorno

DNS (Kinsta DNS)

Herramienta	Descripción
`kinsta_dns_domains`	Lista todos los dominios DNS de tu empresa
`kinsta_dns_records`	Lista registros DNS de un dominio
`kinsta_dns_records_create`	Crea un nuevo registro DNS
`kinsta_dns_records_update`	Actualiza un registro DNS existente
`kinsta_dns_records_delete`	Elimina un registro DNS

Caché de Borde y CDN

Herramienta	Descripción
`kinsta_edge-cache_clear`	Limpia la caché de edge para un entorno (devuelve un `operation_id`)
`kinsta_edge-cache_toggle`	Habilita o deshabilita el almacenamiento en caché de edge para un entorno
`kinsta_cdn_clear-cache`	Limpia la caché de CDN para un entorno (devuelve un `operation_id`)
`kinsta_cdn_image-optimization`	Configura los ajustes de optimización de imágenes de CDN

Usuarios SFTP

Herramienta	Descripción
`kinsta_sftp-users_list`	Lista cuentas de usuario SFTP/SSH adicionales para un entorno
`kinsta_sftp-users_toggle`	Habilita o deshabilita cuentas SFTP/SSH adicionales
`kinsta_sftp-users_add`	Añade una nueva cuenta de usuario SFTP/SSH adicional
`kinsta_sftp-users_remove`	Elimina una cuenta de usuario SFTP/SSH adicional

Copias de seguridad

Herramienta	Descripción
`kinsta_backups_list`	Lista todas las copias de seguridad de un entorno
`kinsta_backups_downloadable`	Lista copias de seguridad descargables para un entorno
`kinsta_backups_create`	Crea una copia de seguridad manual (devuelve un `operation_id`)
`kinsta_backups_restore`	Restaura un entorno desde una copia de seguridad (destructivo; devuelve un `operation_id`)
`kinsta_backups_delete`	Elimina una copia de seguridad (no se puede deshacer)
`kinsta_backups_create-downloadable`	Crea una copia de seguridad descargable
`kinsta_backups_next-downloadable`	Obtiene cuándo se puede crear la próxima copia de seguridad descargable

Analítica

Herramienta	Descripción
`kinsta_analytics_visits`	Obtiene analítica de visitantes para un entorno en un rango de fechas
`kinsta_analytics_visits-usage`	Obtiene analítica de uso de visitantes (visitas facturables)
`kinsta_analytics_bandwidth`	Obtiene analítica de ancho de banda para un entorno en un rango de fechas
`kinsta_analytics_bandwidth-usage`	Obtiene analítica de uso de ancho de banda (ancho de banda facturable)
`kinsta_analytics_cdn-bandwidth`	Obtiene analítica de ancho de banda de CDN para un entorno en un rango de fechas
`kinsta_analytics_cdn-bandwidth-usage`	Obtiene analítica de uso de ancho de banda de CDN (ancho de banda de CDN facturable)
`kinsta_analytics_disk-space`	Obtiene analítica de uso de espacio en disco para un entorno
`kinsta_analytics_top-countries`	Obtiene los principales países de visitantes
`kinsta_analytics_top-cities`	Obtiene las principales ciudades de visitantes
`kinsta_analytics_top-client-ips`	Obtiene las principales direcciones IP de clientes
`kinsta_analytics_top-asns`	Obtiene los principales números de sistemas autónomos
`kinsta_analytics_top-browsers`	Obtiene los principales navegadores
`kinsta_analytics_top-hosts`	Obtiene los principales hosts
`kinsta_analytics_top-referrers`	Obtiene los principales referidores
`kinsta_analytics_top-uas`	Obtiene los principales agentes de usuario
`kinsta_analytics_visits-dispersion`	Obtiene la dispersión de visitas
`kinsta_analytics_response-codes`	Obtiene el desglose de códigos de respuesta

Registros

Herramienta	Descripción
`kinsta_logs_get`	Obtiene el contenido de los archivos de registro de un entorno

Recursos

El servidor expone datos como recursos MCP:

Recursos estáticos

URI del recurso	Descripción
`kinsta://sites`	Lista todos los sitios de WordPress en tu empresa de Kinsta
`kinsta://regions`	Lista las regiones de implementación disponibles

Plantillas de recursos

URI del recurso	Descripción
`kinsta://sites/{site_id}`	Detalles de un sitio específico
`kinsta://sites/{site_id}/environments`	Entornos de un sitio específico

Prompts

El servidor proporciona prompts guiados para flujos de trabajo comunes:

Prompt	Descripción
`deploy-site`	Guía para crear un nuevo sitio de WordPress en Kinsta
`manage-backups`	Guía para flujos de trabajo de listado, creación, restauración, descarga y eliminación de copias de seguridad
`push-environment`	Guía para enviar cambios entre entornos (por ejemplo, de staging a producción)
`setup-domain`	Guía para añadir un dominio personalizado a un entorno de Kinsta

Desarrollo

Configuración

# Clone the repo
git clone https://github.com/jacob-hartmann/kinsta-mcp.git
cd kinsta-mcp

# Use the Node.js version from .nvmrc
# (macOS/Linux nvm): nvm install && nvm use
# (Windows nvm-windows): nvm install 22 && nvm use 22
nvm install
nvm use

# Install dependencies
pnpm install

# Copy .env.example and configure
cp .env.example .env
# Edit .env with your API key and company ID

Ejecución local

# Development mode (auto-reload)
pnpm dev

# Production build
pnpm build

# Production run
pnpm start

Depuración

Puedes usar el Inspector de MCP para depurar el servidor:

# Run from source
pnpm inspect

# Run from built output
pnpm inspect:dist

pnpm inspect carga .env automáticamente mediante dotenv (consulta .env.example).

Si ves Ignored build scripts: esbuild..., ejecuta pnpm approve-builds y permite esbuild. En CI instalamos dependencias con los scripts de ciclo de vida deshabilitados (pnpm install --ignore-scripts) y luego reconstruimos explícitamente solo esbuild para el trabajo de compilación de producción.

Contribuciones

¡Las contribuciones son bienvenidas! Consulta CONTRIBUTING.md para conocer las pautas sobre cómo contribuir a este proyecto.

Seguridad

Consulta SECURITY.md para conocer la política de seguridad y cómo reportar vulnerabilidades.

Soporte

Este es un proyecto comunitario proporcionado "tal cual" sin soporte garantizado. Consulta SUPPORT.md para más detalles.