Danh mục thao tác

Tạo máy Hetzner

hetzner.servers.createMCP:hetzner_servers_createBộ công cụ: Quản trị workspace

Create a Hetzner server that installs the agent automatically. Costs money on the Hetzner account — confirmation required.

Hỏi xác nhận hai bước
Xếp hàng theo hạn mức của tài khoản
Quản trị
Quyền: Quản trị workspace
Quyền: Thao tác không hoàn tác

Gọi bằng REST v2

curl -X POST https://zl.builera.app/api/public/v2/ops/hetzner.servers.create \
  -H "Authorization: Bearer za_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"location":"x","serverType":"x","name":"Nguyễn Văn A"}'

Mỗi khoá/kết nối tối đa 300 lệnh đọc và 60 lệnh ghi mỗi phút. Gọi lại cùng Idempotency-Key trả đúng kết quả cũ, không làm lại.

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "hetzner_servers_create",
    "arguments": {
      "location": "x",
      "serverType": "x",
      "name": "Nguyễn Văn A"
    }
  }
}

Thêm https://zl.builera.app/mcp vào ứng dụng AI rồi cho phép kết nối; AI chỉ thấy công cụ trong bộ bạn chọn.

Kết quả

HTTP 428
{ "status": "confirmation_required", "operationId": "…", "confirmToken": "…", "expiresAt": "…", "data": { "summary": "…" } }

→ gửi lại đúng lệnh với header X-Confirm-Token trong 5 phút

Ví dụ đầu vào

{
  "location": "x",
  "serverType": "x",
  "name": "Nguyễn Văn A"
}

Thay mã (id) mẫu bằng mã thật lấy từ các thao tác liệt kê/tìm kiếm.

Lược đồ đầu vào (JSON Schema)

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "enum": [
        "hetzner_platform",
        "hetzner_byo"
      ],
      "default": "hetzner_byo"
    },
    "credentialId": {
      "type": "string",
      "format": "uuid",
      "nullable": true
    },
    "location": {
      "type": "string",
      "maxLength": 20
    },
    "serverType": {
      "type": "string",
      "maxLength": 20
    },
    "name": {
      "type": "string",
      "maxLength": 60
    }
  },
  "required": [
    "location",
    "serverType",
    "name"
  ],
  "additionalProperties": false
}

Cùng bộ công cụ