# Cho AI và agent

> Hướng dẫn cho AI và agent: llms.txt, bản Markdown mọi trang, cổng MCP chỉ đọc www.vuduykien.com/mcp (Claude, ChatGPT, Cursor), điều khoản trích nguồn.

Tác giả: TS.BS. Vũ Duy Kiên. Trang xem: https://www.vuduykien.com/cho-ai/

---

Dành cho máy đọc

Trang này dành cho người dùng trợ lý AI và cho chính các agent: đọc site ở đâu cho gọn, kết nối cổng MCP thế nào, và dùng nội dung ra sao cho đúng.

## AI được đọc những gì

- Toàn bộ bài viết trên site là bài đọc miễn phí. [robots.txt](https://www.vuduykien.com/robots.txt) của www.vuduykien.com cho phép mọi máy quét (`Allow: /`), kể cả bot của các hãng AI; chỉ chặn `/api/`, trang tìm kiếm và các trang giao dịch (nhận quà).
- Site không có trang tài khoản. Trang kết quả tìm kiếm và trang giao dịch (nhận quà) mang `noindex`.
- Mỗi trang có dữ liệu cấu trúc JSON-LD (schema.org): WebSite, Person, BlogPosting, BreadcrumbList.

## Tệp dành cho AI

| Địa chỉ | Nội dung |
| --- | --- |
| [/llms.txt](https://www.vuduykien.com/llms.txt) | Mục lục cho mô hình ngôn ngữ (chuẩn llmstxt.org): các trang chính và mọi bài, mỗi bài một dòng tóm tắt. |
| [/llms-full.txt](https://www.vuduykien.com/llms-full.txt) | Toàn văn mọi bài trong một tệp Markdown, kèm tài liệu tham khảo. |
| /<trang>.md | Bản Markdown của **mọi trang** trong sitemap: thêm `.md` vào đường dẫn (trang chủ là [/index.md](https://www.vuduykien.com/index.md), [/ve-toi.md](https://www.vuduykien.com/ve-toi.md), [/chuyen-muc.md](https://www.vuduykien.com/chuyen-muc.md)…); bài viết, ví dụ [/bai/citescore-la-gi.md](https://www.vuduykien.com/bai/citescore-la-gi.md), kèm tài liệu tham khảo. Trang HTML trỏ tới bản này bằng `<link rel="alternate" type="text/markdown">`. |
| [/.well-known/mcp/server-card.json](https://www.vuduykien.com/.well-known/mcp/server-card.json) | Thẻ máy chủ MCP (JSON) để agent tự tìm cổng MCP và công cụ mà không cần đọc trang này; cùng nội dung ở [/.well-known/mcp.json](https://www.vuduykien.com/.well-known/mcp.json). Theo bản nháp [SEP-1649](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1649) của MCP (chuẩn chưa chính thức). |
| [/sitemap.xml](https://www.vuduykien.com/sitemap.xml) | Danh sách mọi trang, có ngày cập nhật. |
| [/rss.xml](https://www.vuduykien.com/rss.xml) | Nguồn cấp RSS 2.0 của bài viết, mới nhất trước — để theo dõi bài đăng mới. |

## Cổng MCP (chỉ đọc)

Địa chỉ: `https://www.vuduykien.com/mcp` — giao thức Model Context Protocol, kiểu Streamable HTTP, không cần khóa, giới hạn 60 lượt gọi mỗi phút. Mọi công cụ chỉ đọc nội dung công khai: không tạo đơn, không nhận thanh toán, không có dữ liệu người đọc.

### Thêm vào trợ lý AI

- **Claude** (claude.ai, Claude Desktop): Cài đặt → Connectors → Add custom connector → dán địa chỉ trên.
- **Claude Code**: `claude mcp add --transport http vuduykien https://www.vuduykien.com/mcp`
- **ChatGPT** (gói có Developer mode): Cài đặt → Apps & Connectors → Advanced settings → bật Developer mode → Create, dán địa chỉ, chọn không xác thực. Tên các mục có thể đổi theo phiên bản ứng dụng.
- **Cursor**: thêm vào `.cursor/mcp.json` (hoặc `~/.cursor/mcp.json`):

```
{
  "mcpServers": {
    "vuduykien": {
      "url": "https://www.vuduykien.com/mcp"
    }
  }
}
```

Ứng dụng chỉ hỗ trợ MCP chạy tại máy (stdio): dùng cầu nối `npx mcp-remote https://www.vuduykien.com/mcp`. Thử nhanh bằng dòng lệnh:

```
curl -X POST https://www.vuduykien.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"thu","version":"1.0"}}}'
```

### Công cụ

Cả năm công cụ đều đánh dấu chỉ đọc (`readOnlyHint`). Agent lấy danh sách này bằng `tools/list`, hoặc đọc trước khi kết nối ở [thẻ máy chủ MCP](https://www.vuduykien.com/.well-known/mcp/server-card.json).

| Tên | Việc làm |
| --- | --- |
| `webnc_list_articles` | Liệt kê bài viết (lọc theo chuyên mục, từ khóa): tiêu đề, mã bài, tóm tắt, ngày, đường dẫn. |
| `webnc_get_article` | Đọc một bài theo mã bài (ví dụ impact-factor-la-gi): nội dung Markdown kèm tài liệu tham khảo. |
| `webnc_search` | Tìm trong tiêu đề, tóm tắt và nội dung các bài. |
| `webnc_list_categories` | Danh sách chuyên mục. |
| `webnc_author_bio` | Tiểu sử tác giả và các kênh kết nối (YouTube, Fanpage, nhóm Zalo, khóa học, sách, tổng quan tài liệu). |

## Điều khoản dùng nội dung

- Được đọc, tóm tắt, trả lời câu hỏi dựa trên bài viết. Khi trích, ghi tên tác giả **TS.BS. Vũ Duy Kiên** và đường dẫn tới bài gốc trên www.vuduykien.com.
- Không đóng gói lại nội dung để bán, không dùng làm bộ dữ liệu bán lại, không đăng lại toàn văn ở nơi khác.
- Bài viết hướng dẫn phương pháp nghiên cứu, không phải lời khuyên chẩn đoán hay điều trị. Số liệu trong bài có nguồn ở mục "Tài liệu tham khảo" — trích số liệu thì dẫn cả nguồn gốc.
- Cần dùng khác các điều trên: [liên hệ tác giả](https://www.vuduykien.com/lien-he/).