v4.2.0

Aki MCP Server 4.2: kết nối mọi AI đăng nhập bằng OAuth, giữ bí mật ngoài cuộc chat

AI đăng nhập bằng OAuth mà chưa có tab riêng trong panel giờ kết nối được: địa chỉ đăng nhập bị từ chối của nó hiện trong panel, và một cú bấm là thêm vào. Không cần cập nhật AkiMCP. Khóa ghi trong file dự án như .env giờ hiện là [redacted] thay vì lọt vào chat, và truy vấn SQLite chỉ đọc được. Vẫn 38 tool.

Cập nhật, khởi động lại, kết nối lại một lần: chỉ mô tả của sqlite_query thay đổi, nên mỗi app cần kết nối lại một lần để thấy nó. Nếu Claude hỏi, chọn Always allow lại cho tool đó.

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

“Đọc file .env của dự án và cho biết nó dùng những dịch vụ nào”

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

AkiMCP trên máy bạn

Giá trị bí mật được che khỏi AIcó sẵn
aki__read_text_file

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

  • FileĐã liệt kê tên; mọi khóa đều hiện là [redacted]
  • Terminal
  • Trình duyệt
  • 1

    cú bấm để một AI mới đăng nhập được

    Bấm Add trên địa chỉ bị từ chối, áp dụng ngay lần đăng nhập sau, không cần khởi động lại

  • 6

    lần trong 5 bản phát hành một AI mới phải chờ bản AkiMCP mới

    Giờ đó là địa chỉ bạn tự thêm trong panel

  • 5

    loại câu lệnh sqlite_query chạy được

    SELECT, WITH, EXPLAIN, PRAGMA và VALUES; mọi thứ khác bị từ chối

  • 38

    tool, như bản 4.1

    Một mô tả thay đổi: sqlite_query

Kết nối mọi AI đăng nhập bằng OAuth

Dành cho AI có custom connector riêng và đăng nhập bằng OAuth nhưng chưa có tab trong panel. Như mọi AI trên web, nó cần một địa chỉ công khai (mục 0 của panel).

Mới

Thêm địa chỉ đăng nhập bị từ chối bằng một cú bấm

Thêm connector của AI bằng MCP URL của bạn. Nếu nó không kết nối được, mở mục 1 của panel → Web · needs ingress → Other AI (sign-in): địa chỉ của nó hiện dưới Refused since AkiMCP started. Bấm Add, hoặc Add as prefix để cho phép mọi địa chỉ trong thư mục đó, rồi kết nối lại và nhập passphrase. Thay đổi áp dụng ngay lần đăng nhập sau, không cần khởi động lại. Địa chỉ AkiMCP không dùng được (http, localhost, địa chỉ IP) sẽ hiện lý do thay vì nút.

Mới

Địa chỉ của riêng bạn, có nút Remove

Cùng tab đó liệt kê các địa chỉ bạn đã thêm, mỗi địa chỉ có Remove, kèm một ô để tự gõ: chính xác, hoặc tiền tố kết thúc bằng /. Chúng nằm trong setting.json ở mục oauth.callbacks, bạn cũng có thể sửa tay. Remove chặn các lần đăng nhập mới qua địa chỉ đó; muốn cắt một AI đang kết nối, dùng Revoke & roll cho nó ở mục 7 Clients, hoặc Roll & sign out all clients.

Thay đổi

Trang xác nhận ghi rõ lần đăng nhập quay về đâu

Phía trên ô passphrase, trang giờ hiện địa chỉ mà lần đăng nhập sẽ quay về, và đó là địa chỉ có sẵn (kèm tên AI; với Gemini, ghi rõ nó đi qua cổng đăng nhập dùng chung của Google) hay do bạn thêm trong panel. Hãy kiểm tra trước khi nhập passphrase.

Thay đổi

AI bị từ chối được chỉ chỗ để sửa

Lần đăng ký bị từ chối trả về invalid_redirect_uri kèm một dòng chỉ chỗ trong panel để thêm địa chỉ, hoặc lý do không thêm được, hoặc cho biết AI không gửi địa chỉ nào. Mỗi lần đăng nhập cũng kiểm tra lại địa chỉ, nên xóa một địa chỉ trong panel có hiệu lực cả với AI đã đăng ký từ trước.

Bí mật ở ngoài cuộc chat

Các thay đổi này chạy mà không cần cài đặt gì. Khởi động lại AkiMCP sau khi cập nhật để chúng có hiệu lực.

Bảo mật

Khóa trong file dự án hiện là [redacted]

search_content, read_text_file và run_cmd (cat, grep) trước đây trả về file .env của dự án đúng như nội dung. Giờ mọi kết quả che giá trị của dòng NAME=value có tên chứa một phần như TOKEN, SECRET, KEY, PASSWORD, AUTH hoặc COOKIE, và ở bất kỳ đâu trong văn bản: token bot Telegram, khóa sk-, GitHub, Slack, Postman, Google và AWS, giá trị Bearer, mật khẩu trong URL và khóa riêng PEM. $reference vẫn giữ nguyên, nên script đọc bí mật vẫn sửa được.

Bảo mật

Lệnh sửa không ghi đè được giá trị đã che

Vì AI giờ thấy [redacted] ở chỗ giá trị, write_file và edit_file từ chối ghi dấu đó vào file đang chứa giá trị bị che. Các dòng khác vẫn sửa được.

Bảo mật

Truy vấn SQLite chỉ đọc được

sqlite_query chỉ chạy câu lệnh bắt đầu bằng SELECT, WITH, EXPLAIN, PRAGMA hoặc VALUES, sau khoảng trắng và chú thích. Trước đây, một chú thích đặt phía trước giúp VACUUM INTO ghi ra file database mới, hoặc ATTACH mở một database ngoài các thư mục bạn cho phép.

Bảo mật

File đăng nhập không hỏng khi máy sập

tokens.json, danh sách token đã thu hồi và passphrase.txt giờ được ghi trọn vẹn hoặc không ghi gì, nên máy sập hay đầy ổ đĩa không làm file nào bị rỗng. File passphrase.txt rỗng được thay bằng passphrase mới thay vì cho passphrase trống đi qua.

Bảo mật

Địa chỉ đăng nhập không leo ra khỏi thư mục của nó

Mọi địa chỉ đăng nhập được đọc đúng như trình duyệt sẽ đi theo: %2e%2e và các mẹo tương tự được giải trước khi kiểm tra, còn địa chỉ chứa #, tên người dùng hay mật khẩu bị từ chối. Mọi địa chỉ có sẵn vẫn khớp như cũ.

Tool trình duyệt báo đúng chuyện đã xảy ra

Dành cho ai để AI điều khiển Chrome.

Đã sửa

Chỉ gõ vào ô nhập chữ

chrome_interact type trước đây trả lời typed: true trên nút, ô chọn hay một <div> thường, nên AI tưởng chữ đã vào. Giờ chỉ input hoặc textarea nhận chữ, còn lại bị từ chối vì không phải ô nhập chữ, nên AI chọn lại selector cho đúng.

Đã sửa

chrome_stop không động tới chương trình khác

Sau khi AkiMCP khởi động lại và Chrome nó mở đã đóng, chrome_stop có thể gửi tín hiệu tới chương trình khác đã nhận cùng process ID, mà vẫn trả lời stopped: true. Giờ nó chỉ gửi tín hiệu khi khóa của profile và dòng lệnh của tiến trình cho thấy đúng là Chrome đó; nếu không, nó trả lời stopped: false kèm lý do.

Từ bản 4.1: nhẹ hơn cho mọi chat, bền hơn cho chat dài

Mỗi app đưa toàn bộ danh sách tool vào ngữ cảnh của AI ngay đầu mỗi chat, nên danh sách gọn hơn chừa thêm chỗ cho công việc của bạn. Chat dài cũng không còn mất receipt.

Đổi từ 4.1

Danh sách tool ngắn hơn gần 700 ký tự

Phần chữ lặp lại tham số của tool hoặc không giúp AI làm gì đã được bỏ: danh sách 38 tool còn 36.751 ký tự thay vì 37.428.

Sửa trong 4.1

Chat dài giữ được receipt

Server giữ 200 rule receipt được cấp hoặc được dùng gần nhất, nên chat còn làm việc không bị từ chối chỉ vì các chat mới hơn nhận receipt. Receipt nào thật sự bị loại sẽ bị từ chối với RULE_RECEIPT_EVICTED; hãy lấy receipt mới.

Đổi từ 4.1

Khi có AIObox, chrome_launch từ chối

Khi AIObox đang chạy, aki__chrome_launch không mở gì và trả lời aiobox_running kèm một bước tiếp theo: mở link từ cửa sổ AIObox bằng aki__aiobox_write op=open_url, nên AI không bao giờ thao tác từ profile đăng nhập tài khoản khác.

Mới từ 4.1

Rule chỉ cho AI cách làm việc trong cửa sổ AIObox

Khi aki__aiobox được bật, kết quả của aki__akidevrule_context bảo AI gọi aki__aiobox op=whoami trước và thao tác qua aki__aiobox_write.

Ghi chú nâng cấp

Nâng cấp từ 4.1 trở về trước?

Mô tả của sqlite_query đã đổi ở bản 4.2, nên mỗi app kết nối lại một lần. Đi lên từ 4.0 thì lần kết nối lại đó cũng bao luôn phần mô tả tool đổi ở bản 4.1; từ 3.2 trở về trước, làm thêm một lần bước của bản 3.3 bên dưới.

  1. 1Cập nhật bằng đúng lệnh bạn đã dùng để cài (bên dưới), rồi chạy lại.
  2. 2Kết nối lại AkiMCP ở mọi app một lần, hoặc mở chat mới. Trong Claude, chọn Always allow lại cho sqlite_query; nếu đi lên từ 4.0, chọn thêm cho các tool đổi ở bản 4.1: mọi tool nhận receipt, cùng akidevrule_context, aiobox, chrome_profiles, devtools_targets, port_status và read_text_file.
  3. 3Từ 3.2 trở về trước: bấm Apply trong tab Claude Code, Codex và Cursor để entry chuyển sang khóa akimcp, và đổi allow-list của Claude Code còn ghi mcp__aki-mcp__ thành mcp__akimcp__.
  4. 4Sau này đổi tên? Khởi động lại, kết nối lại mọi app, và đặt lại tên mặc định trước khi cài bất kỳ bản 3.x nào.
# CLI toàn cục
npm install -g @akinet/akimcp
akimcp
# Từ mã nguồn
git pull && npm install && npm start

Những gì đổi bên dưới

AI có địa chỉ đăng nhập chưa có sẵn

TrướcBị từ chối cho tới khi một bản AkiMCP mới thêm nó

GiờThêm ở mục 1 của panel → Other AI (sign-in), có hiệu lực từ lần đăng nhập sau

Trang xác nhận đăng nhập

TrướcMột ô passphrase

GiờĐịa chỉ quay về, có sẵn hay do bạn thêm, phía trên ô passphrase

Khóa trong file .env của dự án

TrướcTrả về nguyên văn qua search, read và cat

Giờ[redacted]; write và edit từ chối ghi dấu đó đè lên

sqlite_query

TrướcDanh sách từ đầu câu bị cấm; một chú thích phía trước lọt qua được

GiờChỉ SELECT, WITH, EXPLAIN, PRAGMA và VALUES được chạy

File đăng nhập khi máy sập hoặc đầy ổ đĩa

TrướcCó thể bị rỗng; file passphrase rỗng cho passphrase trống đi qua

GiờGhi trọn vẹn hoặc không ghi; file passphrase rỗng được thay

chrome_stop sau khi Chrome của nó đã đóng

TrướcGửi tín hiệu tới bất cứ thứ gì giữ process ID cũ, trả lời stopped: true

GiờChỉ gửi tín hiệu tới đúng Chrome của nó; nếu không thì stopped: false kèm lý do

chrome_interact type vào nút hoặc div

Trướctyped: true, không có chữ nào vào

GiờBị từ chối: không phải ô nhập chữ

Receipt server giữ lại (4.1)

Trước200 cái cấp sớm nhất; cái cũ nhất bị loại dù đang dùng

Giờ200 cái được cấp hoặc được dùng gần nhất

chrome_launch khi AIObox đang chạy (4.1)

TrướcMở profile rồi mới cảnh báo

GiờKhông mở gì: aiobox_running kèm một bước tiếp theo

Hiểu rõ giới hạn

Một tính năng đáng tin sẽ nói rõ nó dừng ở đâu.

  • AI bạn thêm vẫn cần một địa chỉ công khai (mục 0 của panel). Địa chỉ http, localhost hay địa chỉ IP thì không thêm được.
  • Remove chỉ chặn các lần đăng nhập mới: AI đang kết nối vẫn chạy cho tới khi bạn Revoke & roll nó ở mục 7 hoặc dùng Roll & sign out all clients.
  • Việc thêm địa chỉ đã được kiểm từ đầu tới cuối trên một server thử nghiệm, chưa kiểm với một AI thật có địa chỉ chưa có sẵn.
  • Bí mật được che theo hình dạng: bí mật mang tên trung tính (CHAT_ID=) hoặc ở dạng khác (password: trong YAML) vẫn hiện nguyên văn, và bản đã mã hóa (nén hoặc base64) không được nhận ra.
  • Trên Windows, chrome_stop không có cách kiểm tra chương trình nào giữ process ID, nên nó dừng như trước.
  • Cập nhật lên 4.2 cần kết nối lại một lần ở mọi app để thấy mô tả mới của sqlite_query.
  • Khi AIObox đang chạy, chrome_launch không có cờ ép chạy: hãy mở link từ cửa sổ AIObox, hoặc tắt AIObox trước.

Sẵn sàng thử chưa?

Xem panel trong bản xem trước, đọc toàn bộ mô hình bảo mật, hoặc vào thẳng trang cài đặt.