Vertice AI

1. Vertice AI MCP Connector là gì?

---

Vertice AI MCP Connector là một endpoint được lưu trữ, cho phép một trợ lý AI bên ngoài tương thích — ví dụ như Claude — truy vấn không gian làm việc mua sắm (procurement) của Vertice và kích hoạt các quy trình làm việc của Vertice thay cho bạn, sử dụng ngôn ngữ tự nhiên. Nó triển khai giao thức Model Context Protocol (MCP) mã nguồn mở trên nền tảng Vertice hiện có.

Connector là một kênh truy cập bổ sung vào Vertice. Nó cung cấp cùng một dữ liệu mua sắm và quy trình làm việc mà bạn đã có thể sử dụng thông qua ứng dụng web Vertice, được quản lý bởi cùng các kiểm soát truy cập dựa trên vai trò.

Kết nối một trợ lý AI không cấp quyền truy cập vào bất cứ thứ gì mà bạn không thể tự thấy trong Vertice.

Trong suốt tài liệu này, chúng tôi sử dụng Claude làm ví dụ minh họa. Connector tương tự hoạt động với bất kỳ trợ lý AI tương thích MCP nào hỗ trợ giao thức truyền tải MCP Streamable HTTP và OAuth 2.1 với PKCE (S256).

2. Các trường hợp sử dụng ví dụ

---

Connector được thiết kế cho các câu hỏi và quy trình làm việc liên quan đến mua sắm. Dưới đây là các câu hỏi minh họa bạn có thể hỏi. Mỗi câu tương ứng với một trong các công cụ được liệt kê trong phần 4.

• "Hợp đồng nào trong danh mục của chúng tôi hết hạn trong 90 ngày tới?"
• "Tổng chi tiêu hàng năm của chúng tôi với nhà cung cấp này là bao nhiêu, và có những nhà cung cấp nào khác trong cùng danh mục?"
• "Tìm hợp đồng đã ký gần nhất cho nhà cung cấp này và tóm tắt các điều khoản gia hạn."
• "Mở một yêu cầu mua hàng mới cho thêm 25 chỗ ngồi cho sản phẩm của nhà cung cấp này."

Đây là các ví dụ. Tập hợp chính xác các công cụ, tham số và hành vi được xác định bởi lớp điều phối của Vertice tại thời điểm yêu cầu.

3. Khả năng tương thích và điều kiện tiên quyết

---

Yêu cầu	Chi tiết
Đăng ký Vertice đang hoạt động	Bạn phải là người dùng trên một tenant Vertice đang hoạt động.
Tài khoản người dùng Vertice	Một tài khoản người dùng trong tình trạng tốt, có quyền sử dụng các tính năng Vertice AI.
Xác thực	Connector xác thực bạn thông qua thiết lập xác thực Vertice hiện có của tenant. Nếu tenant của bạn sử dụng đăng nhập một lần (SSO) thông qua nhà cung cấp danh tính SAML 2.0, bạn đăng nhập bằng thông tin đăng nhập công ty thông thường. Nếu tenant của bạn sử dụng xác thực gốc của Vertice, bạn đăng nhập bằng tên người dùng và mật khẩu Vertice.
Đăng ký trợ lý AI	Một đăng ký với nhà cung cấp trợ lý AI bạn chọn hỗ trợ việc thêm các connector tùy chỉnh. Đối với Claude.ai, điều này hiện yêu cầu gói Team hoặc Enterprise; vui lòng tham khảo tài liệu của Anthropic để biết thông tin mới nhất về các gói có sẵn.

Connector tự nó là một dịch vụ được lưu trữ. Không có phần mềm nào được cài đặt trên cơ sở hạ tầng của bạn. Không có khóa API cá nhân nào được cấp.

4. Các danh mục công cụ

---

Connector hiển thị các công cụ trong các danh mục liên quan đến mua sắm sau đây. Mỗi công cụ quảng cáo các chú thích MCP readOnlyHint và destructiveHint rõ ràng, để các trợ lý AI tương thích có thể cảnh báo người dùng trước khi thực hiện các hành động ghi.

Danh mục	Chỉ đọc	Thực hiện ghi
Phân tích hợp đồng	✔
Phân tích chi tiêu	✔
Thông tin nhà cung cấp	✔
Tìm kiếm tài liệu	✔
Trạng thái tuân thủ	✔
Tạo yêu cầu mua hàng		✔ (tạo thêm — chỉ tạo thực thể mới)
Cập nhật metadata hợp đồng		✔ (thay đổi có kiểm soát)

Danh sách công cụ có thẩm quyền có thể khám phá trực tiếp trong trợ lý AI của bạn — trợ lý gọi phương thức MCP tools/list tiêu chuẩn đối với connector và hiển thị tên, mô tả và chú thích cho bạn.

Tập hợp chính xác các công cụ có thể thay đổi. Các chú thích trên mỗi công cụ sẽ tiếp tục cho biết nó đọc hoặc ghi.

5. Kết nối trợ lý AI của bạn

---

Mỗi tenant Vertice có URL connector riêng của mình theo dạng:

https://ai.vertice.one/accounts//mcp

Thay <your-account-id> bằng định danh tenant của bạn. Nếu bạn không biết định danh tenant của mình, vui lòng liên hệ Bộ phận hỗ trợ Vertice.

Thêm connector trong Claude.ai

---

1. Mở Claude.ai
2. Đi tới Cài đặt → Connectors → Thêm connector tùy chỉnh
3. Nhập tên (ví dụ: 'Vertice')
4. Dán URL connector từ trên
5. Nhấp vào Thêm
6. Claude mở một cửa sổ ủy quyền. Bạn sẽ được chuyển hướng đến nhà cung cấp xác thực của tenant (đăng nhập một lần của công ty nếu tenant của bạn sử dụng SSO, hoặc đăng nhập gốc của Vertice nếu không).
7. Đăng nhập bằng thông tin đăng nhập hiện có của bạn. Không có mật khẩu mới nào được tạo. Không có khóa API cá nhân nào được cấp.
8. Claude xác nhận connector đã được kết nối.

Bạn có thể hỏi Claude các câu hỏi liên quan đến mua sắm về dữ liệu Vertice của mình trong bất kỳ cuộc trò chuyện nào.

Liên kết cài đặt được điền sẵn

---

Để thuận tiện, quy trình tương tự có thể được bắt đầu bằng cách theo liên kết này:

https://app.vertice.one/preferences/user/integrations

6. Xác thực

---

Xác thực sử dụng OAuth 2.1 với PKCE (S256). Quy trình là:

1. Trợ lý AI của bạn tìm nạp metadata tài nguyên được bảo vệ RFC 9728 của connector để khám phá máy chủ ủy quyền.
2. Trợ lý AI tìm nạp metadata máy chủ ủy quyền RFC 8414 để khám phá các endpoint OAuth.
3. Trợ lý AI khởi tạo luồng mã ủy quyền OAuth 2.1 với PKCE.
4. Bộ chuyển tiếp /authorize của Vertice định tuyến bạn trực tiếp đến nhà cung cấp xác thực của tenant. Nếu tenant của bạn sử dụng SSO qua SAML, Vertice định tuyến bạn thẳng đến nhà cung cấp danh tính SAML đã cấu hình mà không có bước chọn Vertice nào ở giữa. Nếu tenant của bạn sử dụng xác thực gốc của Vertice, bạn sẽ thấy biểu mẫu đăng nhập Vertice.
5. Sau khi đăng nhập thành công, lớp danh tính của Vertice cấp một mã truy cập ngắn hạn gắn với người dùng của bạn, tenant của bạn và phạm vi tài nguyên của connector.
6. Trợ lý AI trình bày mã truy cập đó như một thông tin xác thực Bearer trên mỗi yêu cầu MCP đến Vertice.

Mã truy cập hết hạn tự động. Bạn có thể ngắt kết nối connector bất cứ lúc nào từ cài đặt của trợ lý AI; điều này không ảnh hưởng đến tài khoản Vertice của bạn.

7. Quyền

---

Connector thực thi các kiểm soát truy cập dựa trên vai trò hiện có của Vertice. Dữ liệu bạn có thể truy cập thông qua connector chính xác là dữ liệu bạn có thể truy cập thông qua ứng dụng web Vertice, không hơn.

Mô hình kiểm soát truy cập tương tự được chia sẻ trên tất cả các bề mặt Vertice — ứng dụng web, tích hợp Vertice cho Slack và Microsoft Teams, và Vertice AI MCP Connector. Mọi hành động sửa đổi dữ liệu, bất kể bề mặt nào khởi tạo, đều được ghi lại trong nhật ký kiểm toán hiện có của Vertice.

8. Giới hạn tốc độ

---

Để duy trì chất lượng dịch vụ, connector thực thi các giới hạn tốc độ ở lớp ứng dụng:

Phạm vi	Giới hạn
Mỗi người dùng đã xác thực	60 yêu cầu mỗi phút
Mỗi tenant Vertice (trên tất cả người dùng trong tài khoản)	300 yêu cầu mỗi phút

Khi đạt giới hạn, connector trả về lỗi JSON-RPC với mã -32004, ánh xạ tới HTTP 429 Too Many Requests với các header sau:

Retry-After: X-RateLimit-Limit: X-RateLimit-Remaining: 0 X-RateLimit-Reset:

Các trợ lý AI hoạt động tốt tôn trọng Retry-After. Trong sử dụng tương tác thông thường, bạn không nên đạt đến các giới hạn này. Chúng tồn tại chủ yếu để bảo vệ chống lại tự động hóa mất kiểm soát. Nếu khối lượng công việc hợp pháp của tenant bạn yêu cầu ngưỡng cao hơn, vui lòng liên hệ với Người quản lý tài khoản Vertice của bạn.

Cách Claude.ai hiển thị phản hồi giới hạn tốc độ

---

Khi đạt giới hạn tốc độ trong một cuộc trò chuyện Claude, máy khách Claude.ai có thể hiển thị phản hồi cho người dùng cuối như một thông báo lỗi công cụ chung thay vì như một thông báo giới hạn tốc độ rõ ràng. Phản hồi ở mức đường truyền tuân thủ thông số kỹ thuật; văn bản bề mặt hiển thị cho người dùng được xác định bởi trợ lý AI, không phải bởi Vertice. Nếu bạn gặp phải lỗi như vậy, hãy đợi vài giây trước khi thử lại.

9. Kích thước phản hồi của công cụ

---

Connector nhắm tới giới hạn phản hồi 25.000 token được định nghĩa bởi hướng dẫn của Anthropic Connectors Directory. Để giữ kết quả hữu ích cho các truy vấn rất lớn, một biện pháp cắt lưới an toàn được áp dụng ở khoảng 20.000 token; nếu nó kích hoạt, phản hồi bao gồm một chân trang rõ ràng cho biết việc cắt đã diễn ra và cách thu hẹp truy vấn. Trong sử dụng bình thường, lớp điều phối Vertice cơ bản được thiết kế để phân trang các thao tác danh sách lớn và bạn không nên thấy chân trang cắt.

10. Xử lý dữ liệu

---

Mô tả về tư thế bảo mật AI rộng hơn của Vertice — SOC 2 Type 2, mã hóa, cô lập tenant, nhà cung cấp mô hình và kiểm soát độ chính xác — được nêu trong Chính sách bảo mật AI MCP Connector của chúng tôi. Các tài liệu bảo mật bổ sung có sẵn trong Cổng tin cậy Vertice.

Quan trọng

Khi bạn hỏi bất kỳ trợ lý AI bên ngoài nào một câu hỏi gọi connector, lời nhắc của bạn và phản hồi của connector được truyền đến nhà cung cấp của trợ lý AI đó. Chính sách bảo mật và điều khoản của họ quy định việc họ làm với dữ liệu đó.

Vertice không kiểm soát hoặc kiểm toán việc xử lý hạ nguồn bởi nhà cung cấp trợ lý AI. Vui lòng xem xét các chính sách của nhà cung cấp trợ lý AI trước khi bật connector.

11. Hỗ trợ

---

Lý do	Kênh
Vấn đề chức năng, trợ giúp thiết lập	Bộ phận hỗ trợ Vertice ([email protected])
Câu hỏi về tài khoản	Người quản lý tài khoản của bạn
Câu hỏi về quyền riêng tư, yêu cầu về quyền của chủ thể dữ liệu	[email protected]
Tiết lộ lỗ hổng bảo mật	[email protected] — xem thêm Chính sách tiết lộ lỗ hổng của chúng tôi

12. Các câu hỏi thường gặp

---

Connector có gửi dữ liệu Vertice của tôi đến nhà cung cấp trợ lý AI của tôi không? Khi bạn hỏi một trợ lý AI bên ngoài một câu hỏi gọi đến connector, lời nhắc của bạn và phản hồi công cụ của connector được truyền đến hạ tầng của nhà cung cấp trợ lý AI (ví dụ: đến Anthropic cho connector Claude.ai). Đây là bản chất không thể tránh khỏi của một connector MCP. Vertice không kiểm soát hoặc kiểm toán những gì nhà cung cấp trợ lý AI làm với dữ liệu đó — điều đó được điều chỉnh bởi thỏa thuận của bạn với nhà cung cấp trợ lý AI. Chúng tôi khuyến khích mạnh mẽ bạn xem xét chính sách quyền riêng tư của nhà cung cấp trợ lý AI trước khi kích hoạt connector.

Connector có thấy lịch sử trò chuyện Claude của tôi hoặc bất kỳ dữ liệu nào khác bên trong Claude không?

Không. Connector chỉ nhận các phong bì yêu cầu MCP rõ ràng mà Claude gửi — tên công cụ và các tham số công cụ. Nó không có quyền truy cập vào bộ nhớ của Claude, tóm tắt hội thoại, các cuộc trò chuyện trước đó hoặc các tệp được tải lên Claude.

Connector có thực hiện thay đổi đối với dữ liệu Vertice của tôi mà không có sự chấp thuận của tôi không?

Các công cụ thực hiện ghi mang chú thích MCP destructiveHint và readOnlyHint=false rõ ràng, báo hiệu cho các trợ lý AI tương thích xác nhận với người dùng trước khi gọi chúng. Claude tuân theo mẫu này. Nếu bạn sử dụng trợ lý AI không tôn trọng các chú thích này, vui lòng chỉ sử dụng connector với các công cụ đọc hoặc tắt nó.

Hai người dùng trên cùng một tenant có thể chia sẻ cấu hình connector không?

Mỗi người dùng cuối xác thực riêng lẻ với danh tính của họ. URL connector là theo tenant; kết nối tự nó là theo người dùng. Mỗi người dùng chỉ thấy những gì vai trò Vertice của họ cho phép.

Connector có hoạt động ngoại tuyến hoặc trong môi trường cách ly mạng không?

Không. Connector là một dịch vụ được lưu trữ. Nó yêu cầu kết nối HTTPS đến từ hạ tầng của nhà cung cấp trợ lý AI. Không có tùy chọn tại chỗ hoặc tự lưu trữ.

Tôi có thể báo cáo lỗi hoặc yêu cầu công cụ mới ở đâu?

Báo cáo lỗi và yêu cầu tính năng được chuyển qua nhóm Hỗ trợ Vertice. Các vấn đề bảo mật nên được báo cáo trực tiếp đến [email protected].