Bạn có thể kết nối Workspace MCP của Notiondesk với bất kỳ máy khách AI tương thích nào hỗ trợ máy chủ MCP từ xa và xác thực OAuth .
Hãy sử dụng hướng dẫn này khi máy khách MCP của bạn không có hướng dẫn cài đặt Notiondesk chuyên dụng.
Trước khi bạn bắt đầu
Hãy đảm bảo:
- Workspace MCP được bật cho ít nhất một trung tâm trợ giúp Notiondesk
- Bạn có thể đăng nhập vào không gian làm việc Notiondesk mà bạn muốn kết nối.
- Ứng dụng khách MCP của bạn hỗ trợ máy chủ MCP HTTP từ xa.
- Ứng dụng khách MCP của bạn hỗ trợ xác thực OAuth.
Nếu Workspace MCP chưa được bật, hãy xem phần Bật Workspace MCP trong Notiondesk .
Thông tin kết nối
Hãy sử dụng các thông tin chi tiết này khi thêm Notiondesk vào ứng dụng khách MCP của bạn:
Không thêm /sse vào URL.
Điểm cuối Workspace MCP là:
Thêm máy chủ MCP
Mở cài đặt MCP hoặc trình kết nối của ứng dụng AI client của bạn.
Giao diện cụ thể tùy thuộc vào khách hàng, nhưng thông thường bạn sẽ cần thực hiện các bước sau:
Name: Notiondesk MCP
URL: https://mcp.notiondesk.so/mcp
Authentication: OAuthhttps://mcp.notiondesk.so/mcp- Thêm máy chủ MCP từ xa mới
- Nhập Notiondesk MCP làm tên.
- Nhập
https://mcp.notiondesk.so/mcplàm URL máy chủ.
- Chọn xác thực OAuth nếu ứng dụng khách yêu cầu phương thức xác thực.
- Lưu hoặc kết nối máy chủ
Nếu máy khách MCP của bạn sử dụng tệp cấu hình thay vì giao diện cài đặt, hãy thêm Notiondesk làm máy chủ MCP HTTP từ xa bằng cùng URL.
Hãy tham khảo tài liệu MCP của khách hàng để biết định dạng cấu hình chính xác.
Xác thực bằng Notiondesk
Sau khi thêm máy chủ, hãy bắt đầu quá trình kết nối hoặc xác thực.
Khách hàng của bạn nên mở Notiondesk trong trình duyệt của bạn.
Sau đó:
- Đăng nhập vào Notiondesk nếu cần.
- Hãy xác nhận rằng không gian làm việc chính xác đã được hiển thị.
- Xem xét lại các quyền được yêu cầu
- Phê duyệt kết nối
- Quay lại ứng dụng khách MCP của bạn
Workspace MCP sử dụng OAuth, vì vậy bạn không cần phải sao chép thủ công mật khẩu hoặc khóa API Notiondesk vào ứng dụng MCP của mình.
Xác minh kết nối
Bắt đầu với yêu cầu chỉ đọc:
Hãy xác nhận rằng các trung tâm trợ giúp dự kiến đã xuất hiện.
Sau đó hãy thử:
Bạn cũng có thể hỏi:
Việc bắt đầu bằng các yêu cầu chỉ đọc giúp xác nhận rằng máy khách đã kết nối với không gian làm việc Notiondesk chính xác trước khi thực hiện các hành động.
Sử dụng Workspace MCP
Sau khi kết nối, ứng dụng khách MCP của bạn có thể sử dụng các công cụ Notiondesk có sẵn trong tài khoản của bạn.
Ví dụ:
Hoặc:
Nếu vai trò Notiondesk của bạn cho phép thực hiện các thay đổi được hỗ trợ, bạn cũng có thể yêu cầu các hành động như sau:
Cách thức khách hàng của bạn phát hiện hoặc sử dụng các công cụ MCP phụ thuộc vào chính khách hàng đó.
Quyền hạn
Workspace MCP tuân theo quyền hạn của đồng đội Notiondesk người hoàn tất ủy quyền OAuth.
Việc kết nối thông qua một máy khách MCP khác không làm thay đổi quyền truy cập của bạn đối với Notiondesk.
Ví dụ:
List the Notiondesk help centers I can access.Show the sync status for my main help center.Show me the latest negative article feedback.Review our article feedback and analytics from the last 30 days. Show me which articles need attention first.Check the translation status for my main help center.Trigger a sync for the onboarding collection.- Người xem được cấp quyền truy cập chỉ đọc có hỗ trợ.
- Người biên tập có thể thực hiện các thao tác quản lý được hỗ trợ.
- Quản trị viên hoặc chủ sở hữu không gian làm việc có thể truy cập các thao tác quản trị bổ sung.
Ứng dụng khách MCP không thể có quyền truy cập cao hơn quyền mà tài khoản Notiondesk của bạn hiện có.
Làm việc với nhiều trung tâm hỗ trợ
Một kết nối Workspace MCP có thể cung cấp quyền truy cập vào nhiều trung tâm trợ giúp.
Trung tâm hỗ trợ sẽ hoạt động khi:
- Workspace MCP đã được kích hoạt cho nó.
- Tài khoản Notiondesk của bạn có quyền truy cập vào nó.
Bạn không cần URL Workspace MCP khác nhau cho mỗi trung tâm trợ giúp.
Cùng một điểm cuối được sử dụng:
Khi có nhiều trung tâm trợ giúp, hãy chỉ định trung tâm mà bạn muốn trợ lý ảo sử dụng.
Ví dụ:
Khắc phục sự cố
https://mcp.notiondesk.so/mcpReview article feedback for the Developer Docs help center. Khách hàng của tôi không thể kết nối với máy chủ.
Hãy xác nhận URL máy chủ chính xác là:
Không được sử dụng:
hoặc thêm /sse vào cuối phần tử.
Khách hàng của bạn phải hỗ trợ máy chủ MCP từ xa.
https://mcp.notiondesk.so/mcphttps://mcp.notiondesk.so/mcp/sse Quá trình xác thực OAuth không bắt đầu.
Ứng dụng khách MCP của bạn phải hỗ trợ xác thực OAuth cho các máy chủ MCP từ xa.
Nếu máy khách chỉ hỗ trợ máy chủ MCP cục bộ, khóa API hoặc tiêu đề tĩnh, nó có thể không tương thích với Workspace MCP.
Kiểm tra hồ sơ MCP của khách hàng.
Trung tâm trợ giúp bị thiếu
Xác nhận rằng:
- Workspace MCP đã được kích hoạt cho trung tâm trợ giúp đó.
- Tài khoản Notiondesk của bạn có quyền truy cập vào đó.
Workspace MCP không thể hiển thị trung tâm trợ giúp mà tài khoản của bạn không thể truy cập.
Một số công cụ không khả dụng
Các công cụ MCP có sẵn trong Workspace phụ thuộc vào vai trò của bạn.
Khách hàng MCP của bạn cũng có thể áp dụng các hạn chế riêng đối với những công cụ có thể được sử dụng.
Xem chi tiết về vai trò, quyền hạn và bảo mật của Workspace MCP .
Kết nối hoạt động nhưng các công cụ không được sử dụng tự động.
Việc lựa chọn các công cụ MCP phụ thuộc vào khách hàng AI.
Một số khách hàng yêu cầu bạn:
- Kích hoạt máy chủ MCP cho cuộc hội thoại
- Chọn đầu nối theo cách thủ công
- Cho phép sử dụng công cụ
- Phê duyệt các hành động cá nhân
Kiểm tra cài đặt MCP của máy khách nếu kết nối Notiondesk đang hoạt động nhưng các công cụ của nó không khả dụng trong các cuộc hội thoại.