Aki MCP Server v4.2.0·Miễn phí, mã nguồn mở (MIT)

Để AI bạn đang dùng làm việc ngay trên máy của bạn

AkiMCP là MCP server mã nguồn mở, miễn phí (MCP là chuẩn để app AI gọi tool), chạy ngay trên máy bạn. App AI trên web và app trên máy này dùng chung một bộ tool cho file, terminal và trình duyệt, chỉ trong thư mục và lệnh bạn cho phép.

1 · App AI của bạn

  • Claude web
  • ChatGPT
  • Grok
  • Notion
  • ClickUp
  • Buda
  • Gemini· thử nghiệm
  • Postman
  • Cursor
  • Claude Code
  • Claude app
  • AGY (Antigravity)
  • Codex

+12 app khác

“Tìm ghi chú họp tuần trước”

2 · AkiMCP kiểm tra giới hạn của bạn

AkiMCP trên máy bạn

Trong thư mục bạn đã cho phépXem trong panel: Folders the connector may reach
aki__find_path

3 · Máy của bạn làm việc

  • FileTìm thấy 4 ghi chú trong Documents/Meetings
  • Terminal
  • Trình duyệt

Nó làm gì cho bạn

Thôi làm cái clipboard giữa AI và máy tính của bạn

Không có nó, bạn copy file, dán lỗi, rồi copy lại. Có nó, bạn nói một lần, cho việc hằng ngày hay việc lập trình. Mỗi dòng màu xám là một lệnh gọi tool AkiMCP, hiện trong chat ngay lúc chạy.

Việc hằng ngày

Claude web
  1. Bạn: Tìm ghi chú tuần trước trong Documents và viết một bản tóm tắt một trang đặt cạnh chúng.
  2. aki__find_path 4 ghi chú trong Documents/Meetings
  3. aki__read_text_file Đã đọc 4 ghi chú
  4. aki__write_file Đã ghi Documents/Meetings/summary.md
  5. Bạn: Giờ gom các file PDF trong Downloads vào một thư mục Receipts.
  6. aki__create_directory Đã tạo Downloads/Receipts
  7. aki__move_file Đã chuyển 6 file PDF
  8. AI: Xong. Bản tóm tắt nằm cạnh ghi chú của bạn, còn 6 file PDF đã vào Downloads/Receipts.

Việc lập trình

ChatGPT
  1. Bạn: Test đăng nhập đang lỗi. Tìm nguyên nhân, sửa rồi chạy lại test.
  2. aki__run_cmd npm test: 2/48 test lỗi trong auth.test.js
  3. aki__search_content Thấy expiresAt ở src/auth.js:42
  4. aki__edit_file Đã sửa src/auth.js: so giây với giây
  5. aki__run_cmd npm test: 48/48 test đạt
  6. aki__git op=diff: 1 file, 1 dòng thay đổi
  7. AI: Đã sửa: phần kiểm hạn token so giây với mili giây. Cả 48 test đạt; diff chỉ một dòng trong src/auth.js.

Bắt đầu

Bắt đầu trong ba bước

Một lệnh để cài, một panel tự mở, rồi một mục cài đặt trong app AI của bạn.

  1. 1Cài và chạy AkiMCP

    Dán hai dòng này vào terminal trên macOS, Windows hoặc Linux. Không cần sudo, không chạy nền: đóng terminal là AkiMCP dừng.

    npm install -g @akinet/akimcp
    akimcp

    Cần Node.js 22 trở lên; trên Windows cần thêm Git for Windows. Muốn chạy thử không cần cài: npx @akinet/akimcp

  2. 2Panel tự mở

    Control panel chỉ chạy trên máy này, mặc định ở 127.0.0.1:9998. Ở đó có passphrase, access token và tab hướng dẫn cho từng app.

  3. 3Thêm AkiMCP vào app AI của bạn

    Copy các giá trị ở tab của app đó trong mục Connectors của panel. App trên máy này kết nối thẳng. Các bước Setup của panel kết thúc bằng một đoạn hướng dẫn chỉ cần dán vào AI một lần.

    App AI trên web cần một địa chỉ công khai: Tailscale Funnel (miễn phí, không cần tên miền) hoặc Cloudflare tunnel. Phần lớn sau đó đăng nhập bằng passphrase.

Cần Node.js 22 trở lên và một lệnh terminal. Không cần sudo, đóng terminal là dừng. Miễn phí, MIT, không cần tài khoản AkiMCP. App AI trên web cần thêm một địa chỉ công khai: Tailscale Funnel miễn phí, Cloudflare tunnel hoặc HTTPS origin của riêng bạn.

Những gì vẫn do bạn giữ

Bạn quyết định AI được chạm tới đâu

Mọi giới hạn nằm trong control panel trên máy bạn. Mỗi thẻ ghi rõ mục tương ứng của panel.

  • Mỗi app AI trên web phải có passphrase

    App AI trên web chỉ vào được sau khi bạn nhập passphrase. Sai thông tin xác thực thì bị chặn: 5 lần trong 60 giây, rồi khóa 15 phút. Giới hạn do bạn chỉnh.

    Xem trong panel: Security & connection limits
  • Chỉ những thư mục bạn liệt kê

    Mặc định: cả thư mục home, cộng ~/.aki và ~/.claude. Thu hẹp home về các dự án của bạn ở đây, áp dụng ngay. Dòng ~/.claude bị khóa (nó chứa token phiên và lịch sử chat); muốn bỏ thì sửa ~/.aki/mcpsv/setting.json.

    Xem trong panel: Folders the connector may reach
  • Chỉ những lệnh có trong allowlist

    Terminal chỉ chạy lệnh có trong danh sách. Lệnh lạ bị từ chối, nối lệnh kiểu ; | & cũng vậy. Nó giữ một AI bất cẩn hay quá hăng trong khuôn khổ; nó không phải bức tường chặn người đang giữ token của bạn. Lệnh bạn tự thêm là do bạn quyết.

    Xem trong panel: Allowed shell commands
  • Mặc định ghi lệnh gọi qua HTTP, không ghi nội dung

    Nhật ký lệnh gọi ghi app AI nào dùng tool nào, lúc nào, thành công hay không, không bao giờ ghi nội dung, script hay URL bạn gửi. Nhật ký bảo mật hiện các lần đăng nhập bị từ chối. App khởi chạy AkiMCP qua stdio thì không được ghi.

    Xem trong panel: Logs
  • Thấy mọi app đã vào, cắt bất kỳ app nào

    Bảng Clients liệt kê từng app đã kết nối: lần đầu thấy, lần đăng nhập gần nhất, địa chỉ và agent, còn Active now cho thấy ai đang gọi. Remove only quên một app (token hiện tại vẫn dùng được tới khi bạn roll); Revoke & roll gỡ app đó và thay token dùng chung ngay.

    Xem trong panel: Security & connection limits
  • Đổi token nếu bị lộ

    Roll token thay access token dùng chung: bản dán tay ngừng hoạt động. Phần lớn app AI trên web tự làm mới, ClickUp cần kết nối lại một lần, còn Cursor, Claude Code và Codex cần bấm Apply lại trong panel (hoặc dán token mới, nếu cài từ máy khác). Claude app và AGY chạy qua stdio, không dùng token nên không bị ảnh hưởng.

    Xem trong panel: Connectors

Đi tiếp đâu

Chọn bước tiếp theo hợp với bạn

Ba câu hỏi hay gặp sau lần xem đầu tiên, mỗi câu có một trang trả lời.

Ủng hộ

Donate me a coffee

Aki MCP Server miễn phí và mã nguồn mở. Nếu nó giúp bạn tiết kiệm thời gian, một ly cà phê sẽ tiếp thêm động lực.