# 1. Kết nối

## 1.1 Claude (claude.ai, Claude Desktop, ứng dụng di động)

1. Mở **Settings → Connectors → Add custom connector**.
2. Đặt tên tuỳ ý (vd Algolab), dán URL `https://mcp.algolab.vn` → **Add**.
3. Bấm **Connect** → đăng nhập tài khoản Algolab một lần để cấp quyền (OAuth).
4. Mở cuộc trò chuyện mới, bật connector và hỏi, vd "VN-Index hôm nay thế nào?".

> Không muốn đăng nhập: dùng `https://mcp.algolab.vn/free` — pool chung cho mọi người, không có nhóm giao dịch.

## 1.2 ChatGPT (Plus, Pro, Business, Enterprise, Edu — bản web)

1. Settings → **Security and login** → bật **Developer mode** (giao diện cũ: Settings → **Apps & Connectors** → **Advanced**). Workspace Business/Enterprise: quản trị viên phải cho phép trước.
2. Mở mục **Plugins** (bản cũ: **Apps & Connectors**) → bấm **+** / **Create** → dán URL `https://mcp.algolab.vn`, xác thực **OAuth**.
3. Trong cuộc trò chuyện: **+ → Developer mode** (có thể nằm trong **More**) → chọn app Algolab.

## 1.3 Claude Code, Gemini CLI, Cursor, Antigravity

Tạo khoá tại [algolab.vn/mcp](https://algolab.vn/mcp) (hoặc mục "Cách 2" trên [trang giới thiệu](/)), rồi:

```
claude mcp add --transport http --scope user algolab "https://mcp.algolab.vn" --header "Authorization: Bearer alm_xxx"
```

Gemini CLI (`~/.gemini/settings.json`) — Cursor (`~/.cursor/mcp.json`) dùng khoá `url` thay cho `httpUrl`:

```
{
  "mcpServers": {
    "algolab": {
      "httpUrl": "https://mcp.algolab.vn",
      "headers": { "Authorization": "Bearer alm_xxx" }
    }
  }
}
```

## 1.4 Khoá API

- Khoá có dạng `alm_…`, gửi trong header `Authorization: Bearer alm_…`.
- Hạn mức ngày tính chung cho mọi khoá của một tài khoản (gói Plus trở lên).
- Lộ khoá: thu hồi và tạo khoá mới tại [algolab.vn/mcp](https://algolab.vn/mcp).
- Claude và ChatGPT dùng OAuth — tự cấp và làm mới token, không cần khoá.