# Dockhold

Deploys local folders or GitHub repositories to live HTTPS URLs directly from your editor. It reads logs, handles redeploys, and adjusts app resources.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: dockhold
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dockhold/mcp
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/dockhold

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.dockhold.eu/mcp`
- Environment variables: `DOCKHOLD_REF` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env DOCKHOLD_REF=<DOCKHOLD_REF> --transport stdio dockhold -- npx -y dockhold
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http dockhold https://api.dockhold.eu/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add dockhold --url https://api.dockhold.eu/mcp
```

2. **Platform CLI**
```bash
codex mcp add dockhold --env DOCKHOLD_REF=<DOCKHOLD_REF> -- npx -y dockhold
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dockhold": {
            "url": "https://api.dockhold.eu/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dockhold": {
            "command": "npx",
            "args": [
                "-y",
                "dockhold"
            ],
            "env": {
                "DOCKHOLD_REF": "<DOCKHOLD_REF>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dockhold": {
            "type": "http",
            "url": "https://api.dockhold.eu/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dockhold": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "dockhold"
            ],
            "env": {
                "DOCKHOLD_REF": "<DOCKHOLD_REF>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http dockhold https://api.dockhold.eu/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e DOCKHOLD_REF=<DOCKHOLD_REF> dockhold npx -y dockhold
```
Replace <…> with your own values

## When to use it
- 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
- Put this project online and give me the URL
- Show the latest runtime logs for this app
- Increase the allocated memory for the database

## Similar
- [firebase-hosting-basics](https://affpapa.org/en/nevibecode/skills/firebase-hosting-basics.md) — skill · 171200 installs
- [edgeone](https://affpapa.org/en/nevibecode/skills/edgeone.md) — skill · 2200 installs
- [vercel-deploy](https://affpapa.org/en/nevibecode/skills/vercel-deploy.md) — skill · 209 installs
- [Dropyour](https://affpapa.org/en/nevibecode/mcp/dropyour.md) — MCP server
- [xhostd](https://affpapa.org/en/nevibecode/mcp/xhostd.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md