Bắt đầu

Cài đặt và chạy Aki MCP Server

Không cần tải bộ cài: một lệnh npm, hoặc clone và chạy từ mã nguồn. Chỉ mất vài phút.

Gặp từ chưa biết? Những từ bạn sẽ gặp

Yêu cầu trước

  • Node.js 22 trở lên, trên Windows, Linux hoặc macOS.
  • Chỉ Windows: Git for Windows (hoặc WSL) trên PATH, vì công cụ shell/search dùng các binary Unix.
  • Chỉ cho app AI trên web: đã cài Tailscale và đăng nhập bằng một tài khoản miễn phí, bật Funnel một lần cho tài khoản đó. App AI trên máy này bỏ qua bước này: chúng kết nối trực tiếp (127.0.0.1 hoặc stdio).
  • Một app AI hỗ trợ custom MCP connector, trên trình duyệt hoặc trên máy tính, hoặc một chat web gửi được request HTTP. Trang kết nối có hướng dẫn cho từng app.

Cách 1: CLI toàn cục (khuyên dùng)

Đã publish lên npm. Cài một lần, hoặc chạy ngay không cần cài.

# Cài một lần, chạy mọi lúc
npm install -g @akinet/akimcp
akimcp
# Hoặc chạy ngay, không cần cài
npx @akinet/akimcp

Cách 2: Clone và chạy từ mã nguồn

# Clone repo
git clone https://github.com/lacvietanh/aki-mcp-sv.git
cd aki-mcp-sv
# Cài đặt và chạy
npm install
npm start

Điều gì xảy ra khi nó khởi động

  • Tự bật Tailscale Funnel ở cổng 9999 khi cần.
  • Tạo passphrase của bạn, cụm mật khẩu bí mật bạn gõ một lần khi app AI trên web kết nối, và khởi chạy gatekeeper kiểm tra mọi lệnh gọi.
  • Mở bảng điều khiển (control panel) trong trình duyệt ở 127.0.0.1:9998. Ở đó bạn chọn thư mục, lệnh được phép và copy cấu hình cho từng app AI: đó là bước tiếp theo của bạn.

Chỉ cho app AI trên web: một địa chỉ công khai

App AI trên web chạy trên internet nên cần một địa chỉ HTTPS công khai (ingress) dẫn về máy bạn. Chọn một cách; app AI trên máy này không cần.

Tailscale Funnel (mặc định)

Miễn phí trên mọi gói Tailscale: bật một lần bằng link AkiMCP in ra, sau đó server dùng cổng 9999.

Cloudflare named tunnel

Chạy với --tunnel <cred.json> --origin <url> để đi qua tunnel riêng của bạn.

Dùng origin riêng

Đặt PUBLIC_ORIGIN=https://your-host để trỏ tới reverse proxy HTTPS riêng.

Chạy có an toàn không?

  • Không cài gì ra ngoài thư mục người dùng, không có dịch vụ chạy nền, không cần quyền sudo hay administrator.
  • Cấu hình và token nằm ở ~/.aki/mcpsv/.
  • Phần lớn allowlist shell mặc định chỉ-đọc; một số helper dev/OS có thể ghi, nên xem lại trên máy nhạy cảm.
  • Đóng terminal sẽ dừng server; một tác vụ nền bạn đã chạy vẫn tiếp tục tới khi bạn dừng.

Xem đầy đủ mô hình bảo mật ở trang Bảo mật.