Kết nối trợ lý AI

Bạn cần đúng hai thứ: một địa chỉ và một key. Không phải cài phần mềm, không phải tải tiện ích, không phải cập nhật gì về sau.

Lấy địa chỉ và key

Địa chỉ hub có dạng https://<tên miền công ty bạn>/api/mcp/biz/<mã Biz>. Mã Biz là 12 ký tự cố định, xem ở Cài đặt Biz.

Claude Desktop

Mở Settings → Developer → Edit Config, dán vào claude_desktop_config.json, rồi khởi động lại Claude.

{
  "mcpServers": {
    "cong-ty-abc": {
      "type": "http",
      "url": "https://coreskill.congty.com/api/mcp/biz/a3f1c9d2b7e4",
      "headers": {
        "Authorization": "Bearer cek_1a2b3c4d_..."
      }
    }
  }
}

Tên entry (cong-ty-abc) do CoreSkill sinh từ tên Biz hoặc tên server, đã bỏ dấu tiếng Việt. Bạn đổi được tùy ý, vì nó chỉ là nhãn hiển thị trong Claude.

Claude Code

Chạy một lần trong terminal:

claude mcp add --transport http cong-ty-abc \
  https://coreskill.congty.com/api/mcp/biz/a3f1c9d2b7e4 \
  --header "Authorization: Bearer cek_1a2b3c4d_..."

Cursor

Lưu thành .cursor/mcp.json trong dự án, hoặc thêm ở Cursor Settings → MCP. Nội dung giống hệt Claude Desktop.

ChatGPT

1. 1

   Mở ChatGPT Settings → Connectors.

2. 2

   Chọn "Add MCP server".

3. 3

   Dán URL server, tức địa chỉ hub của bạn.

4. 4

   Thêm Header: Authorization: Bearer <key của bạn>.

Nếu bản ChatGPT bạn đang dùng không cho đặt header, thẻ Hướng dẫn kết nối có sẵn một ô Gắn key vào URL, tức địa chỉ đã nhét sẵn key vào cuối. Đọc cảnh báo kèm theo trước khi dùng.

Gemini CLI

Thêm vào ~/.gemini/settings.json. Chú ý trường tên là httpUrl, khác Claude:

{
  "mcpServers": {
    "cong-ty-abc": {
      "httpUrl": "https://coreskill.congty.com/api/mcp/biz/a3f1c9d2b7e4",
      "headers": {
        "Authorization": "Bearer cek_1a2b3c4d_..."
      }
    }
  }
}

Client khác

Tab JSON cho cấu hình chung, dùng được với hầu hết client nhận cấu hình dạng JSON:

{
  "mcpServers": {
    "cong-ty-abc": {
      "url": "https://coreskill.congty.com/api/mcp/biz/a3f1c9d2b7e4",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer cek_1a2b3c4d_..."
      }
    }
  }
}

Kiểm tra đã chạy chưa

1. 1

   Khởi động lại trợ lý AI sau khi sửa file cấu hình.

2. 2

   Hỏi nó: "liệt kê các skill bạn đang có".

   Nó sẽ gọi list_skills và đọc ra danh sách. Không thấy gì thì có thể bạn thật sự chưa được chia server nào, hãy kiểm tra ở trang Quyền của tôi.

3. 3

   Mở Nhật ký sử dụng trên CoreSkill để xác nhận.

   Lượt gọi vừa rồi phải hiện ra kèm tên bạn, tên tool và trạng thái OK. Đây là cách chắc chắn nhất để biết kết nối đã thông.

AI dùng skill như thế nào

Trợ lý có ba tool chỉ đọc. Bạn không cần gọi tay, nó tự chọn khi thấy công việc liên quan:

list_skills

Liệt kê mọi skill bạn đọc được, kèm server chứa nó. AI gọi cái này trước tiên.

get_skill

Lấy toàn văn một skill theo tên, kèm danh sách file đính kèm.

get_skill_file

Lấy nội dung một file đính kèm.

Không kết nối được

Nhật ký ghi cả lượt bị từ chối, nên nếu bạn thấy dòng trạng thái Từ chối kèm key của mình thì key đã tới được máy chủ. Vấn đề nằm ở key chứ không phải ở địa chỉ.