Hỏi đáp
Câu hỏi thường gặp
Câu trả lời ngắn gọn, thật lòng. Cần chi tiết, theo liên kết tới các trang đầy đủ.
Gặp từ chưa biết? Những từ bạn sẽ gặp
Câu hỏi phổ biến
Aki MCP Server là gì?
Một chương trình miễn phí, mã nguồn mở bạn chạy trên chính máy mình, cho app AI 38 công cụ làm việc với file, terminal, trình duyệt, git và SQLite, chỉ trong thư mục và lệnh bạn cho phép. MCP là chuẩn mà các app đó dùng để gọi công cụ. App AI trên máy này kết nối trực tiếp (127.0.0.1 hoặc stdio, không cần tunnel); app AI trên web kết nối qua một địa chỉ công khai tùy chọn và đăng nhập bằng passphrase của bạn.
Có miễn phí không?
Có. Nó là mã nguồn mở theo giấy phép MIT và miễn phí để tự host.
Hỗ trợ những app AI nào?
Trên máy này (qua 127.0.0.1 hoặc stdio): Postman, Cursor, Claude Code, app Claude, AGY và Codex. Trên web (qua địa chỉ công khai): Claude, ChatGPT và Grok ổn định nhất; Notion và ClickUp cũng đăng nhập bằng passphrase; Buda kết nối bằng access token trong header; AI khác đăng nhập bằng OAuth kết nối được sau khi bạn thêm địa chỉ đăng nhập của nó trong panel; Gemini đăng nhập lại được nhưng vẫn là thử nghiệm: dùng công cụ chưa ổn định trong các lần thử.
Tôi có cần để máy bật không?
Để dùng từ xa thì có: máy phải bật và server đang chạy. Đóng terminal là server dừng.
Mặc định AI truy cập được gì?
Mặc định gốc file là toàn bộ thư mục home cộng ~/.aki và ~/.claude, và allowlist shell ưu tiên kiểm tra kèm vài helper dev duyệt sẵn có thể ghi. Hãy thu hẹp thư mục và xem lại allowlist trong panel trên máy nhạy cảm.
Có cần app desktop không?
Không. Aki MCP Server chạy bằng một lệnh terminal và dùng được với các app AI web và app AI trên máy mà bạn đang dùng.
Chạy trên hệ điều hành nào?
Windows, Linux và macOS với Node.js 22. Trên Windows cần thêm Git for Windows (hoặc WSL) trên PATH.
Có dùng được với app Claude Desktop không?
Có: từ 3.1.0 app Claude kết nối Aki MCP Server qua stdio, không cần dán token. Các app AI web dùng gói chat bạn đã trả tiền, và profile trình duyệt hay tài khoản nào cũng tới được cùng một máy.
Chạy trên hai máy có phân biệt được không?
Được, từ bản 4.0: đặt cho mỗi máy một Display name riêng trong panel (ví dụ MacMCP và WinMCP), và tool của nó có tiền tố riêng (mac__run_cmd). Giữ tên mặc định thì không có gì thay đổi.
Allowlist có chặn được prompt injection không?
Tự nó thì không. Nó giữ một AI bất cẩn hay quá hăng trong các lệnh bạn đã duyệt, nhưng tool file sửa được cấu hình của chính AkiMCP trong các thư mục mặc định và nới rộng nó. Chỉ kết nối app AI bạn tin, giữ kín passphrase và token, thu hẹp thư mục, và xem nhật ký lệnh gọi.
Làm sao đưa ra HTTPS?
Chỉ app AI trên web mới cần; app AI trên máy này kết nối trực tiếp (127.0.0.1 hoặc stdio). Với app AI trên web, Tailscale Funnel là mặc định miễn phí: cài Tailscale, đăng nhập, rồi bật Funnel một lần bằng link AkiMCP in ra. Cloudflare named tunnel hoặc HTTPS origin riêng cũng dùng được.
Làm sao thu hồi truy cập?
Mở mục “Security & connection limits” của panel, bấm Revoke & roll trên client (Delete nếu nó chưa từng nhận token; Remove only chỉ đăng xuất nó). Nếu nghi lộ bí mật, dùng Roll & sign out all clients để mọi AI phải kết nối lại bằng passphrase.
Có ai đoán được passphrase của tôi không?
Việc đoán bị làm chậm: 5 thông tin xác thực bị từ chối trong 60 giây sẽ chặn người gọi đó 15 phút với mã 429, và nhật ký bảo mật (mục “Logs” của panel) ghi lại các lần thử. Token hợp lệ của bạn không bao giờ bị chặn. Các ngưỡng chỉnh được ở mục “Security & connection limits” của panel.
Làm sao xem ai đang kết nối?
Mục “Security & connection limits” của panel liệt kê mọi client với lần đầu thấy, lần duyệt gần nhất và lần cấp token gần nhất, các địa chỉ hoạt động từ lần khởi động gần nhất; 200 dòng nhật ký bảo mật mới nhất nằm ở mục “Logs”.
Aki MCP Server có ghi lại những gì AI làm không?
Có, với lệnh gọi qua HTTP: mục “Logs” của panel ghi mỗi lần gọi tool thành một dòng JSON vào tool-calls.jsonl trong thư mục dữ liệu: thời điểm, client, tool và op, window và port, thành công hay mã lỗi, thời lượng và phiên bản server. Log không bao giờ ghi tham số, văn bản, script hay URL mà AI đã truyền, và chỉ ghi tên header của request, không ghi giá trị. Mức Basic (mặc định) giữ một mã lỗi ngắn; mức Detail thêm toàn văn lỗi, chat được tác động và hash của biểu thức eval. File được xoay khi chạm giới hạn dung lượng (mặc định 16 MB) và file cũ bị xóa sau số ngày lưu giữ (mặc định 40 ngày); cả hai chỉnh được ở mục đó. App khởi chạy AkiMCP qua stdio (app Claude, AGY) thì không được ghi.
Ứng dụng local lấy access token bằng cách nào?
Gửi GET /api/access-token tới panel (mặc định cổng 9998) kèm panel token của lần chạy hiện tại trong header x-panel-token, panel sẽ trả access token dùng chung dưới dạng {accessToken}. Endpoint chỉ trả lời trên loopback và không gửi header CORS, nên trang web không đọc được. Nó không thêm quyền mới: ai đã có panel token thì vốn đã xem được access token trong panel.
Client stdio khởi chạy nó thế nào?
Bằng lệnh npx -y @akinet/akimcp --stdio, chạy cùng bộ tool qua stdin/stdout, không cần gateway, tunnel hay token, nên client nào tự khởi chạy MCP server đều gọi được. Package còn kèm bản ghi server.json (tên io.github.lacvietanh/akimcp) mô tả nó cho MCP Registry và nêu lệnh này.
Có bao nhiêu công cụ?
38 công cụ, từ file và shell đến điều khiển trình duyệt, git, SQLite, tác vụ nền và điều khiển Postman. Xem trang Có gì mới để biết thay đổi mới nhất.