Nó là gì

Aki MCP Server là gì?

Aki MCP Server là chương trình miễn phí, mã nguồn mở, cài trên chính máy bạn để các app AI như Claude, ChatGPT hay Cursor làm việc được với file, lệnh và trình duyệt của bạn, chỉ trong những thư mục và lệnh bạn cho phép. App AI trên máy này kết nối trực tiếp; cho app AI trên web gọi tới là tùy chọn.

Mỗi phần là gì?

App AI của bạn

Claude, ChatGPT, Cursor hay app khác, nơi bạn gõ yêu cầu.

Aki MCP Server

Chương trình trên máy bạn, nhận yêu cầu, kiểm tra rồi chạy công cụ.

Bảng điều khiển (panel)

Trang chỉ bạn mở được, ở 127.0.0.1:9998, nơi bạn chọn thư mục, lệnh và copy cấu hình cho từng app.

Máy của bạn

File, terminal và trình duyệt của bạn. Công cụ chỉ chạm vào phần bạn cho phép.

MCP trong một câu

MCP (Model Context Protocol) là một chuẩn mở cho phép trợ lý AI gọi các công cụ thật (đọc file, chạy lệnh, điều khiển trình duyệt) thay vì chỉ sinh văn bản. Aki MCP Server là một server công cụ như vậy, chạy trên máy của bạn.

Vì sao có Aki MCP Server

Phần lớn việc thật với AI là việc trong dự án: đọc, sửa và chạy thứ gì đó trên máy bạn. Aki MCP Server cho app AI bạn đang dùng làm thẳng việc đó, thay vì bạn phải copy file và lỗi qua lại.

Dùng gói chat bạn đã trả tiền, không trả API theo token

Claude Pro hay ChatGPT Plus là gói trả cố định mỗi tháng: đọc cả codebase hay theo dõi log qua gói đó không phát sinh hóa đơn theo token. Aki MCP Server đưa gói đó tới mã nguồn trên máy bạn.

Nhiều tài khoản, một máy

Chỉ cần đổi profile trình duyệt: nhiều tài khoản Claude Pro cùng trỏ về một máy.

Điều khiển máy từ xa khi không ở bàn làm việc

Khi di chuyển hoặc dùng thiết bị khác: mở Claude Web, ChatGPT Mobile hoặc Grok để xem tiến độ build, đọc log server, dọn thư mục tạm, hoặc xem code trên máy ở nhà vừa đổi gì.

Việc tự chạy theo lịch, không cần ai ngồi canh

Kết hợp lời nhắc theo lịch của Grok với Aki MCP Server để máy bạn tự làm việc khi bạn vắng mặt. Đến giờ hẹn, Grok gọi vào kiểm tra hệ thống, rà log, điều khiển một tab trình duyệt thật hoặc báo code vừa đổi gì, không cần mở cửa sổ nào.

Nó làm được gì

Một lần cài, AI của bạn có 38 công cụ, chia thành tám nhóm:

File và tìm kiếm

Đọc, ghi, sửa file trong các thư mục bạn cho phép, kèm tìm kiếm đường dẫn và nội dung toàn cây thư mục.

Lệnh được phép

Chỉ chạy những lệnh có trong allowlist. Danh sách mặc định thiên về xem, không sửa, và output dài được cắt cho vừa phần AI đọc được trong một chat.

Trình duyệt và DevTools

Mở một profile Chrome dùng chung giữ sẵn đăng nhập, hoặc gắn vào Chrome bạn đang mở; rồi bấm, gõ, chụp màn hình và gỡ lỗi trang bằng DevTools.

Git và SQLite

Một tool git chỉ-đọc gọn (status, diff, log, tags) và đọc schema, truy vấn SQLite chỉ-đọc (SELECT, WITH, EXPLAIN, PRAGMA, VALUES).

Job, cổng và dịch vụ local

Chạy job dài và đọc log, kiểm tra hoặc giải phóng cổng, và gọi các web server, API đang chạy trên máy bạn.

Điều khiển Postman

Điều khiển app Postman desktop: xem và gửi request, đọc test, và nhiều hơn.

Cửa sổ AIObox

Khi có app desktop AIObox (tùy chọn), đọc và thao tác trên các cửa sổ AI của nó.

Clipboard và thông báo

Đọc hoặc ghi clipboard, và nhận thông báo trên máy khi một việc dài chạy xong.

Công cụ cần app bạn chưa cài sẽ bị ẩn; mục “Tool providers” của panel bật tắt từng nhóm.

Cách hoạt động

Mọi yêu cầu đi qua cùng bốn bước; chỉ đường vào là khác.

  1. 1Bạn nhờ app AI một việc, ví dụ “đọc spec trong dự án của tôi”.
  2. 2App gửi lệnh tới máy bạn. App AI trên máy này kết nối thẳng tới 127.0.0.1 (loopback) hoặc tự khởi chạy bộ công cụ (stdio). App AI trên web đi vào qua một địa chỉ công khai tùy chọn (ingress), mặc định là Tailscale Funnel.
  3. 3Gatekeeper kiểm tra lệnh: app AI trên web đã đăng nhập một lần bằng passphrase của bạn (OAuth 2.1), app trên máy gửi kèm access token, còn app chạy qua stdio thì không cần token.
  4. 4Công cụ chỉ chạy trong thư mục được phép và lệnh có trong allowlist, rồi kết quả trả về cho AI.

Dành cho ai

  • Người làm việc hằng ngày trong một app AI và cứ phải copy file, copy lỗi qua lại giữa chat và máy tính.
  • Lập trình viên muốn AI đọc, sửa, chạy code và test ngay trên máy mình.
  • Người dùng AI chạy nhiều tài khoản trên các app AI web.
  • Bất kỳ ai cần truy cập máy của mình từ điện thoại hoặc trình duyệt mượn.

Khi nào nên dùng, khi nào không

Dùng khi rời bàn làm việc

Trên điện thoại, trên web, hoặc máy không phải của bạn: kiểm tra job, đọc log, hoặc xem code vừa thay đổi gì.

Ở bàn làm việc, CLI native tốt hơn

Một agent code chạy terminal sẽ nhanh và mượt hơn khi bạn ngồi ngay tại máy.

Những từ bạn sẽ gặp

Mỗi thuật ngữ trong một câu dễ hiểu. Các từ này cũng xuất hiện trong control panel và trong app AI của bạn.

MCP

MCP (Model Context Protocol) là một chuẩn mở cho phép app AI gọi công cụ thật trên máy tính, như đọc file hay chạy lệnh, thay vì chỉ trả lời bằng chữ.

Aki MCP Server

Aki MCP Server là chương trình miễn phí, mã nguồn mở, cài trên chính máy bạn; nó cho app AI 38 công cụ, chỉ chạy trong các thư mục và lệnh bạn cho phép.

Công cụ (tool)

Công cụ là một việc cụ thể AI có thể nhờ máy bạn làm, như đọc file, tìm trong thư mục hay mở trang web.

Bảng điều khiển (panel)

Bảng điều khiển là một trang chạy ngay trên máy bạn (http://127.0.0.1:9998), tự mở khi server khởi động; ở đó bạn chọn thư mục, lệnh được phép và copy cấu hình cho từng app AI.

Connector

Connector là mục bạn thêm trong app AI (Claude, ChatGPT, ClickUp...) để trỏ app đó tới server trên máy bạn.

Display name, Server ID, Tool prefix

Display name là tên app AI hiển thị cho server của bạn (mặc định AkiMCP), Server ID là khóa mà cấu hình app lưu server dưới tên đó (akimcp), còn Tool prefix đứng trước tên mọi tool (aki__run_cmd); cả ba đặt ở đầu mục “Connectors” của panel.

Địa chỉ MCP (MCP URL)

Địa chỉ MCP là đường link app AI dùng để gọi tới server của bạn; panel hiện sẵn để copy.

Passphrase (cụm mật khẩu)

Passphrase là cụm mật khẩu bí mật hiện trong panel; bạn gõ nó một lần ở trang xác nhận khi app AI trên web kết nối, nên chỉ bạn mới duyệt được.

Mã truy cập (access token)

Mã truy cập là một khóa bí mật dài mà app trên máy này (Cursor, Claude Code, Codex, Postman) và Buda gửi kèm mỗi lệnh; panel giữ nó và có thể đổi mã mới nếu bị lộ.

Địa chỉ công khai (ingress)

Ingress là địa chỉ HTTPS công khai, không bắt buộc, giúp app AI trên web gọi tới máy bạn; mặc định là Tailscale Funnel, cũng dùng được Cloudflare Tunnel hoặc domain riêng. App trên cùng máy không cần nó.

Tailscale Funnel

Tailscale Funnel là tính năng của Tailscale cho máy bạn một địa chỉ HTTPS công khai; cần một tài khoản Tailscale miễn phí, server tự bật nó cho bạn.

127.0.0.1 (loopback)

127.0.0.1 (loopback) là địa chỉ để máy tự nói chuyện với chính nó; app trên cùng máy kết nối qua đây, không đi ra internet.

stdio

stdio là cách app trên cùng máy tự khởi chạy bộ công cụ và nói chuyện trực tiếp, không qua mạng, không cần token; app Claude và AGY kết nối theo cách này.

Cổng kiểm soát (gatekeeper)

Gatekeeper là phần của server nhận mọi lệnh gọi, kiểm tra đăng nhập hoặc token, rồi mới chuyển cho bộ công cụ.

OAuth 2.1

OAuth 2.1 là quy trình đăng nhập chuẩn mà app AI trên web dùng để xin quyền; với AkiMCP nó kết thúc ở trang bạn gõ passphrase.

Thư mục được phép

Thư mục được phép là những thư mục duy nhất công cụ được đọc và sửa; mặc định là toàn bộ thư mục home của bạn, mục “Folders the connector may reach” của panel thêm hoặc bớt.

Danh sách lệnh được phép (allowlist)

Allowlist là danh sách lệnh AI được chạy; lệnh nào không có trong danh sách đều bị từ chối. Mục “Allowed shell commands” của panel để sửa.

Nhóm công cụ theo app (tool providers)

Tool providers là các nhóm công cụ cần một app nhất định (Postman, Chrome, AIObox, agy, Kiro CLI); app chưa cài thì công cụ của nó bị ẩn, mục “Tool providers” của panel bật tắt từng nhóm.

AIObox

AIObox là app desktop tùy chọn, thêm profile Chrome dùng chung và các cửa sổ AI mà công cụ điều khiển được. Hiện miễn phí trong giai đoạn closed beta, dành cho thành viên AkiDev; mục “AIObox” của panel nói cách nhận.

Session file (file ghi chép phiên)

Session file là một file ghi chép riêng cho mỗi chat, ở đường dẫn do AkiMCP tạo, để AI ghi tiếp tiến độ vào đúng một chỗ.

AkiDevRule

AkiDevRule là bộ rule tùy chọn, mở trên GitHub, chỉ cho AI cách làm việc trong dự án của bạn; mục “Install AkiDevRule (optional)” của panel để cài, và app AI nào nạp rule qua AkiMCP đều nhận được.