> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/overview/vi/lam-viec-voi-cac-cong-cu-ai/connect-via-mcp.md).

# Kết nối qua MCP

VergeOS Docs cung cấp một dịch vụ được lưu trữ **máy chủ MCP (Model Context Protocol)**. Kết nối nó với một trợ lý AI — Claude, Cursor, VS Code Copilot, Codex và các trợ lý khác — và trợ lý đó có thể tìm kiếm và đọc trực tiếp tài liệu này trong khi hỗ trợ bạn, thay vì đoán mò hoặc dựa vào dữ liệu huấn luyện đã lỗi thời.

{% hint style="info" %}
Bạn cần một ứng dụng khách hỗ trợ **các máy chủ MCP từ xa qua HTTP**. Máy chủ này công khai, nên không cần khóa API hay đăng nhập.
{% endhint %}

## Máy chủ

|                            |                                      |
| -------------------------- | ------------------------------------ |
| **URL**                    | `https://docs.verge.io/~gitbook/mcp` |
| **Phương thức truyền tải** | HTTP có thể phát luồng               |
| **Xác thực**               | Không (công khai)                    |

## Thêm máy chủ

{% tabs %}
{% tab title="Claude Code" %}
Chạy lệnh CLI để thêm nó cho tài khoản người dùng của bạn:

```bash
claude mcp add vergeos-docs --scope user --transport http https://docs.verge.io/~gitbook/mcp
```

Sau đó xác nhận rằng nó đã kết nối:

```bash
claude mcp list
```

{% endtab %}

{% tab title="Claude Desktop" %}

1. Mở **Cài đặt → Trình kết nối**.
2. Chọn **Thêm trình kết nối tùy chỉnh**.
3. Đặt tên là `VergeOS Docs` và đặt URL thành:

   ```
   https://docs.verge.io/~gitbook/mcp
   ```
4. Lưu, rồi bật trình kết nối trong một cuộc trò chuyện mới.
   {% endtab %}

{% tab title="Cursor" %}
Thêm máy chủ vào `~/.cursor/mcp.json` (toàn cục) hoặc `.cursor/mcp.json` (theo từng dự án):

```json
{
  "mcpServers": {
    "vergeos-docs": {
      "url": "https://docs.verge.io/~gitbook/mcp"
    }
  }
}
```

{% endtab %}

{% tab title="VS Code" %}
Dùng liên kết cài đặt một lần:

```
vscode:mcp/install?%7B%22name%22%3A%22VergeOS%20Docs%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.verge.io%2F~gitbook%2Fmcp%22%7D
```

Hoặc thêm thủ công vào `.vscode/mcp.json`:

```json
{
  "servers": {
    "VergeOS Docs": {
      "url": "https://docs.verge.io/~gitbook/mcp"
    }
  }
}
```

{% endtab %}

{% tab title="Codex" %}
Chạy lệnh CLI:

```bash
codex mcp add vergeos-docs --url https://docs.verge.io/~gitbook/mcp
```

{% endtab %}
{% endtabs %}

## Bạn nhận được gì

Sau khi kết nối, trợ lý sẽ có hai công cụ:

* **`searchDocumentation`** — tìm kiếm trên toàn bộ VergeOS Docs và trả về nội dung khớp kèm liên kết trực tiếp đến trang.
* **`getPage`** — lấy toàn bộ Markdown của một trang tài liệu cụ thể.

## Thử dùng

Hãy hỏi trợ lý của bạn điều gì đó đáng lẽ phải lấy từ tài liệu, chẳng hạn:

{% hint style="success" %}

* "Tìm trong tài liệu VergeOS cách cấu hình đồng bộ hóa site."
* "Dùng tài liệu VergeOS, hãy tóm tắt các bước để di chuyển một VM từ VMware."
* "Tài liệu VergeOS nói gì về kích thước node cho một triển khai edge?"
  {% endhint %}

Nếu các công cụ khả dụng và câu trả lời trích dẫn các trang VergeOS Docs, thì kết nối đang hoạt động.

## Đi xa hơn với các kỹ năng tác tử

Máy chủ MCP cung cấp cho trợ lý quyền đọc tài liệu. Nếu bạn dùng **Claude Code** hoặc **Codex**, thì [gói kỹ năng VergeOS agent](/overview/vi/lam-viec-voi-cac-cong-cu-ai/agent-skills.md) bổ sung các quy trình làm việc tập trung vào nhiệm vụ — khắc phục sự cố, chẩn đoán, đào tạo và quản lý hạ tầng thông qua `vrg` CLI — và đóng gói sẵn chính máy chủ MCP tài liệu này cho bạn.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/overview/vi/lam-viec-voi-cac-cong-cu-ai/connect-via-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.