# Thiết lập MCP (/vi/mcp-server)





<McpCallout className="my-2" showLink="false" />

MCP server của Tapaya Docs cho phép AI agent và IDE tìm kiếm trong tài liệu này và khám phá trực tiếp REST API của Tapaya mà bạn không cần rời khỏi trình soạn thảo. Server này chỉ đọc, công khai và không yêu cầu API key hay khóa bí mật nào.

## URL của server [#server-url]

<ServerUrl url="https://docs.tapaya.com/mcp" />

Server giao tiếp qua Streamable HTTP và hoạt động với mọi MCP client. Một manifest khám phá cũng được công bố tại [`/.well-known/mcp.json`](/.well-known/mcp.json) cho các client hỗ trợ khám phá MCP qua địa chỉ well-known.

## Kết nối client của bạn [#connect-your-client]

<Tabs items="['Claude Code', 'Cursor', 'VS Code', 'Claude Desktop', 'Other']">
  <Tab value="Claude Code">
    Cài đặt plugin (khuyến nghị):

    ```bash
    claude plugin marketplace add tapayadot/tapaya-mcp
    claude plugin install tapaya-docs@tapaya
    ```

    Hoặc thêm server trực tiếp mà không cần plugin:

    ```bash
    claude mcp add --transport http tapaya-docs https://docs.tapaya.com/mcp
    ```

    Sau đó kiểm tra xem server đã được kết nối chưa:

    ```bash
    claude mcp list
    ```
  </Tab>

  <Tab value="Cursor">
    <McpInstallButton client="cursor" className="mb-4" />

    Hoặc thêm thủ công nội dung sau vào `~/.cursor/mcp.json`:

    ```json
    {
      "mcpServers": {
        "tapaya-docs": {
          "url": "https://docs.tapaya.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab value="VS Code">
    <McpInstallButton client="vscode" className="mb-4" />

    Hoặc thêm thủ công nội dung sau vào `.vscode/mcp.json` trong workspace của bạn:

    ```json
    {
      "servers": {
        "tapaya-docs": {
          "type": "http",
          "url": "https://docs.tapaya.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab value="Claude Desktop">
    Thêm nội dung sau vào cấu hình MCP của Claude Desktop:

    ```json
    {
      "mcpServers": {
        "tapaya-docs": {
          "url": "https://docs.tapaya.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab value="Other">
    MCP là một giao thức mở. Trỏ bất kỳ client Streamable HTTP nào đến URL của server `https://docs.tapaya.com/mcp`. Bạn có thể liệt kê các công cụ có sẵn bằng một yêu cầu thô:

    ```bash
    curl -s https://docs.tapaya.com/mcp \
      -H "Content-Type: application/json" \
      -H "Accept: application/json, text/event-stream" \
      -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
    ```
  </Tab>
</Tabs>

## Các công cụ có sẵn [#available-tools]

| Tài nguyên      | Công cụ                | Mô tả                                                 |
| --------------- | ---------------------- | ----------------------------------------------------- |
| **Công cụ API** | `search_docs`          | Tìm kiếm toàn văn trên tất cả các trang tài liệu.     |
|                 | `get_page`             | Lấy toàn bộ nội dung Markdown của một trang theo URL. |
|                 | `list_pages`           | Liệt kê mọi trang kèm tiêu đề, URL và mô tả.          |
|                 | `search_api_endpoints` | Tìm kiếm trong REST API của Tapaya theo từ khóa.      |
|                 | `get_api_endpoint`     | Lấy đầy đủ tham số và phản hồi của một endpoint.      |

## Lưu ý và an toàn [#notes-and-safety]

> Server này chỉ đọc. Server không bao giờ gọi Tapaya API thật và không bao giờ yêu cầu API key hay khóa bí mật.

Khi kết hợp nhiều MCP server, hãy thận trọng như thường lệ với prompt injection từ đầu ra của công cụ, và bật xác nhận của con người cho các công cụ khi client của bạn hỗ trợ.

Bạn phát hiện vấn đề hoặc muốn có thêm công cụ? Hãy mở một issue trên repository tài liệu.