Dokploy MCP Skills

Claude代码的Dokloy MCP技能

在上部署和管理应用程序 多克普莱 使用MCP（模型上下文协议）直接从Claude代码中提取。

不需要浏览器自动化。通过MCP服务器进行纯API调用。通过Chrome DevTools MCP进行浏览器测试，以进行部署后验证。

Claude Code  →  MCP Protocol  →  dokploy-mcp  →  Dokploy REST API  →  Docker/Traefik
                                                                     ↓
Chrome DevTools MCP  →  Browser Testing  →  End-to-End Verification

所得

• 98个MCP工具 涵盖项目、应用程序、组合、部署、Docker、备份、域、注册表、用户和服务器
• Claude代码技能 具有基于风险的审批、ID解析、部署跟踪和回滚工作流
• 真正的部署黄金之路 --经过实战检验的Atomic CRM、OwnPilot、NocoBase、Twenty CRM指南
• Playwright/Chrome DevTools测试指南 --部署后基于浏览器的E2E验证
• 200多个记录在案的错误、边缘案例和经过验证的修复 --从实际生产部署中学习
• 编写模板 准备部署
• 验证和监控脚本

______________________________________________________________________

仓库结构

dokploy-mcp-skills/
│
├── skills/dokploy-manage/              # Claude Code Skill (SSOT)
│   ├── SKILL.md                        #   Skill definition — 98 tools, 11 categories
│   ├── lessons/                        #   Battle-tested knowledge base
│   │   ├── errors.md                   #     170+ known errors with fixes
│   │   ├── golden-paths.md             #     16 proven deployment workflows
│   │   └── edge-cases.md              #     50+ traps and gotchas
│   ├── references/                     #   Technical reference docs
│   │   ├── tool-reference.md           #     All 98 tools with parameters
│   │   ├── workflow-examples.md        #     Step-by-step API call sequences
│   │   └── setup-guide.md             #     Dokploy + MCP installation guide
│   └── scripts/                        #   Monitoring & validation
│       ├── monitor-all.sh              #     Compose health monitoring (cron)
│       └── verify-deploy.sh            #     Post-deploy verification
│
├── deployments/                        # Per-Application Deployment Guides
│   ├── atomic-crm/                     #   marmelab/atomic-crm (React Admin + Supabase)
│   │   ├── golden-path.md              #     Full 9-step deployment guide
│   │   └── playwright-test.md          #     5 browser test scenarios + smoke test
│   └── ownpilot/                       #   OwnPilot AI Assistant
│       ├── golden-path.md              #     Deployment + health check guide
│       └── BRIDGE-INTEGRATION-PLAN.md  #     OpenClaw Bridge integration
│
├── compose-files/                      # Ready-to-Deploy Compose Templates
│   ├── nocobase-compose.yml            #   NocoBase low-code platform (port 13000)
│   └── twenty-compose.yml              #   Twenty CRM (port 13001)
│
├── automation/                         # Browser Automation (Legacy)
│   ├── BROWSER_AUTOMATION.md           #   Playwright deployment automation guide
│   ├── deploy-nocobase.js              #   NocoBase auto-deploy script
│   ├── deploy-twenty.js                #   Twenty CRM auto-deploy script
│   └── package.json                    #   Node.js dependencies
│
├── scripts/                            # Standalone Scripts
│   ├── dev-manager.sh                  #   Development environment manager
│   └── install-browser.sh              #   Chromium/Playwright installer
│
├── guides/                             # General Guides
│   ├── lessons.md                      #   Deployment lessons learned
│   ├── troubleshooting.md              #   Common issues + solutions
│   └── terminal-setups-comparison.md   #   Terminal emulator comparison
│
├── configs/                            # Configuration Templates
│   └── dokploy-mcp-claude.json.example #   MCP server config for Claude Code
│
├── archive/                            # Historical Reference
│   ├── SKILL-dokploy-deployment-agent.md  # Original skill (v1, Feb 2026)
│   └── PLAN.md                         #   Original project plan
│
├── LICENSE                             # MIT
└── README.md                           # This file

______________________________________________________________________

快速开始

1.安装Dokloy

curl -sSL https://dokploy.com/install.sh | sh

打开 http://localhost:3000 → 创建管理员→ 设置>API>生成令牌.

2.配置MCP服务器

添加 ~/.claude.json:

{
  "mcpServers": {
    "DokployServer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dokploy-mcp", "--enable-tools", "compose/"],
      "env": {
        "DOKPLOY_URL": "http://localhost:3000",
        "DOKPLOY_API_KEY": ""
      }
    }
  }
}

--enable-tools compose/ 激活25个组合工具（在dokploy mcp v1.0.7中默认禁用）。

3.安装技能

cp -r skills/dokploy-manage/ ~/.claude/skills/dokploy-manage/

4.重新启动Claude代码和测试

claude
# Then: "projeleri listele" → should list your Dokploy projects

______________________________________________________________________

部署指南

原子CRM（React Admin+Supabase）

来源： marmelab/原子crm 指南： deployments/atomic-crm/golden-path.md 浏览器测试： deployments/atomic-crm/playwright-test.md

亮点：

• Vite/React SPA→ 多阶段Docker构建（节点：22→ nginx：阿尔卑斯山）
• Supabase自托管为共享后端（22次迁移，31个表）
• 构建时环境变量通过 ARG → ENV 图案（Vite在构建时烘烤）
• 5个Chrome DevTools浏览器测试场景
• Traefik网络隔离修复、DNS主机解决方法、SMTP自动确认

OwnPilot（人工智能助理）

指南： deployments/ownpilot/golden-path.md

亮点：

• 通过本地注册表自定义Docker镜像（本地主机：5000）
• PostgreSQL+pgvector后端
• Claude代码编排的桥接集成

NocoBase和Twenty CRM

模板： compose-files/nocobase-compose.yml, compose-files/twenty-compose.yml

通过Claude代码部署：

"bu compose'u deploy et: [paste YAML]"

______________________________________________________________________

课程和知识库

这 skills/dokploy-manage/lessons/ 目录包含来自实际部署的经过实战检验的知识：

主要发现

• MCP环境传播错误: compose-update env更改并不总是到达容器→ use docker stop/rm + docker compose up -d --no-deps
• 合成导入已中断：始终使用REST API /api/compose.update 相反
• sourceType默认为“github”：新组合服务默认为 sourceType: "github" → 必须设置为 "raw" 通过REST API进行基于YAML的部署
• Traefik网络隔离：Traefik必须连接到每个作曲家的网络→ docker network connect dokploy-traefik

______________________________________________________________________

浏览器测试（Chrome DevTools MCP）

使用Chrome DevTools MCP进行部署后验证：

navigate_page → take_screenshot → take_snapshot → fill → click → verify

看 deployments/atomic-crm/playwright-test.md 完整的5个测试示例包括：

• 页面加载验证
• 用户注册流程
• CRUD操作
• 导航测试
• 飞行前烟雾测试脚本

______________________________________________________________________

链接

• 多克普莱 --自托管PaaS（3万多颗星）
• dokploy mcp --Dokloy的MCP服务器
• 克劳德代码 --克劳德的Anthropic CLI
• MCP协议 --模型上下文协议规范

许可证

麻省理工学院