Connection Dashboard — SSOT
v2.1 | 2026-03-08 S107 — Kết nối ổn định. Thêm: entity_dependencies collection (PR #456), OPS Proxy cần whitelist thêm nếu Codex/GPT cần truy cập entity_dependencies.
Bảng tổng hợp DUY NHẤT về tình trạng kết nối toàn bộ hệ thống.
Đọc: search_knowledge("connection dashboard")
Cập nhật: Sau mỗi CONN mission hoặc agent selftest.
1. BẢNG TỔNG HỢP — 6 AGENTS × 2 SERVICES
| # |
Agent |
Agent Data |
Directus |
Tổng tools |
Latency TB |
Selftest |
Lần verify cuối |
| 1 |
Claude Desktop |
✅ STDIO→HTTP (11) |
✅ STDIO (10) |
21 |
~1-3s |
✅ 19/19 PASS |
SELFTEST 2026-03-01 |
| 2 |
Claude AI (web) |
✅ STDIO→HTTP (11) |
✅ STDIO (10) |
21 |
~1-3s |
✅ Shared config |
SELFTEST 2026-03-01 |
| 3 |
Claude Code CLI |
✅ HTTP MCP (11) |
✅ STDIO (10) |
21 |
~2-5s |
✅ 18/19+1SKIP |
SELFTEST-S95 2026-03-02 |
| 4 |
Codex CLI |
✅ HTTP MCP (11/11) |
✅ OPS Proxy (8/8) + STDIO MCP (10) |
19+ |
AD ~7.3s, DT ~1.3s |
✅ 18/19 PASS, 1 SKIP |
SELFTEST-S95 2026-03-02 |
| 5 |
GPT (ChatGPT) |
✅ REST Actions (9/9) |
✅ OPS Proxy 15/15 PASS (spec Council ready, chờ import) |
9 + 19* |
~8-15s |
✅ 15/15 PASS |
SELFTEST 2026-03-01 |
| 6 |
Gemini CLI |
✅ HTTP MCP (11) |
✅ STDIO (10) |
21 |
~7-10s |
✅ 19/19 PASS |
GEMINI-SELFTEST 2026-03-01 |
Chú thích:
- ✅ = Verified hoạt động bằng evidence (selftest report)
- ⚠️ = Spec deployed trên VPS nhưng GPT chưa import → chưa dùng được
- *GPT Directus: spec Council deployed (19 ops, 7 collections). Chờ User import vào GPT Actions UI.
2. GPT — CHI TIẾT KIẾN TRÚC & SPEC
2.1 Hai kết nối độc lập
| Kết nối |
URL |
Spec |
Auth |
Trạng thái |
| Agent Data KB |
vps.incomexsaigoncorp.vn/api/ |
openapi.json (10 ops) |
X-API-Key |
✅ Đã import, hoạt động. Cần re-import bản mới nhất |
| Directus OPS Proxy |
ops.incomexsaigoncorp.vn |
openapi-council.json (19 ops) |
X-API-Key |
⚠️ Spec deployed, CHƯA import vào GPT Actions |
2.2 OPS Proxy Specs — 2 phiên bản
| Spec |
URL |
Collections |
Ops |
Dùng cho |
| Full |
ops.incomexsaigoncorp.vn/openapi.json |
23 |
105 |
Codex CLI (không giới hạn ops) |
| Council |
ops.incomexsaigoncorp.vn/openapi-council.json |
7 |
19 |
GPT Hội đồng AI (giới hạn 30 ops) |
2.3 Bảng Nhiệm vụ → Endpoint (điểm danh spec Council)
| # |
Nhiệm vụ GPT Council |
Action |
Endpoint |
Spec? |
Ghi chú |
| — |
COMMENT & PHẢN BIỆN |
|
|
|
|
| 1 |
Đọc comments của task |
GET + filter |
GET /items/task_comments |
✅ |
filter[task_id] |
| 2 |
Đọc 1 comment |
GET by id |
GET /items/task_comments/{id} |
✅ |
|
| 3 |
Tạo comment (phản biện) |
POST |
POST /items/task_comments |
✅ |
Required: task_id, content, tab_scope, agent_type |
| 4 |
Sửa comment |
PATCH |
PATCH /items/task_comments/{id} |
✅ |
|
| 5 |
Xóa comment |
DELETE |
DELETE /items/task_comments/{id} |
✅ |
|
| — |
QUẢN LÝ NHIỆM VỤ |
|
|
|
|
| 6 |
Xem danh sách tasks |
GET list |
GET /items/tasks |
✅ |
|
| 7 |
Đọc chi tiết task |
GET by id |
GET /items/tasks/{id} |
✅ |
|
| 8 |
Cập nhật nội dung task |
PATCH |
PATCH /items/tasks/{id} |
✅ |
content_*, checklist_version |
| — |
ĐIỀU HÀNH AGENTS |
|
|
|
|
| 9 |
Xem AI tasks |
GET list |
GET /items/ai_tasks |
✅ |
|
| 10 |
Đọc AI task |
GET by id |
GET /items/ai_tasks/{id} |
✅ |
|
| 11 |
Cập nhật AI task |
PATCH |
PATCH /items/ai_tasks/{id} |
✅ |
|
| 12 |
Tạo AI task (giao việc) |
POST |
POST /items/ai_tasks |
✅ |
GPT tự tạo task dispatch agents |
| — |
SOẠN THẢO |
|
|
|
|
| 13 |
Xem bài viết/kế hoạch |
GET list |
GET /items/posts |
✅ |
|
| 14 |
Đọc bài viết |
GET by id |
GET /items/posts/{id} |
✅ |
|
| 15 |
Tạo bài viết |
POST |
POST /items/posts |
✅ |
|
| 16 |
Sửa bài viết |
PATCH |
PATCH /items/posts/{id} |
✅ |
|
| — |
ĐỌC CONTEXT |
|
|
|
|
| 17 |
Đọc cấu trúc trang |
GET list |
GET /items/pages |
✅ |
Read-only |
| 18 |
Đọc menu |
GET list |
GET /items/navigation |
✅ |
Read-only |
| 19 |
Đọc cấu hình site |
GET list |
GET /items/globals |
✅ |
Read-only |
Tổng: 19/19 endpoints deployed. GPT sẵn sàng tự chủ 100% sau khi import spec.
19 ops / 30 limit = 37% headroom cho tương lai mở rộng.
2.4 GPT Roadmap
| Phase |
Nội dung |
Trạng thái |
| GPT Hội đồng AI |
spec Council — soạn thảo, comment, phản biện, điều hành agents |
⚠️ Spec deployed, chờ import + v3 |
| GPT Khách hàng (tầm nhìn) |
spec riêng — contacts, help_articles, inbox, forms_submissions |
🔵 Chưa tạo |
2.5 Hành động GPT tiếp theo
| # |
Việc |
Ai làm |
Trạng thái |
| 1 |
OPS-SPEC-SLIM-v3 |
Claude Code CLI |
✅ DONE (PR #411+#412) |
| 2 |
Import spec Council vào GPT Actions UI |
User (manual) |
⏳ SẴN SÀNG — URL: ops.incomexsaigoncorp.vn/openapi-council.json |
| 3 |
Re-import Agent Data spec mới nhất |
User (manual) |
⏳ URL: vps.incomexsaigoncorp.vn/api/openapi.json |
| 4 |
GPT self-verify CRUD toàn bộ 19 ops |
GPT |
⏳ Sau import |
3. MA TRẬN KẾT NỐI CHI TIẾT
3.1 Agent Data (Knowledge Base)
| Agent |
Transport |
Config file |
Auth |
Tools |
CRUD verified |
| Claude Desktop |
STDIO→HTTP bridge |
claude_desktop_config.json |
Env → X-API-Key |
11/11 |
Read ✅ Write ✅ |
| Claude AI (web) |
STDIO→HTTP bridge |
claude_desktop_config.json |
Env → X-API-Key |
11/11 |
Read ✅ Write ✅ |
| Claude Code CLI |
HTTP MCP trực tiếp |
.mcp.json + ~/.claude.json |
Env → MCP headers |
11/11 |
Read ✅ Write ✅ |
| Codex CLI |
HTTP MCP trực tiếp |
~/.codex/config.toml |
env_http_headers |
11/11 |
Read ✅ Write ✅ |
| GPT |
REST OpenAPI Actions |
GPT Actions UI |
X-API-Key |
10/11 |
Read ✅ Write ✅ (chờ re-import Council) |
| Gemini CLI |
HTTP MCP (envsubst) |
~/.gemini/settings.template.json |
Env → envsubst → settings.json |
11/11 |
Read ✅ Write ✅ |
3.2 Directus (Database)
| Agent |
Transport |
Endpoint |
Auth |
Scope |
CRUD verified |
| Claude Desktop |
STDIO MCP |
directus_stdio_server.py |
credentials.local.json |
10 tools, full access |
✅ |
| Claude AI (web) |
STDIO MCP |
directus_stdio_server.py |
credentials.local.json |
10 tools, full access |
✅ |
| Claude Code CLI |
STDIO MCP |
directus_stdio_server.py |
credentials.local.json |
10 tools, full access |
✅ |
| Codex CLI |
OPS Proxy HTTP |
ops.incomexsaigoncorp.vn |
X-API-Key |
spec Full: 23 cols (105 ops) |
✅ 10/10 PASS |
| GPT |
OPS Proxy HTTP |
ops.incomexsaigoncorp.vn |
X-API-Key |
spec Council: 7 cols (19 ops) |
✅ 6/6 PASS (chờ import Council) |
| Gemini CLI |
STDIO MCP |
directus_stdio_server.py |
Static Token (Bearer) |
10 tools, full access |
✅ |
4. CƠ CHẾ BẢO VỆ HIỆN TẠI
| Lớp |
Cơ chế |
Trạng thái |
Coverage |
| Server health |
test-all-connections.sh (20 tests) |
✅ Active |
Server-side only |
| Agent endpoints |
test-agent-connections.sh (37 tests) |
✅ Active |
HTTP endpoints only |
| Config integrity |
check-config-integrity.sh (SHA256) |
✅ Active |
nginx + docker-compose only |
| Periodic health |
Cron 5 phút → mcp-health.log |
✅ Active |
Log only, no alert |
| Agent selftest |
✅ 6/6 agents tested |
Desktop 19/19, Gemini 19/19, Codex 18/19, GPT 15/15, Claude Code 18/19 |
Agent-level |
| Agent config backup |
✅ DEPLOYED (PR #282) |
7 files, SHA256, auto-prune 10 |
Local configs |
| Pre-deploy gate |
✅ DEPLOYED (PR #282) |
health + doc_count≥100 |
deploy-vps.yml |
| Config restore |
✅ DEPLOYED (PR #282) |
restore + checksum verify |
Rollback ready |
Lỗ hổng bảo vệ — ĐÃ XỬ LÝ (CONN-PROTECT S95):
Agent config không backup → ✅ backup-agent-configs.sh (7 files, SHA256, auto-prune)Không có pre-deploy test → ✅ deploy-vps.yml post-deploy gateClaude Code CLI chưa tự selftest → ✅ 18/19+1SKIP PASS
5. HÀNH ĐỘNG CÒN TỒN
| # |
Việc |
Agent |
Trạng thái |
Blocking? |
| 1 |
OPS-SPEC-SLIM-v3 |
Claude Code |
✅ DONE |
— |
| 2 |
GPT import 2 specs (Council + Agent Data) |
User manual |
⏳ SẴN SÀNG |
GPT full ops |
| 3 |
GPT self-verify CRUD 19 ops |
GPT |
⏳ Sau import |
Xác nhận GPT ready |
| 4 |
Claude Code CLI selftest |
Claude Code CLI |
✅ 18/19+1SKIP (S95) |
— |
| 5 |
CONN-PROTECT: Config backup + pre-deploy gate |
Claude Code CLI |
✅ PR #282 merged |
— |
| 6 |
Fix VPS SSH local (TD-054) |
User (Contabo panel) |
⏳ Khi rảnh |
Debug only |
6. LỊCH SỬ
| Ngày |
Sự kiện |
Kết quả |
| 2026-02-28 |
MCP-UNIFY + CONN-ENFORCE + CONN-FINAL |
5 agents connected, 20/20 server tests |
| 2026-03-01 |
CONN-FIX + CONN-CLOSE |
env var fix, nginx fix, Docker mem limits, spec expanded |
| 2026-03-01 |
GEMINI-CONNECT + GEMINI-SECURE |
Agent #6 connected + envsubst secured |
| 2026-03-01 |
AGENT-SELFTEST (4 agents) |
Desktop 19/19, Gemini 19/19, Codex 19/19, GPT 15/15 |
| 2026-03-02 |
OPS-SPEC-SLIM PR #409→#412 |
✅ HOÀN THÀNH: spec Council 7 collections, 19 ops. Chờ GPT import |
| 2026-03-02 |
ADTEST-DIAGNOSE |
agent-data-test CI GREEN, 238 docs, 471 vectors, sync OK. TD-054 VPS SSH |
| 2026-03-02 |
Codex S95 selftest |
18/19 PASS, 1 SKIP. CRUD Agent Data + Directus confirmed |
| 2026-03-02 |
CONN-CLOSE-FINAL |
6/6 agents verified. Protection deployed (PR #282). Hồ sơ kết nối ĐÓNG. |
Dashboard này cần được cập nhật sau mỗi selftest hoặc connection change.