Dockhold

Implementa el proyecto en el que estás trabajando a una URL HTTPS en vivo desde tu herramienta de IA, luego lee los registros, establece variables y redimensiona las aplicaciones.

Servidor MCP alojado

npx add-mcp 'https://api.dockhold.eu/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Dockhold para tu herramienta de codificación con IA

Pon el proyecto en el que estás trabajando en línea sin salir de tu editor. Instala una vez, inicia sesión una vez en el navegador y luego di "pon esto en línea". Tu herramienta de IA despliega la carpeta actual (o un repositorio de GitHub) en Dockhold e informa una URL HTTPS en vivo. También puede leer el estado y los registros, establecer variables y redimensionar aplicaciones y bases de datos administradas.

No hay token que copiar. El inicio de sesión se realiza a través del navegador, de la misma manera que la CLI de Dockhold, y cada cliente a continuación lo comparte.

Instalación

Cada instalación a continuación inicia el mismo servidor MCP local, npx -y dockhold mcp. Reenvía cada solicitud a Dockhold con el inicio de sesión que la CLI almacenó en tu máquina. Nada sensible va a la configuración de tu editor.

Claude Code

/plugin marketplace add dockhold/mcp
/plugin install dockhold@dockhold

Esto instala el servidor MCP y una habilidad deploy (invocada como /dockhold:deploy, o detectada por sí sola cuando pides poner el proyecto en línea) que conoce todo el flujo: verificación previa, inicio de sesión, despliegue y qué hacer cuando falla una compilación.

Cursor

Add to Cursor

El botón abre este enlace en Cursor:

cursor://anysphere.cursor-deeplink/mcp/install?name=dockhold&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvY2tob2xkIiwibWNwIl0sImVudiI6eyJET0NLSE9MRF9SRUYiOiJjdXJzb3IifX0=

O agrégalo manualmente a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto):

{
  "mcpServers": {
    "dockhold": {
      "command": "npx",
      "args": ["-y", "dockhold", "mcp"],
      "env": { "DOCKHOLD_REF": "cursor" }
    }
  }
}

Este repositorio también es un Agent Plugin (plugin.json y mcp.json en la raíz), por lo que Cursor puede instalarlo desde su navegador de plugins una vez que esté listado allí: abre Customize en la barra lateral, busca Dockhold y elige Install.

VS Code

code --add-mcp '{"name":"dockhold","command":"npx","args":["-y","dockhold","mcp"],"env":{"DOCKHOLD_REF":"vscode"}}'

Gemini CLI

gemini extensions install https://github.com/dockhold/mcp

Este repositorio también es una extensión de Gemini CLI (gemini-extension.json en la raíz), por lo que la instalación agrega el servidor MCP y la misma habilidad deploy.

Cline

Pídele a Cline que "instale el servidor MCP desde https://github.com/dockhold/mcp". Sigue llms-install.md: una entrada de configuración, sin token, luego un inicio de sesión en el navegador. Para hacerlo manualmente, agrega la entrada a continuación a cline_mcp_settings.json con "env": { "DOCKHOLD_REF": "cline" }.

Cualquier otro cliente MCP

Usa la misma entrada de servidor en la configuración de tu cliente:

{
  "mcpServers": {
    "dockhold": {
      "command": "npx",
      "args": ["-y", "dockhold", "mcp"]
    }
  }
}

Si tu cliente le da al servidor solo unos pocos segundos para iniciar, la primera descarga de npx -y dockhold puede ser demasiado lenta para él. Instala la CLI una vez con npm i -g dockhold y la misma entrada se inicia al instante.

Inicio de sesión

La primera vez que una herramienta necesita tu cuenta, responde con un mensaje que dice que ejecutes npx dockhold login en una terminal. Ejecútalo, se abre una pestaña del navegador y listo. El inicio de sesión dura 90 días y es compartido por la CLI y cada cliente anterior. No hay nada más que configurar.

Cómo se ve

Tú: pon esto en línea

IA: Revisé el proyecto: escucha en PORT y tiene un Dockerfile. Aún no has iniciado sesión, así que estoy ejecutando npx dockhold login. Se abrirá una pestaña del navegador.

(inicias sesión, la pestaña dice que terminaste)

IA: Sesión iniciada. Desplegando con npx dockhold deploy --name recipe-box. Subiendo, compilando...

IA: Tu aplicación está en vivo: https://recipe-box-a1b2c3.dockhold.app

Tú: muéstrame los registros

IA: (llama a get_app_logs) Las últimas 100 líneas: el servidor se inició en el puerto 8080 y ha servido 3 solicitudes. Sin errores.

Las carpetas locales se despliegan a través de la CLI, que no necesita una cuenta de GitHub. Un repositorio de GitHub se despliega a través de la herramienta deploy_app. Los despliegues en cada push necesitan que el repositorio esté conectado a Dockhold (list_github_repos da el github_installation_id para pasar); un repositorio desplegado solo por URL se compila una vez.

Herramientas

HerramientaAlcanceQué hace
list_appslecturaLista tus aplicaciones con id, estado y URL
get_app_statuslecturaEstado del despliegue, URL, último commit, mensaje de error para una aplicación
get_app_logslecturaRegistros de ejecución recientes para una aplicación
get_resource_usagelecturaPools de cuenta (cómputo, RAM de base de datos, almacenamiento) y tamaños por aplicación
list_github_reposlecturaTus repositorios de GitHub conectados, con el id necesario para desplegar privados
deploy_appdespliegueDespliega un repositorio de GitHub como una aplicación web en vivo
deploy_groupdespliegueDespliega varios servicios conectados de una sola vez
redeploy_appdespliegueReinicio sin tiempo de inactividad de una aplicación
set_app_variabledespliegueEstablece una variable de entorno no secreta y la implementa
unset_app_variabledespliegueElimina una variable de entorno simple y la implementa
resize_appdespliegueCambia la memoria de una aplicación
resize_databasedespliegueCambia la memoria de una base de datos administrada
resize_database_storagedespliegueAumenta el disco de una base de datos administrada
set_app_storagedespliegueDa a una aplicación almacenamiento que sobrevive reinicios y despliegues, o lo aumenta
remove_app_storagedespliegueElimina el almacenamiento de una aplicación y borra sus archivos

El inicio de sesión en el navegador tiene los alcances read y deploy, que cubren cada herramienta anterior.

Servidor remoto (sin CLI)

Para un cliente que no puede ejecutar un comando local, las mismas herramientas se sirven a través de Streamable HTTP en https://api.dockhold.eu/mcp. Crea un token en el panel de Dockhold en Configuración, luego tokens de API (solo lectura, lectura+despliegue, o con secretos), y pásalo como bearer:

{
  "type": "streamable-http",
  "url": "https://api.dockhold.eu/mcp",
  "headers": { "Authorization": "Bearer dh_mcp_..." }
}

Claude Code: claude mcp add --transport http dockhold https://api.dockhold.eu/mcp --header "Authorization: Bearer dh_mcp_...". Esta es la única configuración que pone un token en un archivo de configuración, así que mantén ese archivo fuera del control de versiones.

Un token del panel también puede llevar el alcance secrets, que desbloquea cinco herramientas más a través de esta conexión: set_app_secret, unset_app_secret, bind_app_secret, list_secrets, list_app_secrets. El inicio de sesión en el navegador nunca tiene ese alcance; con el plugin, los secretos se agregan en la sección Secretos del panel.

Comenzando con Dockhold

Dockhold es la forma más fácil de poner tu aplicación en línea: haz push desde GitHub o despliega desde una carpeta, siempre activo, seguro por defecto. Inicia sesión en app.dockhold.eu. El nivel gratuito no necesita tarjeta.