# Dùng docs với công cụ AI

Kết nối trợ lý lập trình AI của bạn với bộ docs này để nó tự tìm và đọc trong lúc giúp bạn tích hợp. Có ba cách, từ mạnh nhất đến đơn giản nhất: MCP server của docs, `llms.txt`, và bản Markdown của từng trang. Cả ba chỉ gồm docs công khai, không cần tài khoản hay key.

## MCP server của docs
MCP server của docs cho phép trợ lý AI hỗ trợ Model Context Protocol (MCP) tự tra cứu trong bộ docs này. Địa chỉ:

```text
https://docs.wandura.ai/mcp
```

Server dùng transport Streamable HTTP, không cần đăng nhập và chỉ đọc: nó không thấy tài khoản, key hay phim của bạn.

### Claude Code

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

```bash
claude mcp add --transport http wandura-docs https://docs.wandura.ai/mcp
```

Thêm `--scope project` để chia sẻ với cả team qua file `.mcp.json` của dự án.

### Cursor

Thêm đoạn sau vào `~/.cursor/mcp.json` (mọi dự án) hoặc `.cursor/mcp.json` (một dự án):

```json
{
  "mcpServers": {
    "wandura-docs": {
      "url": "https://docs.wandura.ai/mcp"
    }
  }
}
```

### VS Code

Thêm đoạn sau vào `.vscode/mcp.json`:

```json
{
  "servers": {
    "wandura-docs": {
      "type": "http",
      "url": "https://docs.wandura.ai/mcp"
    }
  }
}
```

### Claude Desktop

Mở **Settings → Connectors → Add custom connector**, đặt tên `Wandura Docs` và dán `https://docs.wandura.ai/mcp` vào ô URL.

### Công cụ

| Công cụ | Làm gì |
|---|---|
| `search_docs` | Tìm trong docs, trả về các mục khớp nhất kèm link và đoạn trích ngắn. Tuỳ chọn: `lang` (`en` hoặc `vi`, mặc định `en`), `limit` (1–10, mặc định 5), `version` (một phiên bản API cũ, nếu cần). |
| `read_page` | Trả về một trang dạng Markdown, ví dụ `/developers/quickstart` hoặc `/vi/developers/quickstart`. |
| `submit_feedback` | Gửi góp ý về một trang tới đội Wandura: `kind` là `bug` (có chỗ sai hoặc khó hiểu) hoặc `feature` (đề xuất). Hoạt động như nút **Gửi góp ý** và dùng chung giới hạn vài tin mỗi 10 phút. |

Thử bằng cách hỏi trợ lý: *"Dùng wandura-docs, làm sao xin playback cho một tập phim?"*

> **Lưu ý:** Chỉ gửi góp ý qua trợ lý khi bạn thật sự muốn gửi. Không bao giờ đưa API key, token hay dữ liệu cá nhân vào góp ý.

## llms.txt
Với công cụ chưa hỗ trợ MCP, hãy trỏ chúng tới các file chữ sau:

- `https://docs.wandura.ai/llms.txt`: danh sách mọi trang kèm tóm tắt một dòng.
- `https://docs.wandura.ai/llms-full.txt`: mọi trang gộp trong một file.
- Tiếng Việt: `https://docs.wandura.ai/vi/llms.txt` và `https://docs.wandura.ai/vi/llms-full.txt`.

## Bản Markdown của từng trang
Thêm `.md` vào cuối địa chỉ của bất kỳ trang nào để nhận bản Markdown, ví dụ `https://docs.wandura.ai/vi/developers/quickstart.md`. Nút **Chép trang** ở đầu mỗi trang chép đúng nội dung đó, sẵn để dán vào khung chat.