AkiMCP Là Gì: Nối AI Web Vào Máy Tính Cá Nhân Qua MCP

AkiMCP là gì?

AkiMCP (gói npm @akinet/akimcp) là một máy chủ MCP (Model Context Protocol) mã nguồn mở, chạy trên chính máy tính của người dùng để cấp cho các AI chạy trên trình duyệt quyền truy cập có kiểm soát vào filesystem, shell, Git, SQLite, trình duyệt Chrome và tác vụ nền của máy đó.

Ý tưởng cốt lõi, theo tác giả AkiMCP: dùng quota gói web/Pro của Claude thường tiết kiệm hơn trả theo token qua API cho cùng khối lượng việc, nhưng phần lớn công việc thực tế là việc trên file, không phải chat mở. AkiMCP nối hai thế giới đó lại: chạy MCP server tại máy, expose qua HTTPS bằng Tailscale Funnel, rồi kết nối vào claude.ai như một custom connector.

Tác giả và đơn vị phát triển là AkiNet, cùng hệ sinh thái với AkiTao và AkiNet. Dự án phát hành mã nguồn mở dưới giấy phép MIT tại github.com/lacvietanh/aki-mcp-sv.

AkiMCP cho phép làm gì với 39 công cụ trên máy tính cá nhân?

Bản v2 của AkiMCP đăng ký 39 công cụ dưới một tiền tố thống nhất aki__*, gom thành các nhóm chức năng rõ ràng thay vì rải rác nhiều server con:

Filesystem: đọc/ghi/sửa file, tạo thư mục, di chuyển file, liệt kê thư mục được cấp quyền (7 công cụ).
Tìm kiếm & thực thi lệnh: tìm đường dẫn, tìm nội dung, chạy lệnh shell theo danh sách trắng (3 công cụ).
Git: xem trạng thái, diff, log dưới dạng JSON có cấu trúc, cắt bớt output dài để tiết kiệm ngữ cảnh AI (3 công cụ).
SQLite: xem schema và truy vấn chỉ đọc, tự chặn lệnh DDL/DML, giới hạn 100 dòng kết quả (2 công cụ).
Trình duyệt Chrome: nhân bản profile Chrome/Brave/Edge thật, mở Chrome ẩn danh qua DevTools Protocol, gõ chữ và click như người dùng thật, dò quota các AI web (6 công cụ).
DevTools/CDP: liệt kê target, chạy script, chụp màn hình trang qua Chrome DevTools Protocol (3 công cụ).
Tác vụ nền: chạy lệnh dưới nền, quản lý tiến trình, xem log không tốn RAM (2 công cụ).
Tiện ích hệ thống: gửi thông báo desktop kèm âm thanh, đọc/ghi clipboard, kiểm tra và giải phóng cổng mạng, gọi HTTP tới localhost/LAN có chặn SSRF (6 công cụ).
Postman & ngữ cảnh agent: điều khiển ứng dụng Postman, chạy AGY, đọc ngữ cảnh AkiDevRule (7 công cụ).

Toàn bộ công cụ đi qua một cổng OAuth 2.1 duy nhất, và shell chỉ chạy lệnh nằm trong danh sách trắng do người dùng cấu hình, khác với mô hình danh sách đen thường thấy ở các công cụ tương tự.

Cách kết nối AkiMCP với Claude, ChatGPT, Grok và IDE cục bộ

Yêu cầu duy nhất trước khi cài là Node.js bản 22 trở lên trên máy. Cài đặt chỉ cần một dòng lệnh, không cần quyền quản trị, không cài daemon nền:

npm install -g @akinet/akimcp
akimcp

Hoặc chạy thử ngay không cần cài: npx @akinet/akimcp. Lệnh này in ra URL MCP server và passphrase ngay trên terminal, đồng thời mở control panel tại http://127.0.0.1:9998 để lấy Bearer token, cấu hình thư mục được phép truy cập và danh sách lệnh shell hợp lệ.

Từ v2.1.0, Gatekeeper của AkiMCP luôn bind cổng loopback 127.0.0.1:9999 ngay khi khởi động, kể cả khi chưa cấu hình ingress công khai. Nhờ vậy các công cụ cục bộ kết nối thẳng, độ trễ gần như bằng 0 và hoạt động cả khi offline:

Claude Code CLI: dán thẳng dòng lệnh sau, thay YOUR_TOKEN bằng Bearer token lấy từ control panel: claude mcp add --transport http aki-mcp http://127.0.0.1:9999/mcp --header "Authorization: Bearer YOUR_TOKEN".
Cursor, Antigravity (AGY), Codex CLI: dán URL loopback http://127.0.0.1:9999/mcp kèm cùng Bearer token vào file cấu hình MCP tương ứng của từng công cụ (control panel liệt kê sẵn từng khối JSON để copy).
Postman Desktop: dán JSON có sẵn token từ tab Postman trong control panel, không cần tunnel.

Với AI chạy trên web, cần một lớp ingress công khai (Tailscale Funnel hoặc Cloudflare Tunnel), panel bước 0 hướng dẫn bật lớp này trước:

Claude web: vào Settings → Connectors → Add custom connector, dán URL MCP server in ra từ terminal, bấm Connect rồi nhập passphrase khi AkiMCP mở trang xác nhận. Claude tự khám phá OAuth, không cần Client ID/Secret.
ChatGPT (cần gói Plus/Pro trở lên, bật Developer mode): tự đăng ký qua DCR (RFC 7591), chỉ cần dán cùng URL MCP rồi nhập passphrase.
Grok: tự đăng ký tương tự ChatGPT, đã xác minh hoạt động đầy đủ đầu-cuối.
Gemini: kết nối được nhưng đang ở trạng thái thử nghiệm, OAuth thành công song việc gọi công cụ chưa ổn định.

Kiến trúc local-first và bảo mật của AkiMCP hoạt động ra sao?

Toàn bộ token, passphrase và cấu hình lưu cục bộ tại ~/.aki/mcpsv/, không gửi lên máy chủ của bên thứ ba. Thư mục gốc mặc định được cấp quyền là thư mục home của người dùng, có thể thêm/bớt trực tiếp trong control panel mà không cần khởi động lại.

Đóng cửa sổ terminal là dừng server ngay lập tức, không có tiến trình nền âm thầm chạy khi người dùng không mở nó. Yêu cầu tối thiểu là Node.js 22 trở lên, chạy được trên Windows, Linux và macOS.

AkiMCP vừa cập nhật gì trong phiên bản 2.1.0?

Phiên bản 2.1.0 (phát hành 18/09/2026) đổi Gatekeeper sang mô hình local-first: server bind cổng loopback ngay khi khởi động thay vì chờ cấu hình ingress công khai xong mới hoạt động. Panel kết nối Postman đổi sang trỏ thẳng http://127.0.0.1:9999/mcp, và giao diện thêm các tab riêng cho Cursor, Claude Code, AGY, Codex với cấu hình dán sẵn cho từng công cụ.

Trước đó, bản 2.0.0 (13/09/2026) là mốc tái cấu trúc lớn: gộp mọi công cụ về một tiền tố aki__* duy nhất, thêm Background Task Runner, tích hợp clipboard/notify hệ điều hành, bộ dò SQLite chỉ đọc, và phân phối chính thức qua npm dưới tên @akinet/akimcp.

Lấy AkiMCP ở đâu và nên đọc thêm gì?

AkiMCP là một mảnh ghép trong hệ sinh thái công cụ mã nguồn mở của AkiNet, cùng nhóm với AkiTao (nền tảng SEO/branding doanh nghiệp) và AkiNet (quản lý cuộc sống cá nhân). Xem thêm thông tin dự án tại akitao.com/pj/aki-mcp-sv, hoặc bộ quy tắc AkiDevRule dành cho Claude Code và Antigravity mà AkiMCP dùng chung tiền tố ecosystem aki.

Repo mã nguồn đầy đủ, README cài đặt chi tiết và toàn bộ CHANGELOG nằm tại github.com/lacvietanh/aki-mcp-sv.