MCP

MCP (Model Context Protocol) là chuẩn chung giúp trợ lý AI dùng công cụ. Genie hỗ trợ MCP theo hai chiều. Khi đóng vai trò máy chủ MCP, Genie cho phép các trợ lý như Claude Desktop, Claude Code, Cursor hay VS Code tìm trong kho tri thức và đặt câu hỏi cho Genie. Khi đóng vai trò client MCP, Genie cho phép agent của mình gọi công cụ từ các hệ thống khác mà bạn kết nối, kèm bước phê duyệt ở những chỗ bạn cần.

Genie làm máy chủ MCP

Mỗi workspace có thể phát hành một hoặc nhiều endpoint MCP. Mỗi endpoint có địa chỉ, token, kho tri thức và công cụ riêng, nên bạn có thể cấp cho từng nhóm hay từng trợ lý đúng những gì họ cần: ví dụ một endpoint chỉ đọc trên kho Nhân sự cho trợ lý của phòng nhân sự, và một endpoint riêng có công cụ ghi cho những người cập nhật tài liệu.

Tạo endpoint

Bạn cần vai trò Quản trị viên hoặc Chủ sở hữu.

Mở Cài đặt → Máy chủ MCP (trong nhóm Phát hành & tích hợp).
Bấm Endpoint mới.
Thông tin cơ bản: nhập Tên, ví dụ Tài liệu nhân sự, và có thể thêm Mô tả. Giữ Đã bật ở trạng thái bật.
Phạm vi kho tri thức: ở Kho tri thức được truy cập, chọn các kho tri thức endpoint được dùng. Để trống nếu muốn cho phép mọi kho tri thức trong workspace.
Công cụ được cung cấp: đánh dấu các công cụ mà trợ lý được phép gọi (xem bảng bên dưới). Công cụ chỉ đọc được đánh dấu sẵn; công cụ ghi thì không.
Cài đặt hỏi đáp: chọn Agent mặc định để trả lời qua công cụ ask. Để trống nếu muốn dùng Trả lời nhanh tích hợp sẵn.
Giới hạn tần suất: đặt Số lần gọi tối đa mỗi phút cho endpoint (mặc định 60).
Bấm Endpoint mới. Cửa sổ Endpoint đã sẵn sàng, hãy lưu token hiển thị Token, URL endpoint và phần Cấu hình client làm sẵn.
Sao chép token ngay và lưu ở nơi an toàn: Genie chỉ hiển thị token một lần. Sau đó bấm Hoàn tất.

Cài đặt → Máy chủ MCP: nơi tạo endpoint cho các kho tri thức của bạn

Nhóm công cụ	Công cụ	Trợ lý làm được gì
Truy xuất & đọc	`list_knowledge_bases`, `search_knowledge`, `grep_chunks`, `list_documents`, `read_document`	Liệt kê kho tri thức và tài liệu, tìm đoạn văn theo ý nghĩa hoặc khớp chính xác từ ngữ, và đọc tài liệu
Hỏi đáp	`ask`	Nhận câu trả lời có trích dẫn từ agent mặc định của endpoint, và hỏi tiếp trong cùng hội thoại
Wiki	`wiki_search`, `wiki_read_page`, `wiki_index`	Tìm và đọc wiki của các kho tri thức có wiki
Ghi (bật cẩn thận)	`add_document`, `update_document`, `delete_document`	Thêm tài liệu từ văn bản Markdown hoặc địa chỉ web, sửa hoặc xóa vĩnh viễn tài liệu

Kết nối trợ lý

Nhập URL endpoint và token vào phần cài đặt MCP của trợ lý. URL endpoint có dạng https://genie.contoso.test/mcp/<endpoint ID>. Thay <YOUR_TOKEN> bằng token của bạn.

Với Cursor, VS Code, Claude Desktop và các trợ lý hỗ trợ Streamable HTTP, thêm đoạn sau vào cấu hình mcpServers:

json

{
  "mcpServers": {
    "genie-hr-documents": {
      "url": "https://genie.contoso.test/mcp/6c0e2a4b-91f3-4d7a-b5e8-3f1d2c9a7e40",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Với Claude Code, chạy lệnh sau trong terminal:

bash

claude mcp add --transport http genie-hr-documents https://genie.contoso.test/mcp/6c0e2a4b-91f3-4d7a-b5e8-3f1d2c9a7e40 --header "Authorization: Bearer <YOUR_TOKEN>"

Với trợ lý chỉ hỗ trợ máy chủ cục bộ (stdio), kết nối qua mcp-remote. Cách này cần cài Node.js trên máy người dùng:

json

{
  "mcpServers": {
    "genie-hr-documents": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://genie.contoso.test/mcp/6c0e2a4b-91f3-4d7a-b5e8-3f1d2c9a7e40", "--header", "Authorization: Bearer <YOUR_TOKEN>"]
    }
  }
}

Để kiểm tra kết nối, hãy yêu cầu trợ lý liệt kê các kho tri thức Genie mà trợ lý thấy được.

Quản lý endpoint

Mở menu của endpoint trong danh sách:

Thông tin kết nối hiển thị lại URL endpoint và cấu hình client, không kèm token.
Tắt và Bật để tắt hoặc bật endpoint.
Xoay vòng token cấp token mới. Token cũ ngừng hoạt động ngay, nên hãy cập nhật mọi trợ lý đang dùng token đó.

Khi bạn xóa endpoint, các trợ lý đang dùng endpoint đó sẽ bị ngắt kết nối ngay lập tức.

Trợ lý thấy được gì

Chỉ các kho tri thức trong phạm vi của endpoint, và chỉ tài liệu không bị giới hạn trong đó. Tài liệu có phân quyền tài liệu không bao giờ xuất hiện.
Chỉ các công cụ đã đánh dấu. Lệnh gọi tới công cụ chưa đánh dấu sẽ bị từ chối, kể cả khi trợ lý gọi đúng tên.
ask luôn chạy agent mặc định của endpoint; trợ lý không chọn được agent khác. Công cụ này không tìm trên web, không truy vấn Cơ sở dữ liệu hay Power BI, và không chạy mã.
Lệnh gọi vượt quá Số lần gọi tối đa mỗi phút sẽ nhận lỗi giới hạn tần suất.

Kết nối công cụ MCP cho agent

Dịch vụ MCP là máy chủ công cụ của một hệ thống khác, ví dụ hệ thống ticket hay CRM của công ty, mà agent của Genie có thể gọi khi trả lời. Bạn cần vai trò Quản trị viên hoặc Chủ sở hữu.

Thêm dịch vụ MCP

Trên thanh bên, mở Công cụ, rồi chọn thẻ Dịch vụ MCP.
Bấm Thêm dịch vụ.
Kết nối: nhập Tên dịch vụ và URL dịch vụ, chọn Kiểu truyền tải (SSE hoặc HTTP Streamable), và trong mục Xác thực chọn Phương thức xác thực:
- Không có / Header tùy chỉnh: không cần đăng nhập, hoặc một header cố định do bạn thêm;
- Khóa API / Token: khóa hoặc token mà dịch vụ cấp cho bạn;
- OAuth 2.0 (ủy quyền ở lần kết nối đầu tiên): mỗi người đăng nhập dịch vụ bằng tài khoản của chính mình ở lần đầu agent dùng dịch vụ.
Bấm Lưu và tiếp tục. Genie kết nối tới dịch vụ và liệt kê các công cụ của dịch vụ.
Công cụ và cách dùng: với từng công cụ, tắt Đã bật với công cụ mà agent không bao giờ được gọi, và bật Yêu cầu phê duyệt với công cụ làm thay đổi dữ liệu hoặc gửi nội dung ra bên ngoài.
Ở Hướng dẫn sử dụng, mô tả dịch vụ dùng để làm gì và khi nào nên dùng, hoặc bấm Tạo bằng AI rồi xem lại nội dung. Agent đọc phần hướng dẫn này để quyết định khi nào dùng dịch vụ.
Bấm Lưu.

Genie phải kết nối được tới dịch vụ MCP qua mạng. Genie chỉ kết nối qua SSE hoặc Streamable HTTP; Genie không hỗ trợ máy chủ MCP cục bộ (stdio). Nếu dịch vụ chạy trong mạng nội bộ, hãy hỏi nhà cung cấp Genie cách để Genie truy cập được.

Cho agent dùng dịch vụ

Mở agent trong trình chỉnh sửa agent. Chỉ các agent có dùng công cụ mới dùng được dịch vụ MCP.
Mở mục Dịch vụ MCP và chọn Tất cả (mọi dịch vụ MCP của workspace) hoặc Đã chọn, rồi chọn dịch vụ ở Chọn dịch vụ MCP.
Lưu agent.

Phê duyệt lệnh gọi công cụ

Khi agent muốn gọi một công cụ đã bật Yêu cầu phê duyệt, câu trả lời tạm dừng và khung trò chuyện hiện một thẻ phê duyệt ghi rõ dịch vụ, công cụ và Tham số. Người đặt câu hỏi sẽ:

kiểm tra tham số và sửa nếu cần;
bấm Phê duyệt & chạy để chạy công cụ, hoặc Từ chối để không cho chạy.

Nếu không ai quyết định trước khi đồng hồ đếm ngược trên thẻ hết giờ, lệnh gọi bị hủy và agent tiếp tục mà không dùng công cụ đó. Với dịch vụ OAuth, lần đầu tiên thẻ sẽ hiện nút Ủy quyền: người dùng đăng nhập dịch vụ trong cửa sổ mới, sau đó lệnh gọi tự tiếp tục.

Lưu ý

Token của endpoint cho phép truy cập tài liệu của bạn. Hãy cấp cho mỗi trợ lý hay mỗi nhóm một endpoint riêng, và xoay vòng token nếu bị lộ.
Chỉ bật công cụ ghi cho endpoint dành cho người được phép sửa tài liệu. delete_document xóa tài liệu vĩnh viễn.
Endpoint MCP không đại diện cho một người cụ thể: mọi người dùng endpoint đều thấy cùng một tập tài liệu.
Tắt Đã bật của một công cụ là biện pháp chặt hơn so với yêu cầu phê duyệt: agent hoàn toàn không thấy công cụ đó.
Câu hỏi qua MCP được tính vào hạn mức hằng tháng của workspace, nếu workspace có đặt hạn mức.

MCP ​

Genie làm máy chủ MCP ​

Tạo endpoint ​

Kết nối trợ lý ​

Quản lý endpoint ​

Trợ lý thấy được gì ​

Kết nối công cụ MCP cho agent ​

Thêm dịch vụ MCP ​

Cho agent dùng dịch vụ ​

Phê duyệt lệnh gọi công cụ ​

Lưu ý ​

Trang liên quan ​

MCP