Dockhold — Claude Code MCP server: what it does, how to install
Deploys local folders or GitHub repositories to live HTTPS URLs directly from your editor. It reads logs, handles redeploys, and adjusts app resources.
claude mcp add --env DOCKHOLD_REF=<DOCKHOLD_REF> --transport stdio dockhold -- npx -y dockholdWhat Dockhold does
The server links your development environment to the Dockhold platform using a local process (npx -y dockhold mcp) or a remote endpoint at https://api.dockhold.eu/mcp. It requires Node.js 18 or later. Authentication skips storing secrets in editor configs: running npx dockhold login opens a browser tab, and the resulting session stays valid for 90 days across all local tools.
Available tools let your assistant trigger GitHub builds via deploy_app, execute zero-downtime restarts using redeploy_app, view live logs, and update plain environment variables. It also covers compute resizing and managed database disk expansion. When an editor times out on initial download, installing the package globally with npm i -g dockhold bypasses the delay.
Browser-based logins cannot manage confidential application secrets because they lack the secrets permission scope. Editing secrets directly through the assistant requires the remote HTTP endpoint paired with a dedicated personal token from the Dockhold dashboard.
What it helps with
- publish a local directory to a public HTTPS URL
- inspect live runtime logs directly from the chat prompt
- adjust RAM and storage allocations for apps or databases
- restart running services with zero downtime
Example prompts for the agent
- Put this project online and give me the URL
- Show the latest runtime logs for this app
- Increase the allocated memory for the database
How to install Dockhold
1Platform CLI
claude mcp add --env DOCKHOLD_REF=<DOCKHOLD_REF> --transport stdio dockhold -- npx -y dockholdReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http dockhold https://api.dockhold.eu/mcp1Platform CLI: remote server
codex mcp add dockhold --url https://api.dockhold.eu/mcp2Platform CLI
codex mcp add dockhold --env DOCKHOLD_REF=<DOCKHOLD_REF> -- npx -y dockholdReplace <…> with your own values
Config file
{
"mcpServers": {
"dockhold": {
"url": "https://api.dockhold.eu/mcp"
}
}
}{
"mcpServers": {
"dockhold": {
"command": "npx",
"args": [
"-y",
"dockhold"
],
"env": {
"DOCKHOLD_REF": "<DOCKHOLD_REF>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"dockhold": {
"type": "http",
"url": "https://api.dockhold.eu/mcp"
}
}
}{
"servers": {
"dockhold": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"dockhold"
],
"env": {
"DOCKHOLD_REF": "<DOCKHOLD_REF>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http dockhold https://api.dockhold.eu/mcp2Platform CLI
gemini mcp add -e DOCKHOLD_REF=<DOCKHOLD_REF> dockhold npx -y dockholdReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Dockhold
How to install Dockhold in Claude Code?
Run claude mcp add dockhold -- npx -y dockhold in your terminal. When prompted on first use, run npx dockhold login to complete the browser authentication.
What does Dockhold do?
It provides tools for launching web projects, inspecting running containers, managing plain environment variables, and resizing application resources from editor chats.
How do you manage application secrets with Dockhold?
Standard browser logins omit the secrets scope. You must connect over Streamable HTTP to https://api.dockhold.eu/mcp using a dashboard token configured with the secrets permission.
