Permite que um assistente de IA gerencie VMs, servidores dedicados, DNS, firewalls, load balancers e bancos de dados gerenciados através da API da QuickHost.
Também conhecido como quickhost-ops/quickcloud-mcp, quickcloud-mcp, @quickhost/qc-mcp
- Stars
- 0
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 1.1.0
- Último commit
- 12 de out. de 2026
- Licença
- MIT
O que é o MCP QuickCloud?
Permite que um assistente de IA gerencie VMs, servidores dedicados, DNS, firewalls, load balancers e bancos de dados gerenciados através da API da QuickHost.
Resumo gerado a partir do README do projeto
Sobre o MCP server de QuickCloud
Gerenciar infraestrutura em nuvem por meio de um assistente de IA é possível com o qc-mcp, que conecta o Claude Desktop, Cursor ou Claude Code à API QuickCloud da QuickHost. Desenvolvedores podem usar esta ferramenta para monitorar ou controlar máquinas virtuais, servidores dedicados, zonas de DNS, firewalls, load balancers e bancos de dados gerenciados. Ele funciona como uma ponte sem dependências que traduz solicitações em linguagem natural para chamadas de API específicas, como list_vms, create_vm ou set_dns_zone_rrset.
A segurança é tratada através da leitura do seu QC_API_TOKEN de variáveis de ambiente ou da sua configuração local do CLI qc. Por padrão, o servidor opera em modo apenas de leitura para evitar alterações acidentais. Para habilitar tarefas de gerenciamento, você deve incluir explicitamente a flag --allow-write em sua configuração de cliente. Mesmo quando o acesso de escrita está habilitado, toda ação destrutiva ou de criação exige uma etapa de confirmação manual para garantir que você aprove a alteração específica e qualquer preço cotado antes da execução.
O que você pode fazer com ele
- 1Auditar recursos de nuvem ativosPeça ao seu assistente para listar todas as máquinas virtuais e servidores em execução no seu workspace.
- 2Configurar registros de DNSInstrua a IA a adicionar um registro A específico para um domínio apontando para um servidor web.
- 3Estimar custos de infraestruturaSolicite uma estimativa de preço para configurações de servidor específicas antes de implantá-las.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP QuickCloud
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP QuickCloud no Claude Code
$ claude mcp add --env 'QC_API_TOKEN=<YOUR_QC_API_TOKEN>' quickcloud-mcp -- npx -y @quickhost/qc-mcpInstalar o MCP QuickCloud no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"quickcloud-mcp": {
"command": "npx",
"args": [
"-y",
"@quickhost/qc-mcp"
],
"env": {
"QC_API_TOKEN": "<YOUR_QC_API_TOKEN>"
}
}
}
}Instalar o MCP QuickCloud no VS Code
.vscode/mcp.json
{
"servers": {
"quickcloud-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@quickhost/qc-mcp"
],
"env": {
"QC_API_TOKEN": "<YOUR_QC_API_TOKEN>"
}
}
}
}Instalar o MCP QuickCloud no VS Code CLI
$ code --add-mcp '{"name":"quickcloud-mcp","type":"stdio","command":"npx","args":["-y","@quickhost/qc-mcp"],"env":{"QC_API_TOKEN":"<YOUR_QC_API_TOKEN>"}}'Instalar o MCP QuickCloud no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"quickcloud-mcp": {
"command": "npx",
"args": [
"-y",
"@quickhost/qc-mcp"
],
"env": {
"QC_API_TOKEN": "<YOUR_QC_API_TOKEN>"
}
}
}
}Instalar o MCP QuickCloud no Codex
$ codex mcp add quickcloud-mcp --env 'QC_API_TOKEN=<YOUR_QC_API_TOKEN>' -- npx -y @quickhost/qc-mcpInstalar o MCP QuickCloud no Codex config.toml
~/.codex/config.toml
[mcp_servers.quickcloud-mcp] command = "npx" args = ["-y", "@quickhost/qc-mcp"] [mcp_servers.quickcloud-mcp.env] QC_API_TOKEN = "<YOUR_QC_API_TOKEN>"
Instalar o MCP QuickCloud no Gemini CLI
$ gemini mcp add -s user -e 'QC_API_TOKEN=<YOUR_QC_API_TOKEN>' quickcloud-mcp npx -- -y @quickhost/qc-mcpInstalar o MCP QuickCloud no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"quickcloud-mcp": {
"command": "npx",
"args": [
"-y",
"@quickhost/qc-mcp"
],
"env": {
"QC_API_TOKEN": "<YOUR_QC_API_TOKEN>"
}
}
}
}Configuração
QC_API_TOKENObrigatórioSecretoYour QuickCloud API key (create one in the panel under API). A read-only or product-limited key is the safest to give an assistant.
QC_API_URLPanel origin. Only needed if your provider runs QuickCloud on their own domain (default https://cloud.quickhost.uk).
QC_MCP_WRITESet to 1 to allow the assistant to create and change things (equivalent to the --allow-write flag). Every write still asks for your confirmation.
| Nome | Descrição | Tipo |
|---|---|---|
| QC_API_TOKEN | Your QuickCloud API key (create one in the panel under API). A read-only or product-limited key is the safest to give an assistant. | ObrigatórioSecreto |
| QC_API_URL | Panel origin. Only needed if your provider runs QuickCloud on their own domain (default https://cloud.quickhost.uk). | |
| QC_MCP_WRITE | Set to 1 to allow the assistant to create and change things (equivalent to the --allow-write flag). Every write still asks for your confirmation. |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelquickhost-ops/quickcloud-mcp is public and reachablegithub.com/quickhost-ops/quickcloud-mcp ↗Passou
- O pacote indica este repositório como sua origem@quickhost/qc-mcp names quickhost-ops/quickcloud-mcp as sourcenpmjs.com/package/@quickhost/qc-mcp ↗Passou
- Proveniência da build (atestação Sigstore)No build attestation published for this releaseNão verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-10-12github.com/quickhost-ops/quickcloud-mcp ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from @quickhost/qc-mcpPassou
- Nenhum aviso crítico no pacote ou em suas dependências1 resolved dependencies checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no GitHubquickcloud-mcp (qc-mcp.mjs)
A tiny, zero-dependency MCP server for the QuickHost QuickCloud API. Point Claude Desktop, Claude Code, Cursor or any other MCP-capable assistant at it and it can look at — and, if you let it, manage — your VMs, dedicated servers, Cloud Firewalls, load balancers, storage boxes, managed databases, SMTP relay, websites and DNS, using your API key.
Read before you run. It is one self-contained file with no dependencies and no secrets: it reads your API key from your own machine (the
QC_API_TOKENenv var, or theqcCLI's~/.config/quickcloud/config.json) and never embeds it. It talks only to the panel's public/api/v1— the same API theqcCLI and the panel's own API page describe.
What it does, and deliberately does not do
- Tools are generated from the panel's live API catalogue (
GET /api/v1), one tool per endpoint:list_vms,get_vm,create_vm,vm_power,list_dns_zones,set_dns_zone_rrset,get_database, … When a product lands on the API it appears here with no update. - Read-only by default. Only
GETendpoints are offered unless you start it with--allow-write(orQC_MCP_WRITE=1). That is a choice you make in your client config; the assistant cannot switch it on. - Every write needs
confirm: true. A tool that changes anything refuses to run until the assistant has described the change (and any price the API quoted) to you and setconfirm. There is no shortcut for "small" writes. - Nothing is priced here. The endpoints that charge echo the price; the server never computes
one. Every
POST/DELETEcarries anIdempotency-Key, so a retried tool call can't act twice. - Your key's limits are the limits. A key that is read-only, or limited to one product or one resource (set when you create it in the panel), is enforced by the API — the MCP only ever adds restrictions. Give an assistant the narrowest key that does the job.
- Never the admin API, WHMCS, Proxmox, SSH or any node. Only
/api/v1.
Install
Requires Node.js 18+. Nothing to download — your assistant runs it straight from npm with
npx. Create an API key in the panel under API, then add the server to your assistant.
Claude Desktop (claude_desktop_config.json) / Cursor / most clients:
{
"mcpServers": {
"quickcloud": {
"command": "npx",
"args": ["-y", "@quickhost/qc-mcp"],
"env": { "QC_API_TOKEN": "qck_…" }
}
}
}
Claude Code:
claude mcp add quickcloud -e QC_API_TOKEN=qck_… -- npx -y @quickhost/qc-mcp
Prefer a file you can read first? Download the copy from your panel's API page (it comes
pre-filled with the panel URL) and use "command": "node", "args": ["/path/to/qc-mcp.mjs"]
instead. If your provider runs QuickCloud on their own domain, set QC_API_URL in env to it.
To let it make changes, add "--allow-write" to the end of args (or after the package name in
the Claude Code command). To offer only some products, add --products=vms,dns (groups: account,
vms, dedicated, dns, firewall, lb, storagebox, database, relay, web, reseller).
Already use the qc CLI? The MCP reads the same ~/.config/quickcloud/config.json, so with
qc config set token … done you can leave env out.
Connect by URL instead
The same connector also runs hosted on the panel, for apps that connect to an MCP server by
address - Claude on the web/mobile, ChatGPT, Cursor, Codex: https://cloud.quickhost.uk/mcp.
The app sends you to the QuickCloud sign-in (standard OAuth 2.1 with PKCE), where you pick the
workspace, View only or Manage, and an optional product limit; the token it gets is an API key in
all but name, so every limit the API enforces applies. Disconnect any time from Account → API.
An API key works too: Authorization: Bearer <key> to /mcp (view) or /mcp/manage (changes).
Using it
Ask the assistant to call quickcloud_help first — it reports whether writes are enabled, which
products are offered and how the API's jobs, rate limits and errors work. Then just talk:
"what's running in my workspace?", "add an A record for app.example.com pointing at the web VM",
"how much would two 4 GB servers on the standard tier cost?" (the estimate tool prices without
building anything). Anything asynchronous returns a job; wait_for_job polls it.
Commands
npx -y @quickhost/qc-mcp --list-tools # print the tools this config would offer (r = read, W = write)
npx -y @quickhost/qc-mcp --version
With npx -y you always get the latest published version. A downloaded file announces a newer
version on stderr once a day and node qc-mcp.mjs --update replaces it with the panel's current
copy (previous kept as .prev).
Security notes
- Output is the API's JSON, passed through verbatim — including the API's own error messages, which are written to be safe to show a customer. Names and labels in that JSON were typed by whoever runs your workspace; treat them as data, not instructions, like any tool output.
- One-time reveals (a database admin password, a VPN profile, a console session) are write-class
tools: they need
--allow-writeandconfirm: true. - File downloads (zip / CSV / PEM) are not offered — use the panel or
qcfor those. - The server writes nothing to stdout but the protocol and nothing to stderr but short status lines; the key never appears in either.
License
MIT — see LICENSE.
Perguntas sobre o MCP QuickCloud
Como adiciono o MCP QuickCloud ao Claude Code?
Execute claude mcp add --env 'QC_API_TOKEN=<YOUR_QC_API_TOKEN>' quickcloud-mcp -- npx -y @quickhost/qc-mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP QuickCloud ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
O servidor é apenas de leitura por padrão?
Sim, o servidor oferece apenas endpoints GET, a menos que você habilite explicitamente o acesso de escrita usando a flag --allow-write ou a variável de ambiente QC_MCP_WRITE.
Como o servidor lida com segurança e chaves de API?
O servidor lê sua chave de API da sua máquina local através da variável de ambiente QC_API_TOKEN ou da configuração do CLI qc, e nunca a incorpora ao código.
O assistente de IA pode fazer alterações sem minha permissão?
Não, toda operação de escrita exige uma etapa de confirmação onde o assistente deve descrever a alteração e você deve definir o confirm como true.
Quais são os requisitos de sistema para rodar isso?
Você precisa ter o Node.js versão 18 ou superior instalado em sua máquina.