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.

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

Add to 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 PORT e tem um Dockerfile. Você ainda não está logado, então estou executando npx 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

FerramentaEscopoO que faz
list_appsleituraLista seus aplicativos com id, status e URL
get_app_statusleituraStatus da implantação, URL, último commit, mensagem de erro para um aplicativo
get_app_logsleituraLogs de runtime recentes para um aplicativo
get_resource_usageleituraPools da conta (computação, RAM de banco de dados, armazenamento) e tamanhos por aplicativo
list_github_reposleituraSeus repositórios GitHub conectados, com o id necessário para implantar privados
deploy_appimplantaçãoImplanta um repositório GitHub como um aplicativo web ao vivo
deploy_groupimplantaçãoImplanta vários serviços conectados de uma vez
redeploy_appimplantaçãoReinício sem tempo de inatividade de um aplicativo
set_app_variableimplantaçãoDefine uma variável de ambiente não secreta e a distribui
unset_app_variableimplantaçãoRemove uma variável de ambiente simples e a distribui
resize_appimplantaçãoAltera a memória de um aplicativo
resize_databaseimplantaçãoAltera a memória de um banco de dados gerenciado
resize_database_storageimplantaçãoAumenta o disco de um banco de dados gerenciado
set_app_storageimplantaçãoDá a um aplicativo armazenamento que sobrevive a reinícios e implantações, ou o aumenta
remove_app_storageimplantaçãoRemove 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.