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 đủ.
Câu hỏi phổ biến
Aki MCP Server là gì?
Một MCP server mã nguồn mở, local-first bạn chạy cục bộ. IDE local (Postman, Cursor, Claude Code, AGY, Codex) kết nối trực tiếp qua 127.0.0.1 (offline, không tunnel); AI web (Claude, ChatGPT, Grok, Notion AI) kết nối qua ingress tùy chọn. Tất cả dùng an toàn file, shell, trình duyệt, git và SQLite, chặn bằng OAuth 2.1 / Bearer auth.
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 AI client nào?
Local (trực tiếp qua 127.0.0.1): Postman, Cursor, Claude Code, AGY và Codex. Web (qua ingress tùy chọn): Claude web, ChatGPT và Grok ổn định; Notion AI cũng kết nối bằng passphrase; Gemini đang thử nghiệm và không được khuyên dùng.
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. Nó kết nối các AI web sẵn có, không app desktop và không khóa thiết bị.
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.
Khác gì so với app Claude Desktop?
Nó dùng quota web/Pro rẻ hơn, hỗ trợ nhiều tài khoản bằng cách đổi profile trình duyệt, và không khóa thiết bị.
Làm sao đưa ra HTTPS?
Chỉ cần cho AI web từ xa — IDE local chạy qua 127.0.0.1 không cần ingress. Với AI web, Tailscale Funnel là mặc định zero-config; bạn cũng có thể dùng Cloudflare named tunnel hoặc HTTPS origin riêng.
Làm sao thu hồi truy cập?
Mở mục 7 của panel, bấm Remove trên client, rồi Roll token. 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 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 7 của panel.
Làm sao xem ai đang kết nối?
Mục 7 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, cùng 200 dòng nhật ký bảo mật mới nhất.
Aki MCP Server có ghi lại những gì AI làm không?
Có, mục 9 của panel (Call log) 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 9.
Ứ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.