Impreza Host

O conector oficial da Impreza Host para gerenciamento de servidores offshore

Documentação

impreza-mcp

Servidor Model Context Protocol para Impreza Host. Permite que ferramentas de codificação com IA (Claude Code, Cursor, Codex CLI, Continue, Zed, ...) implantem aplicativos criados por clientes em VPS Impreza gerenciados sem sair do chat.

Quando você diz "implante isso para mim" ao Claude com este servidor MCP carregado, o Claude chama impreza_deploy_custom diretamente — empacota seu projeto, envia-o, compila e executa no seu VPS Impreza, e reporta de volta a URL.

Status

Superfície completa ativa. Todas as 62 ferramentas disponibilizadas — implantação de aplicativos (14) mais conta + saldo de criptomoedas, catálogo + pedidos, domínios/DNS + registro, faturas, ciclo de vida de VPS com snapshots e backups, servidores dedicados / bare-metal, upgrades de plano e caixas de correio Titan / Google Workspace — com um assistente de configuração que gera trechos de configuração prontos para colar em 5 ferramentas de IA.

O servidor local (npx) e o conector OAuth hospedado expõem as mesmas 62 ferramentas, então nada se perde ao escolher qualquer um dos caminhos.

Ferramenta	Encapsula
Aplicativos e implantações
`impreza_list_servers`	`GET /v1/platform/servers`
`impreza_list_apps`	`GET /v1/platform/apps`
`impreza_list_deployments`	`GET /v1/platform/deployments` + `/custom` (mesclado)
`impreza_deploy_custom`	`POST /v1/platform/deployments/custom` (3 modos)
`impreza_deploy_catalog_app`	`POST /v1/platform/deployments`
`impreza_uninstall_deployment`	`POST .../uninstall`
`impreza_get_logs`	`POST .../logs` (tail síncrono, últimas N linhas)
`impreza_restart_deployment`	`POST .../restart`
`impreza_redeploy_deployment`	`POST .../custom/{id}/redeploy` (reconstrução no local, mesmo domínio)
`impreza_add_onion`	`POST .../onion/add`
`impreza_change_domain`	`POST .../domain`
`impreza_git_webhook_status`	`GET .../custom/{id}/git-webhook`
`impreza_git_webhook_connect`	`POST .../custom/{id}/git-webhook/connect`
`impreza_git_webhook_disconnect`	`POST .../custom/{id}/git-webhook/disconnect`
Conta e saldo
`impreza_account_info`	`GET /v1/account`
`impreza_list_services`	`GET /v1/account/services`
`impreza_topup`	`POST /v1/account/topup` — recarga em BTC / XMR / USDT / TRX
`impreza_topup_status`	`GET /v1/account/topup/{invoice_id}`
`impreza_topup_payment`	`GET /v1/account/topup/{invoice_id}/payment` — endereço de criptomoeda + valor a pagar
Catálogo e pedidos
`impreza_list_products`	`GET /v1/products` — planos + preços (filtro `type=server` para VPS/dedicado)
`impreza_order_vps`	`POST /v1/orders` — compra pelo saldo; nasce implantável (`@agent`); 202 + poll `impreza_list_servers`
Domínios e DNS
`impreza_domain_check`	`GET /v1/domains/check`
`impreza_domain_details`	`GET /v1/domains/{domain}`
`impreza_list_dns`	`GET /v1/domains/{domain}/dns`
`impreza_add_dns_record`	`POST /v1/domains/{domain}/dns`
`impreza_update_dns_record`	`PUT /v1/domains/{domain}/dns`
`impreza_delete_dns_record`	`DELETE /v1/domains/{domain}/dns`
`impreza_set_nameservers`	`PUT /v1/domains/{domain}/nameservers`
Ciclo de vida de VPS (Proxmox)
`impreza_vps_status`	`GET /v1/vps/proxmox/{id}/status`
`impreza_vps_power`	`POST /v1/vps/proxmox/{id}/{start\|shutdown\|reboot\|stop}`
`impreza_vps_list_backups`	`GET /v1/vps/proxmox/{id}/backups`
`impreza_vps_create_backup`	`POST /v1/vps/proxmox/{id}/backups`
`impreza_vps_list_templates`	`GET /v1/vps/proxmox/{id}/templates`
`impreza_vps_reinstall`	`POST /v1/vps/proxmox/{id}/reinstall` — destrutivo (apaga tudo)

Instalação e configuração

Pré-requisitos

Node ≥ 20
Uma conta Impreza Host com chave de API + segredo (clientarea → API Keys; o IP da máquina que executa este MCP server deve estar na lista de permissões da chave)

Instalação única via `npx`

Sem necessidade de instalação global — npx impreza-mcp funciona.

Ou instale globalmente

npm install -g impreza-mcp

Obtenha um trecho de configuração pronto para colar

O caminho mais rápido: pergunte ao próprio binário.

npx impreza-mcp setup --tool claude-code
# also: cursor | continue | zed | codex-cli

O assistente imprime o bloco JSON para colocar na configuração MCP da sua ferramenta de IA + o caminho exato do arquivo + o passo pós-configuração (geralmente "saia completamente e reabra a ferramenta de IA"). Ele NÃO grava no disco — cole você mesmo para não sobrescrever acidentalmente uma configuração existente com outros servidores MCP.

Ou configure manualmente

Claude Code — adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "impreza": {
      "command": "npx",
      "args": ["-y", "impreza-mcp"],
      "env": {
        "IMPREZA_API_KEY": "imp_...",
        "IMPREZA_API_SECRET": "..."
      }
    }
  }
}

Reinicie o Claude Code. As ferramentas aparecem sob o ícone MCP.

Cursor — adicione em ~/.cursor/mcp.json (mesmo formato acima).

Continue — adicione em ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "impreza-mcp"],
          "env": {
            "IMPREZA_API_KEY": "imp_...",
            "IMPREZA_API_SECRET": "..."
          }
        }
      }
    ]
  }
}

Zed — adicione às suas configurações:

{
  "context_servers": {
    "impreza": {
      "command": {
        "path": "npx",
        "args": ["-y", "impreza-mcp"],
        "env": {
          "IMPREZA_API_KEY": "imp_...",
          "IMPREZA_API_SECRET": "..."
        }
      }
    }
  }
}

Uso no chat

Após a configuração, converse com sua IA naturalmente:

"Liste meus servidores Impreza." → chama impreza_list_servers

"Implante este diretório no meu VPS Impreza, exponha via .onion." → empacota o diretório atual como implantação personalizada em modo Dockerfile, envia, implanta com onion=true, reporta o endereço .onion.

"Quais aplicativos estão rodando no meu agente?" → chama impreza_list_deployments filtrado para o servidor correto.

Autenticação e segurança

IMPREZA_API_KEY + IMPREZA_API_SECRET ficam no ambiente de configuração MCP da ferramenta de IA — não em nenhum arquivo no disco pertencente ao impreza-mcp em si. O servidor MCP mantém o segredo apenas em memória e o anexa somente como cabeçalhos de requisição HTTP.

O IP da máquina que executa este servidor MCP (quase sempre seu laptop) deve estar na lista de permissões da chave de API. Gerencie a lista de permissões no seu clientarea Impreza.

Build

npm install
npm run build
# dist/server.js is the entry point

Licença

MIT — veja LICENSE.