Cài đặt & dùng CLI odmcp

odmcp là công cụ dòng lệnh giúp kết nối AI agent với OneDash MCP — cài một lần, đăng nhập uỷ quyền bằng trình duyệt, rồi để nó tự ghi cấu hình cho từng ứng dụng. Không phải tự tạo hay dán token.

Dùng cách này khi: ứng dụng của bạn chỉ chạy MCP dạng stdio (không nhận địa chỉ máy chủ), hoặc bạn muốn cấu hình nhiều ứng dụng một lượt thay vì sửa từng tệp.

Bước 1 — Cài đặt (không cần Node.js)

macOS / Linux / WSL:

curl -fsSL https://onedash.inet.vn/mcp/install.sh | bash

Windows (PowerShell):

irm https://onedash.inet.vn/mcp/install.ps1 | iex

Script tự nhận diện nền tảng, tải đúng bản, kiểm tra checksum trước khi cài (huỷ nếu không khớp), đặt odmcp vào ~/.onedash/bin và thêm vào PATH.

Bước 2 — Đăng nhập một lần

odmcp login

Lệnh mở (hoặc in ra) một đường link xác nhận trên trình duyệt, kèm một mã dạng XXXX-XXXX. Kể cả khi đang ở máy chủ qua SSH không có trình duyệt, vẫn mở link đó ở bất kỳ máy nào khác rồi nhập mã hiện trên terminal.

Sau khi xác nhận, thông tin đăng nhập lưu tại ~/.onedash/credentials.json (chỉ chủ máy đọc được) và tự gia hạn — bạn không phải đăng nhập lại trong quá trình dùng thường ngày.

Quyền cấp cho máy này có hạn ngắn, tự làm mới, không phải một chuỗi bí mật sống hàng trăm ngày:

Chạm hạn tối đa thì chỉ cần chạy lại odmcp login.

Bước 3 — Để công cụ ghi cấu hình hộ

odmcp setup                # quét ứng dụng đã cài → tick chọn → tự chèn cấu hình
odmcp install cursor       # cấu hình một ứng dụng cụ thể

setup phát hiện các ứng dụng đã cài, hiện danh sách tick chọn, rồi hợp nhất cấu hình vào đúng tệp — giữ nguyên máy chủ MCP khác và sao lưu tệp cũ trước khi ghi.

Thông tin đăng nhập KHÔNG nằm trong tệp cấu hình — nó ở riêng tại ~/.onedash/credentials.json, ngoài mọi thư mục dự án, nên không thể lọt vào commit.

Muốn khai tay thì chỉ cần trỏ ứng dụng tới lệnh odmcp:

{
  "mcpServers": {
    "onedash": {
      "command": "odmcp"
    }
  }
}

Vị trí tệp và tên khoá gốc của từng ứng dụng xem ở Cấu hình AI client qua HTTP — chỉ khác là dùng khối command: odmcp ở trên thay cho khối HTTP.

Đăng xuất / thu hồi

• odmcp logout — thu hồi quyền cả phía máy chủ, không chỉ xoá thông tin trên máy hiện tại.
• Hoặc mở Kết nối AI và thu hồi dòng tương ứng. Trang này liệt kê cả quyền cấp qua uỷ quyền lẫn token dán tay cũ, phân biệt bằng cột Nguồn.

Lệnh hữu ích khác

Xử lý sự cố