v4.2 | 2026-03-02 (CONN-CLOSE-FINAL: 6/6 agents verified, hồ sơ ĐÓNG)
SSOT kết nối Agent Data. Nhìn bảng biết ngay ai có gì, thiếu gì.
Đọc: search_knowledge("agent data SSOT connections")
Cập nhật: Sau mỗi lần thêm/sửa config agent
1. TỔNG QUAN KẾT NỐI — HỘI ĐỒNG AI (6 AGENTS)
| # |
AI / Agent |
Kết nối Agent Data |
Kết nối Directus |
Tình trạng tổng |
| 1 |
Claude Desktop |
✅ STDIO→HTTP bridge (11 tools) |
✅ STDIO bridge (10 tools) |
✅ ĐẦY ĐỦ |
| 2 |
Claude AI (web) |
✅ STDIO→HTTP bridge (11 tools) |
✅ STDIO bridge (10 tools) |
✅ ĐẦY ĐỦ |
| 3 |
Claude Code CLI |
✅ HTTP MCP (11 tools, CONN-FIX verified) |
✅ STDIO MCP (10 tools, CONN-FIX verified) |
✅ ĐẦY ĐỦ |
| 4 |
Codex CLI |
✅ HTTP MCP (11 tools) |
⚠️ OPS Proxy 23 collections (STDIO sandbox blocked) |
✅ HOẠT ĐỘNG |
| 5 |
GPT (ChatGPT) |
✅ REST Actions (10 tools, write có sẵn — CONN-CLOSE confirmed) |
✅ OPS Proxy (23 collections — PR #407) |
✅ ĐẦY ĐỦ (chờ User re-import) |
| 6 |
Gemini CLI |
✅ HTTP MCP (11 tools, GEMINI-CONNECT verified) |
✅ STDIO MCP (10 tools, GEMINI-CONNECT verified) |
✅ ĐẦY ĐỦ |
Code agents: Claude Code CLI + Codex CLI. Antigravity đã loại khỏi hệ thống (2026-03-01).
✅ = Có + đã verify | ⚠️ = Có config nhưng chưa verify | ❌ = Không có
| Tool |
Claude Desktop |
Claude AI (web) |
Claude Code CLI |
Codex CLI |
GPT |
Gemini CLI |
search_knowledge |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
list_documents |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
get_document |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
get_document_for_rewrite |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
upload_document |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
update_document |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
patch_document |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
delete_document |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
batch_read |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
move_document |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
ingest_document |
✅ |
✅ |
✅ |
✅ |
✅ |
✅ |
| Tổng |
11/11 |
11/11 |
11/11 |
11/11 |
10/11 |
11/11 |
GPT = 10/11 (thiếu ingest_document — chưa có trong OpenAPI spec). CONN-CLOSE Phase 0.1 confirmed.
3. CHI TIẾT CONFIG TỪNG AGENT
⚠️ LƯU Ý CONFIG LOCATIONS (CONN-ENFORCE discovery)
- Claude Code CLI KHÔNG ĐỌC
~/.claude/mcp.json — dùng ~/.claude.json
- Codex CLI:
~/.codex/config.toml
- Gemini CLI:
~/.gemini/settings.json
3.1 Claude Desktop + Claude AI (web)
| Mục |
Giá trị |
| Protocol |
STDIO → HTTP bridge |
| Config |
~/Library/Application Support/Claude/claude_desktop_config.json |
| Auth |
Env var AGENT_DATA_API_KEY → header X-API-Key |
| Endpoint |
https://vps.incomexsaigoncorp.vn/api/mcp |
| Tools |
11/11 ✅ |
| Verify |
2026-02-28 (MCP-FORTRESS) |
3.2 Claude Code CLI
| Mục |
Giá trị |
| Protocol |
HTTP MCP (Streamable HTTP) |
| Config |
~/.claude.json (user scope) + .mcp.json (repo) |
| Auth |
Env var AGENT_DATA_API_KEY |
| Endpoint |
https://vps.incomexsaigoncorp.vn/api/mcp |
| Bootstrap |
claude-go (alias/function) |
| Tools |
11/11 ✅ |
| Verify |
2026-03-01 (CONN-FIX) |
3.3 Codex CLI
| Mục |
Giá trị |
| Protocol |
HTTP MCP (Streamable HTTP) |
| Config |
~/.codex/config.toml |
| Auth |
env_http_headers → AGENT_DATA_API_KEY |
| Endpoint |
https://vps.incomexsaigoncorp.vn/api/mcp |
| Bootstrap |
codex-adtest / codex-web |
| Tools |
11/11 ✅ |
| Lưu ý |
PHẢI chạy trong repo dir, KHÔNG từ ~ |
| Verify |
2026-02-28 (MCP-UNIFY) |
3.4 GPT (ChatGPT)
| Mục |
Giá trị |
| Protocol |
REST / OpenAPI Actions |
| Config |
GPT Actions UI (import from URL only) |
| Auth |
X-API-Key (Custom Authentication) |
| Agent Data spec |
https://vps.incomexsaigoncorp.vn/api/openapi.json |
| OPS Proxy spec |
https://ops.incomexsaigoncorp.vn/openapi.json |
| Tools |
10/11 ✅ (CONN-CLOSE confirmed write endpoints exist) |
| OPS Proxy |
23 collections (PR #407, 2026-03-01) |
| Action cần |
User re-import cả 2 specs vào GPT Actions UI |
| Verify |
2026-03-01 (CONN-CLOSE Phase 0.1) |
3.5 Gemini CLI
| Mục |
Giá trị |
| Protocol |
HTTP MCP (Streamable HTTP) + STDIO MCP |
| Config |
~/.gemini/settings.json |
| Auth |
API key literal (chmod 600) — Gemini CLI không hỗ trợ env var expansion |
| Endpoint |
https://vps.incomexsaigoncorp.vn/api/mcp |
| Bootstrap |
gemini-go (web-test) / gemini-adtest (agent-data-test) |
| Free tier |
60 req/min, 1000 req/day, 1M token context |
| Model |
gemini-2.5-pro (default) |
| Tools |
11/11 Agent Data + 10/10 Directus ✅ |
| Known issue |
google-workspace extension ENOENT sau update v0.31.0 |
| Verify |
2026-03-01 (GEMINI-CONNECT) |
4. ƯU TIÊN KẾT NỐI (Enforcement)
| Tình huống |
Đường ưu tiên |
| Agent cần đọc/ghi KB |
MCP tools (search_knowledge, patch_document...) |
| Agent cần CRUD Directus (Claude family) |
Directus MCP tools (10 tools) |
| Agent cần CRUD Directus (GPT/Codex) |
OPS Proxy REST (23 collections) |
| Shell scripts cần data |
DOT tools (supplementary) |
5. HÀNH ĐỘNG CẦN LÀM
| # |
Việc |
Ai |
Trạng thái |
| 1 |
Re-import 2 specs vào GPT Actions UI |
User |
⚠️ CHỜ USER — spec Council + Agent Data |
| 2 |
Verify Codex OPS Proxy full CRUD |
Codex |
✅ DONE (SELFTEST-S95: 10/10 PASS) |
| 3 |
Fix google-workspace ENOENT trên Gemini v0.31.0 |
Gemini CLI |
🔵 THẤP — không blocking |
6. LỊCH SỬ THAY ĐỔI
| Date |
Event |
Result |
| 2026-02-28 |
MCP-UNIFY |
5 agents → Agent Data KB ✅ |
| 2026-02-28 |
CONN-ENFORCE |
Claude Code ✅ (10 Directus tools) |
| 2026-02-28 |
CONN-FINAL |
OPS Proxy 23 collections, DOT 75 tools |
| 2026-03-01 |
CONN-FIX |
Claude Code env var ✅, nginx ✅, test 37/37 |
| 2026-03-01 |
CONN-CLOSE |
GPT write confirmed, OPS spec 23 cols (PR #407), Docker mem (PR #408) |
| 2026-03-01 |
v4.0 |
Loại Antigravity. GPT = 10/11 tools. Gemini CLI đang setup |
| 2026-03-01 | GEMINI-CONNECT | Gemini CLI v0.31.0, 11+10 tools, bootstrap gemini-go/gemini-adtest |
| 2026-03-02 | CONN-PROTECT | Claude Code selftest 18/19+1SKIP, config backup+restore scripts (PR #282), pre-deploy gate |
| 2026-03-02 | CONN-CLOSE-FINAL | 6/6 agents verified, hồ sơ kết nối ĐÓNG |
v4.2 | 2026-03-02 | CONN-CLOSE-FINAL. ALL 6 agents verified. Config backup deployed. Hồ sơ ĐÓNG.