AkiMCP 2.1: local-first, Codex và ingress tuỳ chọn
AkiMCP 2.1 chuyển sang local-first: Gatekeeper luôn bind 127.0.0.1, ingress tuỳ chọn, thêm connector Codex, nhóm panel Local/Web, lỗi 401/503 rõ ràng.
AkiMCP 2.1 đổi mặc định vận hành từ remote-first sang local-first. Gatekeeper luôn bind vào 127.0.0.1; ingress công khai không còn là điều kiện để server khởi động. Bản phát hành đồng thời thêm connector Codex, chia panel thành hai nhóm Local/Web và tách hai lỗi: 401 khi token sai, 503 khi luồng Web chưa có ingress.
Local-first thay đổi điều gì?
Gatekeeper chỉ lắng nghe trên loopback 127.0.0.1, nên client chạy cùng máy có thể kết nối mà không cần dựng Tailscale Funnel hay một ingress khác. Ingress vẫn dùng được khi cần client web truy cập từ ngoài máy, nhưng trở thành lựa chọn bật thêm thay vì đường khởi động bắt buộc.
Local-first không bỏ xác thực: Bearer token vẫn bắt buộc, kể cả trên loopback, vì một trang web độc hại trong trình duyệt cùng máy vẫn gọi được 127.0.0.1. Request tới /mcp thiếu hoặc sai token nhận 401. Khi chưa gắn ingress, các endpoint OAuth của luồng Web (discovery, /authorize, /register, /token) trả 503 thay vì 404, nên lỗi chỉ đúng phần còn thiếu. Ingress gắn thêm chỉ có hiệu lực sau khi khởi động lại.
Codex có connector riêng
Tab Codex trong panel có sẵn đoạn cấu hình cho ~/.codex/config.toml: Codex nối vào engine local qua streamable HTTP, token nằm ngay trong cấu hình nên không cần export biến môi trường. Panel cũng thêm tab Cursor, Claude Code và AGY với cấu hình loopback dán được ngay.
Các tab chia thành hai nhóm: Local (Postman, Cursor, Claude Code, AGY, Codex) và Web (Claude, Grok, ChatGPT, Gemini, cần ingress). Nhìn nhóm là biết client nào cần địa chỉ công khai, và mục ingress ở đầu panel được đánh dấu tuỳ chọn.
Postman và dọn dẹp
Đoạn cấu hình Postman trong panel nay trỏ tới http://127.0.0.1:9999/mcp, vì Postman Desktop là client local. README và tài liệu bảo mật mô tả cách nối Cursor, Claude Code, AGY và Postman thẳng qua loopback.
Bản này cũng bỏ nhánh dự phòng install.py trong trình cài AkiDevRule trên Windows: trình cài hiện là install.mjs, nên nhánh đó không bao giờ chạy.
Nếu đang dùng AkiMCP chỉ trên máy cá nhân, 2.1 cho phép bắt đầu từ Local rồi chỉ cấu hình ingress khi thật sự cần Web. Đọc thêm MCP local-first là gì và cách phân biệt lỗi 401 với 503.