Kinsta MCP

Servidor do Model Context Protocol (MCP) para hospedagem WordPress da Kinsta

Documentação

Servidor Kinsta MCP

Um servidor Model Context Protocol (MCP) para a plataforma de hospedagem WordPress Kinsta.

Este servidor permite que assistentes de IA (como o Claude) interajam com seus sites e infraestrutura Kinsta de forma segura por meio da API Kinsta.

Ele suporta MCP 2026-07-28, mantendo compatibilidade com clientes stdio anteriores.

Início Rápido

Pré-requisitos

Node.js v22 ou superior
Uma conta Kinsta com acesso à API
Uma chave de API Kinsta (veja Gerar uma Chave de API)

Etapa 1: Gerar uma Chave de API Kinsta

Faça login no MyKinsta
Vá para Seu nome > Configurações da empresa > Chaves de API
Clique em Criar Chave de API
Escolha uma expiração e dê um nome à chave
Clique em Gerar e copie a chave (ela é exibida apenas uma vez)

Você também precisará do seu ID da Empresa, que pode ser encontrado no MyKinsta em Configurações da empresa.

Etapa 2: Configurar Seu Cliente MCP

Escolha a configuração que corresponde ao seu cliente MCP:

Claude Desktop (Recomendado)

Adicione ao seu 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)

Adicione às configurações MCP do Claude Code (~/.claude/mcp.json ou nível de projeto):

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

Cursor

Nas configurações do Cursor, adicione um servidor MCP:

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

Referência de Configuração

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
`KINSTA_API_KEY`	Sim	-	Chave de API Kinsta (token Bearer)
`KINSTA_COMPANY_ID`	Sim	-	Seu ID da empresa Kinsta
`KINSTA_API_BASE_URL`	Não	`https://api.kinsta.com/v2`	URL base da API (substituição para testes)

Recursos

Ferramentas

O servidor fornece 101 ferramentas cobrindo a API Kinsta 1.110.0.

Mudança significativa na versão 1.1.0: os nomes das ferramentas usam sublinhados em vez de pontos para funcionarem em clientes com validação estrita de nomes MCP. Por exemplo, kinsta.sites.list agora é kinsta_sites_list.

Conectividade

Ferramenta	Descrição
`kinsta_ping`	Verifica o status do servidor e a configuração das credenciais da API

Autenticação

Ferramenta	Descrição
`kinsta_auth_validate`	Valida a chave de API Kinsta atual e retorna informações da conta se válida

Operações

Ferramenta	Descrição
`kinsta_operations_status`	Verifica o status de uma operação assíncrona Kinsta pelo ID da operação

Empresa

Ferramenta	Descrição
`kinsta_company_users`	Lista todos os usuários da sua empresa Kinsta
`kinsta_company_regions`	Lista todas as regiões de implantação disponíveis para sua empresa Kinsta
`kinsta_company_api-keys`	Lista todas as chaves de API da sua empresa Kinsta
`kinsta_company_activity-logs`	Lista os registros de atividades da empresa (suporta filtragem e paginação)
`kinsta_company_plugins`	Lista plugins WordPress em todos os sites (suporta busca/filtro/paginação)
`kinsta_company_themes`	Lista temas WordPress em todos os sites (suporta busca/filtro/paginação)

Sites

Ferramenta	Descrição
`kinsta_sites_list`	Lista todos os sites WordPress (opcionalmente inclui detalhes do ambiente)
`kinsta_sites_get`	Obtém detalhes de um site Kinsta específico pelo ID
`kinsta_sites_create`	Cria um novo site WordPress (retorna um `operation_id`)
`kinsta_sites_create-plain`	Cria um novo site simples (vazio) sem WordPress instalado (retorna um `operation_id`)
`kinsta_sites_clone`	Clona um site existente (retorna um `operation_id`)
`kinsta_sites_delete`	Exclui um site Kinsta permanentemente (não pode ser desfeito)
`kinsta_sites_reset`	Redefine um site para uma instalação WordPress nova (destrutivo)

Ambientes

Ferramenta	Descrição
`kinsta_environments_list`	Lista todos os ambientes de um site
`kinsta_environments_create`	Cria um novo ambiente WordPress para um site (retorna um `operation_id`)
`kinsta_environments_create-plain`	Cria um novo ambiente simples (vazio) para um site (retorna um `operation_id`)
`kinsta_environments_clone`	Clona um ambiente existente (retorna um `operation_id`)
`kinsta_environments_push`	Envia um ambiente para outro (destrutivo; retorna um `operation_id`)
`kinsta_environments_delete`	Exclui um ambiente (não pode ser desfeito)
`kinsta_environments_php-allocation`	Altera a alocação de workers PHP para um ambiente (retorna um `operation_id`)
`kinsta_environments_php-allocation-site`	Altera a alocação de workers PHP para todos os ambientes de um site (retorna um `operation_id`)
`kinsta_environments_webroot`	Altera a subpasta webroot de um ambiente (retorna um `operation_id`)
`kinsta_environments_files`	Lista arquivos no sistema de arquivos de um ambiente
`kinsta_environments_redirects`	Lista regras de redirecionamento de um ambiente (suporta filtragem/paginação)
`kinsta_environments_redirects_update`	Cria, atualiza ou exclui regras de redirecionamento de um ambiente
`kinsta_environments_ssh_status`	Obtém o status SSH/SFTP de um ambiente
`kinsta_environments_ssh_toggle`	Ativa ou desativa o acesso SSH/SFTP de um ambiente
`kinsta_environments_ssh_password-access`	Ativa ou desativa o acesso por senha SSH
`kinsta_environments_ssh_generate-password`	Gera uma nova senha SSH/SFTP
`kinsta_environments_ssh_password`	Obtém a senha SSH/SFTP atual
`kinsta_environments_ssh_ip-allowlist`	Obtém a lista de permissões de IP SSH
`kinsta_environments_ssh_ip-allowlist_update`	Atualiza a lista de permissões de IP SSH
`kinsta_environments_ssh_config`	Obtém a configuração de conexão SSH de um ambiente
`kinsta_environments_ssh_password-expiration`	Altera o intervalo de expiração da senha SSH
`kinsta_environments_wp-cli`	Executa um comando WP-CLI em um ambiente (deve começar com `wp` )
`kinsta_environments_phpmyadmin`	Obtém um token de login phpMyAdmin para um ambiente
`kinsta_environments_wpa_login-url`	Cria uma URL de login de administrador WordPress para um usuário existente
`kinsta_environments_wpa_create-user`	Cria um usuário administrador WordPress
`kinsta_environments_wpa_user-exists`	Verifica se um usuário administrador WordPress existe

Ferramentas do Site

Ferramenta	Descrição
`kinsta_tools_clear-cache`	Limpa o cache do servidor de um ambiente (retorna um `operation_id`)
`kinsta_tools_restart-php`	Reinicia o PHP de um ambiente (retorna um `operation_id`)
`kinsta_tools_php-version`	Altera a versão do PHP de um ambiente (retorna um `operation_id`)
`kinsta_tools_denied-ips`	Obtém a lista de endereços IP negados (bloqueados) de um ambiente
`kinsta_tools_denied-ips_update`	Atualiza a lista de endereços IP negados (bloqueados) de um ambiente
`kinsta_tools_force-https_get`	Obtém o status de Forçar HTTPS de um ambiente
`kinsta_tools_force-https_set`	Define o status de Forçar HTTPS de um ambiente
`kinsta_tools_search-and-replace`	Visualiza ou executa uma busca e substituição no banco de dados

Plugins e Temas

Ferramenta	Descrição
`kinsta_plugins_list`	Lista todos os plugins de um ambiente
`kinsta_plugins_update`	Atualiza um único plugin (retorna um `operation_id`)
`kinsta_plugins_bulk-update`	Atualiza vários plugins de uma vez (retorna um `operation_id`)
`kinsta_plugins_list-wp`	Lista plugins com detalhes do repositório WordPress.org
`kinsta_themes_list`	Lista todos os temas de um ambiente
`kinsta_themes_update`	Atualiza um único tema (retorna um `operation_id`)
`kinsta_themes_bulk-update`	Atualiza vários temas de uma vez (retorna um `operation_id`)
`kinsta_themes_list-wp`	Lista temas com detalhes do repositório WordPress.org

Domínios

Ferramenta	Descrição
`kinsta_domains_list`	Lista todos os domínios personalizados de um ambiente
`kinsta_domains_add`	Adiciona um domínio personalizado a um ambiente
`kinsta_domains_delete`	Remove domínios personalizados de um ambiente
`kinsta_domains_verification`	Obtém registros de verificação DNS para um domínio
`kinsta_domains_set-primary`	Define o domínio principal de um ambiente

DNS (Kinsta DNS)

Ferramenta	Descrição
`kinsta_dns_domains`	Lista todos os domínios DNS da sua empresa
`kinsta_dns_records`	Lista registros DNS de um domínio
`kinsta_dns_records_create`	Cria um novo registro DNS
`kinsta_dns_records_update`	Atualiza um registro DNS existente
`kinsta_dns_records_delete`	Exclui um registro DNS

Edge Cache e CDN

Ferramenta	Descrição
`kinsta_edge-cache_clear`	Limpar o cache de borda de um ambiente (retorna um `operation_id`)
`kinsta_edge-cache_toggle`	Ativar ou desativar o cache de borda de um ambiente
`kinsta_cdn_clear-cache`	Limpar o cache de CDN de um ambiente (retorna um `operation_id`)
`kinsta_cdn_image-optimization`	Configurar as configurações de otimização de imagem do CDN

Usuários SFTP

Ferramenta	Descrição
`kinsta_sftp-users_list`	Listar contas de usuário adicionais de SFTP/SSH de um ambiente
`kinsta_sftp-users_toggle`	Ativar ou desativar contas adicionais de SFTP/SSH
`kinsta_sftp-users_add`	Adicionar uma nova conta de usuário adicional de SFTP/SSH
`kinsta_sftp-users_remove`	Remover uma conta de usuário adicional de SFTP/SSH

Backups

Ferramenta	Descrição
`kinsta_backups_list`	Listar todos os backups de um ambiente
`kinsta_backups_downloadable`	Listar backups baixáveis de um ambiente
`kinsta_backups_create`	Criar um backup manual (retorna um `operation_id`)
`kinsta_backups_restore`	Restaurar um ambiente a partir de um backup (destrutivo; retorna um `operation_id`)
`kinsta_backups_delete`	Excluir um backup (não pode ser desfeito)
`kinsta_backups_create-downloadable`	Criar um backup baixável
`kinsta_backups_next-downloadable`	Obter quando o próximo backup baixável pode ser criado

Analytics

Ferramenta	Descrição
`kinsta_analytics_visits`	Obter analytics de visitantes de um ambiente em um intervalo de datas
`kinsta_analytics_visits-usage`	Obter analytics de uso de visitantes (visitas faturáveis)
`kinsta_analytics_bandwidth`	Obter analytics de largura de banda de um ambiente em um intervalo de datas
`kinsta_analytics_bandwidth-usage`	Obter analytics de uso de largura de banda (largura de banda faturável)
`kinsta_analytics_cdn-bandwidth`	Obter analytics de largura de banda de CDN de um ambiente em um intervalo de datas
`kinsta_analytics_cdn-bandwidth-usage`	Obter analytics de uso de largura de banda de CDN (largura de banda de CDN faturável)
`kinsta_analytics_disk-space`	Obter analytics de uso de espaço em disco de um ambiente
`kinsta_analytics_top-countries`	Obter principais países de visitantes
`kinsta_analytics_top-cities`	Obter principais cidades de visitantes
`kinsta_analytics_top-client-ips`	Obter principais endereços IP de clientes
`kinsta_analytics_top-asns`	Obter principais números de sistemas autônomos
`kinsta_analytics_top-browsers`	Obter principais navegadores
`kinsta_analytics_top-hosts`	Obter principais hosts
`kinsta_analytics_top-referrers`	Obter principais referenciadores
`kinsta_analytics_top-uas`	Obter principais agentes de usuário
`kinsta_analytics_visits-dispersion`	Obter dispersão de visitas
`kinsta_analytics_response-codes`	Obter detalhamento de códigos de resposta

Logs

Ferramenta	Descrição
`kinsta_logs_get`	Obter conteúdo de arquivos de log de um ambiente

Recursos

O servidor expõe dados como recursos MCP:

Recursos Estáticos

URI do Recurso	Descrição
`kinsta://sites`	Listar todos os sites WordPress na sua empresa Kinsta
`kinsta://regions`	Listar regiões de implantação disponíveis

Modelos de Recursos

URI do Recurso	Descrição
`kinsta://sites/{site_id}`	Detalhes de um site específico
`kinsta://sites/{site_id}/environments`	Ambientes de um site específico

Prompts

O servidor fornece prompts guiados para fluxos de trabalho comuns:

Prompt	Descrição
`deploy-site`	Guia para criar um novo site WordPress na Kinsta
`manage-backups`	Guia para fluxos de trabalho de listagem, criação, restauração, download e exclusão de backups
`push-environment`	Guia para enviar alterações entre ambientes (ex.: staging para produção)
`setup-domain`	Guia para adicionar um domínio personalizado a um ambiente Kinsta

Desenvolvimento

Configuração

# 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

Executando Localmente

# Development mode (auto-reload)
pnpm dev

# Production build
pnpm build

# Production run
pnpm start

Depuração

Você pode usar o Inspetor MCP para depurar o servidor:

# Run from source
pnpm inspect

# Run from built output
pnpm inspect:dist

pnpm inspect carrega .env automaticamente via dotenv (veja .env.example).

Se você vir Ignored build scripts: esbuild..., execute pnpm approve-builds e permita esbuild. No CI, instalamos dependências com scripts de ciclo de vida desativados (pnpm install --ignore-scripts) e depois reconstruímos explicitamente apenas esbuild para o job de build de produção.

Contribuindo

Contribuições são bem-vindas! Consulte CONTRIBUTING.md para diretrizes sobre como contribuir para este projeto.

Segurança

Consulte SECURITY.md para a política de segurança e relato de vulnerabilidades.

Suporte

Este é um projeto da comunidade fornecido "como está" sem suporte garantido. Consulte SUPPORT.md para detalhes.

Kinsta MCP

Documentação

Servidor Kinsta MCP

Início Rápido

Pré-requisitos

Etapa 1: Gerar uma Chave de API Kinsta

Etapa 2: Configurar Seu Cliente MCP

Claude Desktop (Recomendado)

Claude Code (CLI)

Cursor

Referência de Configuração

Variáveis de Ambiente

Recursos

Ferramentas

Conectividade

Autenticação

Operações

Empresa

Sites

Ambientes

Ferramentas do Site

Plugins e Temas

Domínios

DNS (Kinsta DNS)

Edge Cache e CDN

Usuários SFTP

Backups

Analytics

Logs

Recursos

Recursos Estáticos

Modelos de Recursos

Prompts

Desenvolvimento

Configuração

Executando Localmente

Depuração

Contribuindo

Segurança

Suporte

Licença