Tiện ích mở rộng Pi cho phép dùng mọi connector của Codex không cần xác thực riêng

Một tiện ích mở rộng mới dành cho Pi vừa được giới thiệu, cho phép người dùng tận dụng toàn bộ connector đã kết nối sẵn trong Codex — từ GitHub, Gmail, Google Calendar/Drive đến Slack, Linear và Figma — ngay từ bất kỳ mô hình nào chạy trên nền tảng này.

Điểm đáng chú ý là cơ chế hoạt động: gói @wileai/pi-codex-connector khai thác các endpoint máy chủ cục bộ mà Codex cung cấp cho toàn bộ plugin mà không cần xác thực bổ sung. Người dùng chỉ cần đăng nhập Codex một lần là có thể dùng chung cho mọi harness.

Cách thức hoạt động

Tiện ích này khởi động codex app-server (qua stdio) trong lần sử dụng đầu tiên. Codex vẫn giữ quyền quản lý thông tin đăng nhập và chứng thực connector của bạn.

Quy trình diễn ra như sau:

• Mở một luồng Codex tạm thời, không dùng mô hình, chỉ bật tính năng ứng dụng; các máy chủ MCP riêng của bạn bị vô hiệu hóa trong luồng này.
• Lệnh app/installed kết hợp mcpServerStatus/list xây dựng danh mục các connector đã kết nối cùng các công cụ của chúng.
• Các công cụ được thực thi qua mcpServer/tool/call, không cần chạy lượt mô hình Codex nào.

Thay vì nạp hàng trăm schema vào ngữ cảnh, mô hình chỉ nhận được ba công cụ:

• codex_connectors — liệt kê connector; với tham số connector/query sẽ liệt kê các công cụ phù hợp.
• codex_connector_schema — mô tả đầy đủ và schema đầu vào của một công cụ.
• codex_connector_call — chạy công cụ với tham số JSON.

Lệnh /codex-connectors [refresh] sẽ hiển thị danh mục hiện có.

Kiểm soát thao tác ghi

Các công cụ không được đánh dấu chỉ đọc sẽ cần phê duyệt. Biến môi trường PI_CODEX_CONNECTORS_WRITES điều khiển hành vi:

• ask (mặc định): hiện hộp thoại xác nhận trong giao diện TUI; tự động từ chối khi không có giao diện (chế độ print/JSON).
• allow: chạy không cần hỏi.
• deny: không bao giờ chạy.

Cài đặt

Chỉ cần hai bước:

codex login            # tài khoản ChatGPT đã kết nối các connector
pi install npm:@wileai/pi-codex-connector

Yêu cầu Node.js 22.19+ và Pi. Đây là tiện ích mở rộng của Pi, không phải máy chủ MCP độc lập; các harness khác phải hỗ trợ nạp tiện ích Pi mới dùng được.

Ngoài ra, bạn có thể thêm gói vào mảng packages trong tệp ~/.pi/agent/settings.json (cá nhân) hoặc .pi/settings.json (dự án). Cài đặt theo dự án yêu cầu Pi project trust. Khởi động lại Pi sau khi cài hoặc cập nhật.

Để cập nhật, dùng pi update npm:@wileai/pi-codex-connector cho riêng tiện ích này, hoặc pi update --extensions cho toàn bộ gói.

Lưu ý khi chuyển từ tên gói cũ

Gói đã đổi tên thành @wileai/pi-codex-connector. Các bản cài cũ cần chuyển đổi một lần:

pi remove npm:pi-codex-connectors
pi install npm:@wileai/pi-codex-connector

Thêm cờ --local cho cả hai lệnh nếu cài theo dự án, sau đó khởi động lại Pi.

Quyền riêng tư và an toàn

Đây là điểm cần đặc biệt lưu ý với người dùng Việt Nam khi triển khai trong môi trường doanh nghiệp:

• Tên connector, schema và kết quả sẽ đi vào ngữ cảnh của mô hình Pi đang chọn. Pi và nhà cung cấp mô hình có thể lưu giữ chúng.
• Việc Codex giữ quyền quản lý chứng thực không đồng nghĩa kết quả connector được giữ kín trong Codex.
• Trước khi khám phá, tiện ích yêu cầu đồng thuận phiên. Chạy không giao diện phải đặt rõ PI_CODEX_CONNECTORS_DATA=allow; giá trị deny sẽ chặn truy cập.
• Có thể giới hạn phạm vi bằng PI_CODEX_CONNECTORS_ALLOW=GitHub (danh sách tên hoặc ID chính xác, phân tách bằng dấu phẩy).
• Phê duyệt ghi sẽ từ chối tham số dài quá 2000 ký tự. WRITES=allow bỏ qua phê duyệt hoàn toàn — chỉ dùng trong tự động hóa đáng tin cậy.
• Kết quả lớn bị cắt bớt trong bộ nhớ, không được tiện ích lưu lại. Hãy thu hẹp truy vấn hoặc phân trang để lấy thêm dữ liệu.

Một giới hạn kỹ thuật đáng chú ý: giao thức app-server không có phương thức hủy theo từng lời gọi cho các cuộc gọi connector. Nếu xảy ra hủy, hết thời gian chờ hoặc mất kết nối sau khi lệnh đã được gửi đi, kết quả được báo là không xác định, chứ không phải đã hủy. Các thao tác ghi bị ảnh hưởng sẽ chặn mọi thao tác ghi tiếp theo trong suốt vòng đời phiên — kể cả thao tác làm mới. Vì vậy, hãy kiểm tra ứng dụng đã kết nối trước khi khởi động lại phiên và không bao giờ tự động thử lại một thao tác ghi không chắc chắn.

Phát hành và giấy phép

Việc phát hành trên GitHub sẽ kích hoạt quy trình tự động kiểm tra phiên bản, typecheck, kiểm tra phụ thuộc runtime, xác minh nội dung gói và xuất bản kèm provenance. Bản ổn định dùng tag latest của npm, bản thử nghiệm dùng tag next.

Dự án phát hành theo giấy phép MIT. Tiện ích không import runtime SDK của Pi; các phụ thuộc peer của Pi SDK chỉ là hợp đồng kiểu tùy chọn.

Đối với cộng đồng lập trình viên và những người làm AI tại Việt Nam, công cụ này mở ra hướng tích hợp đa mô hình khá thú vị: chỉ cần một lần xác thực Codex là có thể tái sử dụng toàn bộ hệ sinh thái connector cho nhiều mô hình khác nhau. Tuy nhiên, vì dữ liệu connector sẽ đi vào ngữ cảnh mô hình, cần cân nhắc kỹ trước khi dùng trong môi trường có dữ liệu nhạy cảm.