Cài vào Codex / ChatGPT (plugin)¶
Cùng plugin với bản Claude Code, cùng 11 kỹ năng phân tích, cùng repo — chỉ khác cách cài. Kết nối một lần trên chatgpt.com, cài plugin bằng hai lệnh, xong. Không có API key nào để dán.
Hai mảnh ghép, đừng lẫn¶
| Mảnh | Cho bạn cái gì | Cài ở đâu |
|---|---|---|
| Trình kết nối (MCP qua OAuth) | dữ liệu — quyền gọi API nền tảng của bạn | một lần trên chatgpt.com, trong trình duyệt |
| Plugin | kỹ năng — trợ lý biết hỏi endpoint nào, dựng tham số ra sao | codex plugin add, hai lệnh |
Cả hai đều cần. Kết nối mà không có plugin thì trợ lý phải tự mò; plugin mà không có kết nối thì nó biết cách hỏi nhưng không có dữ liệu để hỏi.
Cài trong 3 bước¶
1. Thêm trình kết nối Logidata trong ChatGPT¶
ChatGPT → Cài đặt → Trình kết nối → Nâng cao → bật Chế độ nhà phát triển
→ quay lại Trình kết nối → Tạo, điền URL https://mcp.logidata.vn/mcp,
xác thực OAuth, Client ID chatgpt (Client Secret để trống) → Tạo →
đăng nhập tài khoản Logidata → Đồng ý.
Hướng dẫn từng bước kèm ảnh chụp màn hình (gồm cả panel OAuth nâng cao): Kết nối MCP.
2. Cài plugin¶
codex plugin marketplace add getlogidata/agent-plugins
codex plugin add logidata@logidata
codex plugin list
Lệnh là add, không phải install. codex plugin list phải thấy logidata.
3. Gõ $setup¶
Trong phiên Codex, gõ $ để mở danh sách kỹ năng rồi chọn logidata:setup.
Thấy đúng gói, các kết nối đang hoạt động và hạn mức còn lại là xong.
Bề mặt nào dùng được¶
Trình kết nối gắn với tài khoản ChatGPT, nên kết nối một lần là mọi bề mặt đăng nhập cùng tài khoản đều thấy:
| Bề mặt | Trình kết nối | Plugin | Ghi chú |
|---|---|---|---|
| Codex CLI (terminal) | có | có | đúng ba bước ở trên |
| App ChatGPT desktop (chạy Codex) | có | có | đúng ba bước ở trên |
| ChatGPT web / desktop / mobile | có | — | chat thường, không cần plugin |
| Codex trong VS Code / JetBrains | có | không nạp plugin | kỹ năng cài theo phụ lục A |
Có gì trong plugin¶
11 kỹ năng, chia ba nhóm:
| Nhóm | Kỹ năng | Khi nào dùng |
|---|---|---|
Vận hành — gõ tay bằng $ |
setup, quota, doctor |
kiểm tra kết nối, xem hạn mức, chẩn lỗi từ mã lỗi |
| Phân tích — trợ lý tự chọn | analyze-ads, analyze-orders, reconcile-finance, unify-platforms, analyze-youtube, analyze-search |
bạn chỉ cần hỏi bằng tiếng Việt |
| Tích hợp — trợ lý tự chọn | generate-client, export-data |
sinh code Python/TypeScript, job xuất CSV/Sheets/Postgres |
Nhóm Vận hành được đánh dấu không cho trợ lý tự gọi — chỉ hiện khi bạn gõ $
và chọn tay, để nó không tự chạy giữa một cuộc phân tích.
Kỹ năng hiện ra với tên logidata:<tên>.
Nền tảng¶
| Nền tảng | Ví dụ trợ lý trả lời được |
|---|---|
| TikTok Ads | Chi tiêu, CPC/CPM/CTR, hiệu suất chiến dịch |
| TikTok Shop | Đơn hàng, đối soát hai tầng, đơn affiliate |
| Shopee (kèm Shopee Ads, Shopee Affiliate) | Đơn hàng, escrow, hiệu suất CPC |
| Google Ads | Báo cáo GAQL, Keyword Planner |
| YouTube | Video, playlist, watch time, từ khoá người xem tìm ra kênh, doanh thu kênh (kênh đã bật kiếm tiền) |
| Google Search Console | Query thật người dùng gõ để vào website |
| Google Sheets | Đọc sheet của bạn làm bảng tra cứu, ghép với dữ liệu nền tảng |
Trợ lý chỉ thấy phần nền tảng bạn đã cấp quyền ở Kết nối.
Cần biết trước¶
- Mỗi lượt lấy dữ liệu tính 1 request vào hạn mức tháng, kể cả khi nền tảng trả lỗi. Các lượt tra danh mục (tìm endpoint, xem mô tả) thì miễn phí.
- Tất cả chỉ đọc — không có đường nào sửa hay xoá chiến dịch, đơn hàng.
- Phản hồi quá lớn bị cắt và đánh dấu
truncated. Trợ lý sẽ tự thu hẹp khoảng ngày rồi hỏi lại, không kết luận trên phần đã cắt. - Kết nối tạo ra một API key tên "ChatGPT (OAuth)" ở
portal
/keys. Thu hồi nó là cắt luôn quyền truy cập, chậm nhất sau một phút.
Gỡ rối nhanh¶
| Bạn thấy | Làm gì |
|---|---|
codex plugin list không thấy logidata |
Chạy lại codex plugin marketplace add … rồi codex plugin add logidata@logidata |
| Có kỹ năng nhưng không có số liệu | Trình kết nối chưa xong — làm lại bước 1 trên chatgpt.com |
| Kỹ năng hiện hai lần | Đã cài cả plugin lẫn kỹ năng USER — gỡ một bên (phụ lục A) |
| "Chưa có kết nối nào" | Portal → Kết nối → cấp quyền nền tảng bạn cần |
| CLI báo không nhận model | codex -c 'model="gpt-5.5"' — xem cảnh báo ở phụ lục A |
Ca nào không có ở đây thì gõ $doctor và dán nguyên văn lỗi.
Phụ lục A — Codex trong VS Code / JetBrains¶
Codex IDE extension không nạp plugin. Nhưng nó đọc kỹ năng phạm vi USER và dùng chung trình kết nối với tài khoản ChatGPT của bạn — nên bạn không mất chức năng nào, chỉ khác cách cài kỹ năng:
- Windows:
.\install-skills.ps1 - macOS / Linux:
./install-skills.sh
Script trỏ 11 kỹ năng vào ~/.agents/skills/ bằng junction (Windows) hoặc
symlink. Gỡ: thêm cờ -Uninstall / --uninstall. Mở lại IDE rồi gõ $.
Đừng cài cả plugin lẫn kỹ năng USER trên cùng máy
Mọi kỹ năng sẽ hiện hai lần. Chọn một: plugin cho CLI và app desktop,
script install-skills cho IDE.
~/.codex/config.toml dùng chung cho ba nơi
Codex CLI, IDE extension và app ChatGPT desktop đọc cùng một file. Tiện,
nhưng cũng chia sẻ luôn thứ bên kia không hiểu: nếu app desktop ghi
model = "gpt-5.2-codex" mà lệnh codex trong terminal từ chối chính model
đó, chạy CLI với codex -c 'model="gpt-5.5"'.
Phụ lục B — cắm bằng API key¶
Chỉ cần đến mục này nếu bạn không dùng tài khoản ChatGPT để kết nối — ví dụ agent nội bộ, hoặc máy không đăng nhập được Chế độ nhà phát triển.
Lấy API key ở portal.logidata.vn/keys rồi:
Đặt biến môi trường LOGIDATA_API_KEY bằng key đó. Hoặc dùng GUI trong IDE:
gear → MCP servers → Add server → Streamable HTTP.
Key có giới hạn IP không dùng được
Kết nối đi qua hạ tầng Logidata nên máy chủ không thấy IP thật của bạn, và việc xác thực từ chối thay vì bỏ qua allowlist. Dùng một key để trống phần giới hạn IP. Key vừa tạo mà báo 401 thì chờ một phút — bộ nhớ đệm 60 giây.
Thử bản plugin chưa lên GitHub
Đang phát triển plugin và muốn cài bản trong máy: trỏ marketplace vào đường
dẫn thư mục repo thay vì getlogidata/agent-plugins.
install-skills.ps1 chỉ chứa ký tự ASCII — Windows PowerShell 5.1 đọc
.ps1 theo bảng mã ANSI, comment tiếng Việt có dấu sẽ làm hỏng parser.