Directus — Kết nối & Tools theo từng AI/Agent

v3.0 | 2026-03-02 (CONN-CLOSE-FINAL: 6/6 agents verified, Antigravity loại) SSOT kết nối Directus. Nhìn bảng biết ngay ai có gì, thiếu gì. Đọc: search_knowledge("directus SSOT connections tools") Cập nhật: Sau mỗi lần thêm/sửa config agent hoặc OPS Proxy

---

1. TỔNG QUAN KẾT NỐI DIRECTUS — HỘI ĐỒNG AI (6 AGENTS)

#	AI / Agent	Phương thức	Phạm vi truy cập	Selftest	Tình trạng
1	Claude Desktop	✅ STDIO MCP (10 tools)	Toàn bộ collections	19/19	✅ ĐẦY ĐỦ
2	Claude AI (web)	✅ STDIO MCP (10 tools)	Toàn bộ collections	Shared config	✅ ĐẦY ĐỦ
3	Claude Code CLI	✅ STDIO MCP (10 tools)	Toàn bộ collections	8/8 PASS (S95)	✅ ĐẦY ĐỦ
4	Codex CLI	✅ OPS Proxy HTTP (23 cols)	23 collections (18 RW + 2 RO + 3 core)	8/8→10/10 PASS	✅ HOẠT ĐỘNG
5	GPT (ChatGPT)	✅ OPS Proxy REST	spec Council 7 cols (19 ops) + Full 23 cols	6/6 PASS (S93)	✅ ĐẦY ĐỦ (chờ import Council)
6	Gemini CLI	✅ STDIO MCP (10 tools)	Toàn bộ collections	19/19	✅ ĐẦY ĐỦ

Antigravity đã loại khỏi hệ thống (2026-03-01).

---

2. DIRECTUS MCP TOOLS — AI NÀO CÓ TOOL NÀO?

10 tools từ directus_stdio_server.py (agent-data-test/mcp_server/):

Tool	Claude Desktop	Claude AI	Claude Code	Codex (OPS)	GPT (OPS)	Gemini
directus_health	✅	✅	✅	curl ✅	—	✅
directus_list_collections	✅	✅	✅	—	—	✅
directus_get_schema	✅	✅	✅	—	—	✅
directus_get_items	✅	✅	✅	✅ 23 cols	✅ 7 cols	✅
directus_get_item	✅	✅	✅	✅ 23 cols	✅ 7 cols	✅
directus_create_item	✅	✅	✅	✅ 18 cols	✅ 5 cols	✅
directus_update_item	✅	✅	✅	✅ 18 cols	✅ 5 cols	✅
directus_delete_item	✅	✅	✅	✅ 18 cols	✅ 2 cols	✅
directus_list_flows	✅	✅	✅	—	—	✅
directus_trigger_flow	✅	✅	✅	—	—	✅
Tổng MCP	10/10	10/10	10/10	OPS Proxy	OPS Proxy	10/10

Codex + GPT dùng OPS Proxy REST thay vì STDIO MCP (sandbox block STDIO cho Codex, GPT không hỗ trợ MCP).

---

3. GPT VIA OPS PROXY — 2 SPECS

3.1 Spec Council (GPT Hội đồng AI) — 7 collections, 19 ops

URL: https://ops.incomexsaigoncorp.vn/openapi-council.json

Collection	GET	GET/{id}	POST	PATCH	DELETE
task_comments	✅	✅	✅	✅	✅
tasks	✅	✅	—	✅	—
ai_tasks	✅	✅	✅	✅	—
posts	✅	✅	✅	✅	—
pages	✅	—	—	—	—
navigation	✅	—	—	—	—
globals	✅	—	—	—	—

3.2 Spec Full (Codex CLI) — 23 collections, 105 ops

URL: https://ops.incomexsaigoncorp.vn/openapi.json Scope: 18 RW + 2 RO + 3 core collections. Full CRUD.

---

4. CHI TIẾT CONFIG TỪNG AGENT

4.1 Claude Desktop + Claude AI (web)

• Protocol: STDIO bridge → Directus API
• Config: claude_desktop_config.json
• Server: directus_stdio_server.py
• Auth: credentials.local.json (gitignored)
• Tools: 10/10 ✅ | Verify: SELFTEST 2026-03-01

4.2 Claude Code CLI

• Protocol: STDIO MCP
• Config: ~/.claude.json (user scope) — ~/.claude/mcp.json KHÔNG DÙNG
• Server: directus_stdio_server.py
• Auth: credentials.local.json
• Tools: 10/10 ✅ | Verify: SELFTEST-S95 2026-03-02

4.3 Codex CLI

• Protocol: OPS Proxy HTTP (STDIO bị sandbox block)
• Config: curl + env var AGENT_DATA_API_KEY
• Endpoint: https://ops.incomexsaigoncorp.vn
• Auth: X-API-Key header
• Scope: 23 collections (spec Full)
• Tools: OPS Proxy REST ✅ | Verify: SELFTEST-S95 2026-03-02 (10/10 PASS)

4.4 GPT (ChatGPT)

• Protocol: REST via OPS Proxy
• Config: GPT Actions UI (import from URL)
• Spec Council: ops.incomexsaigoncorp.vn/openapi-council.json (19 ops)
• Auth: X-API-Key
• Verify: SELFTEST 2026-03-01 (6/6 PASS) | Chờ import spec Council

4.5 Gemini CLI

• Protocol: STDIO MCP
• Config: ~/.gemini/settings.template.json → envsubst → settings.json
• Server: directus_stdio_server.py
• Auth: credentials.local.json
• Tools: 10/10 ✅ | Verify: GEMINI-SELFTEST 2026-03-01

---

5. KNOWN ISSUES

Issue	Ảnh hưởng	Workaround
task_comments.action không nhận null	Agents gửi null bị reject	Dùng action: "" (string rỗng)
tasks dùng field name không phải title	Query sai field → 403	Luôn check schema trước query
Codex sandbox block STDIO MCP	Không spawn directus_stdio_server.py	Dùng OPS Proxy HTTP

---

6. LỊCH SỬ

Date	Event	Result
2026-02-28	CONN-ENFORCE	Claude Code 10 tools ✅, Codex STDIO ❌
2026-02-28	CONN-FINAL	OPS Proxy 3→23 cols, 20/20 PASS
2026-03-01	CONN-FIX	nginx re-expanded, 23/23 GET verified
2026-03-01	CONN-CLOSE	GPT write confirmed, Docker mem limits
2026-03-01	GEMINI-CONNECT	Gemini 10/10 Directus tools ✅
2026-03-02	OPS-SPEC-SLIM	GPT Council spec 19 ops deployed
2026-03-02	CONN-CLOSE-FINAL	6/6 agents verified. Hồ sơ ĐÓNG.

---

v3.0 | 2026-03-02 | Cross-ref: Agent Data connections (knowledge/dev/ssot/agent-data/connections.md), Dashboard (connections/connection-dashboard.md)