Kết nối AI client với Aki MCP Server

Trước khi kết nối

• Server của bạn đang chạy và Funnel đã bật (xem trang Cài đặt).
• Lấy MCP URL và passphrase từ control panel (hoặc ~/.aki/mcpsv/passphrase.txt).
• Dán đoạn hướng dẫn hai dòng ở mục 3 của panel vào AI của bạn một lần. Nó cố định, nên không bao giờ phải dán lại.

IDE local: Cursor, Claude Code, Codex

Các client này chạy cùng máy, nên kết nối thẳng tới http://127.0.0.1:9999/mcp bằng access token dùng chung lấy từ panel. Không tunnel, chạy offline. Dùng đúng 127.0.0.1, không dùng localhost.

• Cursor: thêm mục aki-mcp với url và header Authorization: Bearer … vào ~/.cursor/mcp.json.
• Claude Code: chạy claude mcp add --transport http aki-mcp http://127.0.0.1:9999/mcp --header "Authorization: Bearer YOUR_TOKEN".
• Codex: thêm bảng [mcp_servers.aki-mcp] với url và http_headers vào ~/.codex/config.toml.

Mỗi tab trong nhóm Local của panel hiển thị sẵn đoạn cấu hình đã điền token của bạn.

AGY (Antigravity) CLI và IDE

AGY kết nối như một lệnh stdio, nên không có URL và không có token để dán. Panel cài giúp bạn.

1. 1Ở tab AGY của panel, bấm Apply to AGY CLI.
2. 2Nó đăng ký akimcp trong ~/.gemini/config/mcp_config.json và cho phép sẵn mcp(akimcp/*) trong ~/.gemini/antigravity-cli/settings.json, nên CLI thôi hỏi từng tool. Nó gộp vào cấu hình sẵn có và chạy lại được an toàn.
3. 3Antigravity IDE đọc cùng mcp_config.json, nên cũng kết nối được. IDE giữ hộp thoại duyệt từng tool riêng.

Claude.ai web connector

1. 1Vào claude.ai → Settings → Connectors → Add custom connector.
2. 2Nhập Remote MCP server URL: https://your-machine.ts.net/mcp.
3. 3Mở Advanced settings và dán OAuth Client ID và Client Secret từ panel.
4. 4Nhấn Connect, rồi nhập passphrase trên trang xác nhận cục bộ để phê duyệt.

ChatGPT web và mobile

Tự động nhận diện, không cần cấu hình OAuth thủ công.

1. 1Vào ChatGPT → Settings → Connectors → New connector.
2. 2Đặt Server URL là MCP URL lấy từ panel.
3. 3Tick I understand and want to continue, rồi bấm Create.
4. 4Khi kết nối, nhập passphrase. ChatGPT tự đăng ký qua DCR, không cần dán Client ID.

Grok

Đã xác minh, sẵn sàng production.

1. 1Thêm một custom MCP connector mới trong Grok. Đặt Name khớp chính xác với MCP Name hiện trong panel.
2. 2Dán cùng MCP URL. Không cần Client ID: Grok tự đăng ký qua DCR giống ChatGPT.
3. 3Nhấn Connect và nhập passphrase để phê duyệt.

Postman AI Agent

Postman chạy cùng máy, nên nó kết nối thẳng tới engine local tại http://127.0.0.1:9999/mcp — độ trễ bằng 0, offline, không tunnel. Postman không có OAuth redirect cho MCP server bên thứ ba, nên bạn dán Bearer token đã cấp thay vì vậy.

1. 1Trong tab Postman của panel (nhóm Local), bấm vào JSON đã điền để sao chép. Nó trỏ tới URL loopback http://127.0.0.1:9999/mcp và chứa access token thật (không phải passphrase).
2. 2Trong Postman, thêm MCP server mới tại Settings → Connected Accounts và dán JSON.
3. 3Vẫn ở tab Postman, bấm Launch để mở Postman, rồi Send now để gửi đoạn hướng dẫn ngắn vào chat đang mở. Bật Auto-inject nếu muốn gửi vào mọi chat mới (mặc định tắt).

Gemini (thử nghiệm)

Chỉ gói Gemini trả phí. Kết nối chạy được, nhưng dùng tool chưa ổn định.

1. 1Thêm custom app trỏ tới MCP URL.
2. 2Dán OAuth Client ID và Client Secret trong Advanced Settings (confidential client, giống Claude).
3. 3Nhập passphrase trên trang xác nhận để phê duyệt.

Qua nhiều lần thử, Gemini chấp nhận kết nối nhưng không phát hiện/điều khiển tool ổn định. Hãy ưu tiên Claude, Grok hoặc ChatGPT lúc này.