Cấu hình AI client qua HTTP

Cách nhanh nhất — và an toàn nhất — là chỉ khai địa chỉ máy chủ, rồi để ứng dụng tự xin quyền qua trình duyệt. Cấu hình không chứa chuỗi bí mật nào, nên không có gì để lọt vào commit.

Cách 1 — chỉ dán địa chỉ (khuyến nghị)

{
  "mcpServers": {
    "onedash": {
      "type": "http",
      "url": "https://onedash.inet.vn/mcp"
    }
  }
}

Với Claude Code, một lệnh là xong:

claude mcp add --scope user --transport http onedash https://onedash.inet.vn/mcp

Lần gọi đầu tiên, ứng dụng tự đăng ký với OneDash, mở trình duyệt để bạn đăng nhập và duyệt phạm vi quyền, rồi tự lưu thông tin đăng nhập vào kho riêng của nó. Từ đó nó tự gia hạn — bạn không phải làm gì thêm.

Quyền đã cấp hiện tại trang Kết nối AI, thu hồi được bất cứ lúc nào.

Vì sao không còn phải tự tạo token

Quyền cấp theo cách này có hạn ngắn và tự gia hạn: phần dùng để gọi API sống khoảng một giờ, phần dùng để gia hạn thì đổi mới mỗi lần dùng. Không có chuỗi bí mật nào sống hàng trăm ngày, và không có chuỗi nào đi qua tay bạn để mà copy nhầm hay commit nhầm.

Nơi khai địa chỉ trên từng ứng dụng

Mỗi ứng dụng nhận địa chỉ ở một chỗ khác nhau, và có ứng dụng khai đúng chỗ rồi vẫn phải bấm thêm một lần mới bắt đầu xin quyền — không ứng dụng nào báo lỗi ở bước đó, nên rất dễ tưởng là hỏng.

Cách 2 — dán token cá nhân (chỉ khi cách 1 không dùng được)

Dùng cho ứng dụng không hỗ trợ đăng nhập uỷ quyền (WebStorm/JetBrains) và cho công cụ tự động hoá không có trình duyệt lẫn người bấm xác nhận (n8n, cron, script).

{
  "mcpServers": {
    "onedash": {
      "type": "http",
      "url": "https://onedash.inet.vn/mcp",
      "headers": { "Authorization": "Bearer ${ONEDASH_API_TOKEN}" }
    }
  }
}

Ba giá trị cần khai, bất kể ứng dụng nào: URL https://onedash.inet.vn/mcp, header Authorization: Bearer <token>, transport http (hoặc streamable-http).

Địa chỉ máy chủ

Địa chỉ MCP nằm ngay trên domain OneDash bạn đang đăng nhập, kèm /mcp — không có tên miền riêng cho MCP. Quyền cấp ở hệ nào chỉ dùng được với domain của hệ đó.

Xử lý sự cố