Dockhold
Implante o projeto em que você está trabalhando em uma URL HTTPS ao vivo a partir da sua ferramenta de IA, depois leia os logs, defina variáveis e redimensione os aplicativos.
Servidor MCP hospedado
npx add-mcp 'https://api.dockhold.eu/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Dockhold para sua ferramenta de IA de codificação
Coloque o projeto em que você está trabalhando online sem sair do seu editor. Instale uma vez, faça login uma vez no navegador, e então diga "coloque isso online". Sua ferramenta de IA implanta a pasta atual (ou um repositório GitHub) no Dockhold e reporta uma URL HTTPS ao vivo. Ela também pode ler status e logs, definir variáveis, e redimensionar aplicativos e bancos de dados gerenciados.
Sem token para copiar. O login acontece pelo navegador, da mesma forma que o Dockhold CLI, e cada cliente abaixo compartilha isso.
- Documentação: https://dockhold.eu/docs
- Nome do registro:
eu.dockhold/dockhold - Requisitos: Node.js 18 ou mais recente (para
npx)
Instalação
Cada instalação abaixo inicia o mesmo servidor MCP local, npx -y dockhold mcp. Ele encaminha cada solicitação para o Dockhold com o login que o CLI armazenou na sua máquina. Nada sensível vai para a configuração do seu editor.
Claude Code
/plugin marketplace add dockhold/mcp
/plugin install dockhold@dockhold
Isso instala o servidor MCP e uma habilidade deploy (invocada como /dockhold:deploy, ou acionada por conta própria quando você pede para colocar o projeto online) que conhece todo o fluxo: pré-verificação, login, implantação, e o que fazer quando uma build falha.
Cursor
O botão abre este link no Cursor:
cursor://anysphere.cursor-deeplink/mcp/install?name=dockhold&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvY2tob2xkIiwibWNwIl0sImVudiI6eyJET0NLSE9MRF9SRUYiOiJjdXJzb3IifX0=
Ou adicione manualmente em ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto):
{
"mcpServers": {
"dockhold": {
"command": "npx",
"args": ["-y", "dockhold", "mcp"],
"env": { "DOCKHOLD_REF": "cursor" }
}
}
}
Este repositório também é um Agent Plugin (plugin.json e mcp.json na raiz), então o Cursor pode instalá-lo pelo navegador de plugins assim que estiver listado lá: abra Customize na barra lateral, procure por Dockhold, e escolha 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 repositório também é uma extensão do Gemini CLI (gemini-extension.json na raiz), então a instalação adiciona o servidor MCP e a mesma habilidade deploy.
Cline
Peça ao Cline para "instalar o servidor MCP de https://github.com/dockhold/mcp". Ele segue llms-install.md: uma entrada de configuração, sem token, e depois um login no navegador. Para fazer manualmente, adicione a entrada abaixo em cline_mcp_settings.json com "env": { "DOCKHOLD_REF": "cline" }.
Qualquer outro cliente MCP
Use a mesma entrada de servidor na configuração do seu cliente:
{
"mcpServers": {
"dockhold": {
"command": "npx",
"args": ["-y", "dockhold", "mcp"]
}
}
}
Se o seu cliente der ao servidor apenas alguns segundos para iniciar, o primeiro download de npx -y dockhold pode ser lento demais para ele. Instale o CLI uma vez com npm i -g dockhold e a mesma entrada inicia instantaneamente.
Login
Na primeira vez que uma ferramenta precisar da sua conta, ela responde com uma mensagem dizendo para executar npx dockhold login em um terminal. Execute, uma aba do navegador abre, e pronto. O login dura 90 dias e é compartilhado pelo CLI e por cada cliente acima. Nada mais para configurar.
Como parece
Você: coloque isso online
IA: Verifiquei o projeto: ele escuta em
PORTe tem um Dockerfile. Você ainda não está logado, então estou executandonpx dockhold login. Uma aba do navegador vai abrir.(você faz login, a aba diz que está pronto)
IA: Logado. Implantando com
npx dockhold deploy --name recipe-box. Enviando, construindo...IA: Seu aplicativo está no ar: https://recipe-box-a1b2c3.dockhold.app
Você: mostre-me os logs
IA: (chama
get_app_logs) As últimas 100 linhas: o servidor iniciou na porta 8080 e atendeu 3 solicitações. Sem erros.
Pastas locais são implantadas pelo CLI, que não precisa de conta GitHub. Um repositório GitHub é implantado pela ferramenta deploy_app. Implantações a cada push precisam do repositório conectado ao Dockhold (list_github_repos fornece o github_installation_id para passar); um repositório implantado apenas por URL é construído uma vez.
Ferramentas
| Ferramenta | Escopo | O que faz |
|---|---|---|
list_apps | leitura | Lista seus aplicativos com id, status e URL |
get_app_status | leitura | Status da implantação, URL, último commit, mensagem de erro para um aplicativo |
get_app_logs | leitura | Logs de runtime recentes para um aplicativo |
get_resource_usage | leitura | Pools da conta (computação, RAM de banco de dados, armazenamento) e tamanhos por aplicativo |
list_github_repos | leitura | Seus repositórios GitHub conectados, com o id necessário para implantar privados |
deploy_app | implantação | Implanta um repositório GitHub como um aplicativo web ao vivo |
deploy_group | implantação | Implanta vários serviços conectados de uma vez |
redeploy_app | implantação | Reinício sem tempo de inatividade de um aplicativo |
set_app_variable | implantação | Define uma variável de ambiente não secreta e a distribui |
unset_app_variable | implantação | Remove uma variável de ambiente simples e a distribui |
resize_app | implantação | Altera a memória de um aplicativo |
resize_database | implantação | Altera a memória de um banco de dados gerenciado |
resize_database_storage | implantação | Aumenta o disco de um banco de dados gerenciado |
set_app_storage | implantação | Dá a um aplicativo armazenamento que sobrevive a reinícios e implantações, ou o aumenta |
remove_app_storage | implantação | Remove o armazenamento de um aplicativo e apaga seus arquivos |
O login no navegador tem os escopos read e deploy, que cobrem todas as ferramentas acima.
Servidor remoto (sem CLI)
Para um cliente que não pode executar um comando local, as mesmas ferramentas são servidas via Streamable HTTP em https://api.dockhold.eu/mcp. Crie um token no painel do Dockhold em Configurações, depois tokens de API (somente leitura, leitura+implantação, ou com segredos), e passe-o 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 é a única configuração que coloca um token em um arquivo de configuração, então mantenha esse arquivo fora do controle de versão.
Um token do painel também pode carregar o escopo secrets, que desbloqueia cinco ferramentas adicionais por esta conexão: set_app_secret, unset_app_secret, bind_app_secret, list_secrets, list_app_secrets. O login no navegador nunca tem esse escopo; com o plugin, segredos são adicionados na seção Segredos do painel.
Começando com o Dockhold
Dockhold é a maneira mais fácil de colocar seu aplicativo online: envie do GitHub ou implante de uma pasta, sempre ativo, seguro por padrão. Faça login em app.dockhold.eu. O plano gratuito não precisa de cartão.