Impreza Host

El conector oficial de Impreza Host para la gestión de servidores offshore

Documentación

impreza-mcp

Servidor de Model Context Protocol para Impreza Host. Permite que las herramientas de codificación con IA (Claude Code, Cursor, Codex CLI, Continue, Zed, ...) desplieguen aplicaciones creadas por clientes en VPS gestionados de Impreza sin salir del chat.

Cuando le dices "despliega esto por mí" a Claude con este servidor MCP cargado, Claude llama a impreza_deploy_custom directamente — empaqueta tu proyecto, lo sube, lo compila y lo ejecuta en tu VPS de Impreza, y te devuelve la URL.

Estado

Superficie completa activa. Las 62 herramientas están disponibles — despliegue de aplicaciones (14) más saldo de cuenta y criptomonedas, catálogo y pedidos, dominios/DNS y registro, facturas, ciclo de vida de VPS con instantáneas y copias de seguridad, servidores dedicados / bare-metal, mejoras de plan y buzones de Titan / Google Workspace — con un asistente de configuración que genera fragmentos de configuración listos para pegar para 5 herramientas de IA.

El servidor local (npx) y el conector OAuth alojado exponen las mismas 62 herramientas, por lo que no se pierde nada al elegir cualquiera de las dos vías.

Herramienta	Envuelve
Aplicaciones y despliegues
`impreza_list_servers`	`GET /v1/platform/servers`
`impreza_list_apps`	`GET /v1/platform/apps`
`impreza_list_deployments`	`GET /v1/platform/deployments` + `/custom` (fusionado)
`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` (cola de sincronización, últimas N líneas)
`impreza_restart_deployment`	`POST .../restart`
`impreza_redeploy_deployment`	`POST .../custom/{id}/redeploy` (reconstrucción en el lugar, mismo dominio)
`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`
Cuenta y saldo
`impreza_account_info`	`GET /v1/account`
`impreza_list_services`	`GET /v1/account/services`
`impreza_topup`	`POST /v1/account/topup` — recarga en BTC / XMR / USDT / TRX
`impreza_topup_status`	`GET /v1/account/topup/{invoice_id}`
`impreza_topup_payment`	`GET /v1/account/topup/{invoice_id}/payment` — dirección de criptomoneda + monto a pagar
Catálogo y pedidos
`impreza_list_products`	`GET /v1/products` — planes y precios (filtro `type=server` para VPS/dedicado)
`impreza_order_vps`	`POST /v1/orders` — compra desde el saldo; nace desplegable (`@agent`); 202 + sondeo `impreza_list_servers`
Dominios y 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` — destructivo (borra todo)

Instalación y configuración

Requisitos previos

Node ≥ 20
Una cuenta de Impreza Host con una clave API y un secreto (área de cliente → Claves API; la IP de la máquina que ejecuta este servidor MCP debe estar en la lista blanca de la clave)

Instalación única mediante `npx`

No se necesita instalación global — npx impreza-mcp funciona.

O instalar globalmente

npm install -g impreza-mcp

Obtener un fragmento de configuración listo para pegar

La vía más rápida: pregúntale al propio binario.

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

El asistente imprime el bloque JSON para insertar en la configuración MCP de tu herramienta de IA + la ruta exacta del archivo + el paso posterior a la configuración (normalmente "salir por completo y volver a abrir la herramienta de IA"). NO escribe en el disco — pégalo tú mismo para no sobrescribir accidentalmente una configuración existente con otros servidores MCP.

O configurarlo manualmente

Claude Code — añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%/Claude/claude_desktop_config.json (Windows):

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

Reinicia Claude Code. Las herramientas aparecen bajo el icono de MCP.

Cursor — añade a ~/.cursor/mcp.json (misma forma que arriba).

Continue — añade a ~/.continue/config.json:

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

Zed — añade a tu configuración:

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

Uso en el chat

Después de la configuración, habla con tu IA de forma natural:

"Lista mis servidores de Impreza." → llama a impreza_list_servers

"Despliega este directorio en mi VPS de Impreza, expónlo vía .onion." → empaqueta el directorio actual como despliegue personalizado en modo Dockerfile, sube, despliega con onion=true, e informa de la dirección .onion.

"¿Qué aplicaciones se están ejecutando en mi agente?" → llama a impreza_list_deployments filtrado al servidor correcto.

Autenticación y seguridad

IMPREZA_API_KEY + IMPREZA_API_SECRET viven en el entorno de configuración MCP de la herramienta de IA — no en ningún archivo en disco propiedad de impreza-mcp. El servidor MCP mantiene el secreto solo en memoria y solo lo adjunta como cabeceras de solicitud HTTP.

La IP de la máquina que ejecuta este servidor MCP (casi siempre tu portátil) debe estar en la lista blanca de la clave API. Gestiona la lista blanca en tu área de cliente de Impreza.

Compilación

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

Licencia

MIT — ver LICENSE.