Kết nối Workspace MCP Notiondesk với Claude Code để xem thông tin không gian làm việc và thực hiện các thao tác Notiondesk được hỗ trợ trực tiếp từ thiết bị đầu cuối của bạn.
Claude Code kết nối với Notiondesk như một máy chủ HTTP MCP từ xa và xác thực thông qua OAuth.
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 Claude Code đã được cài đặt và đang hoạt động trên máy tính của bạn.
Nếu Workspace MCP chưa được bật, hãy xem phần Bật Workspace MCP trong Notiondesk .
Thêm Notiondesk MCP vào Mã Claude
Chạy:
Thao tác này thêm máy chủ MCP Workspace Notiondesk vào Claude Code.
Đảm bảo Notiondesk có sẵn trên tất cả các dự án.
Nếu bạn muốn sử dụng Notiondesk MCP từ mọi dự án Claude Code, hãy thêm nó với phạm vi người dùng:
Nếu bạn chỉ muốn kết nối khả dụng trong một môi trường phát triển cụ thể, hãy sử dụng phạm vi dự án hoặc phạm vi cục bộ.
Xác thực bằng Notiondesk
Sau khi thêm máy chủ, hãy khởi động Claude Code:
Sau đó nhập:
Chọn máy chủ notiondesk và bắt đầu quy trình xác thực.
Claude Code mở Notiondesk trong trình duyệt của bạn.
Sau đó:
claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcpclaude/mcp- Đă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.
- Chấp thuận kết nối.
- Trở lại với Claude Code.
Claude Code lưu trữ thông tin xác thực OAuth cho kết nối và có thể làm mới thông tin đó khi cần thiết.
Xác minh máy chủ MCP
Bạn có thể kiểm tra các máy chủ MCP đã được cấu hình từ thiết bị đầu cuối của mình:
Bạn cũng có thể kiểm tra máy chủ Notiondesk:
Sau đó khởi động Claude Code và kiểm tra kết nối bằng lệnh:
Hãy xác nhận rằng các trung tâm trợ giúp dự kiến đã xuất hiện.
Tiếp theo, hãy thử:
Việc bắt đầu bằng các yêu cầu chỉ đọc giúp xác nhận rằng Claude Code đã được kết nối với không gian làm việc Notiondesk chính xác.
Sử dụng Notiondesk từ Claude Code
Sau khi kết nối, Claude Code có thể sử dụng các công cụ Notiondesk có sẵn khi chúng phù hợp với yêu cầu của bạn.
Ví dụ:
Hoặc:
Nếu vai trò Notiondesk của bạn cho phép thay đổi, bạn cũng có thể yêu cầu Claude Code thực hiện các hành động được hỗ trợ:
Các thao tác mà Claude Code có thể thực hiện phụ thuộc vào quyền truy cập không gian làm việc Notiondesk của bạn.
Làm việc với nhiều trung tâm hỗ trợ
Cùng một kết nối Claude Code có thể truy cập nhiều trung tâm trợ giúp Notiondesk.
Trung tâm hỗ trợ sẽ hoạt động khi:
claude mcp listclaude mcp get notiondeskList the Notiondesk help centers I can access.Show the sync status for my main help center.Review recent article feedback and search analytics. Show me which documentation needs attention first.Review recent chatbot conversations and identify repeated questions that are not covered well by our help center.Trigger a sync for the onboarding collection.- Workspace MCP đã được kích hoạt cho tính năng này.
- Tài khoản Notiondesk của bạn có quyền truy cập vào đó.
Bạn không cần phải cấu hình một máy chủ MCP riêng biệt cho mỗi trung tâm trợ giúp.
Khi có nhiều trung tâm trợ giúp, hãy chỉ định trung tâm mà bạn muốn Claude Code sử dụng.
Ví dụ:
Chọn phạm vi mã Claude phù hợp
Claude Code hỗ trợ nhiều phạm vi khác nhau cho máy chủ MCP.
Phạm vi địa phương
Phạm vi cục bộ là mặc định.
Hãy sử dụng nó khi bạn chỉ cần Notiondesk MCP trong dự án hiện tại.
Phạm vi dự án
Sử dụng phạm vi dự án khi cấu hình MCP cần được chia sẻ với các thành viên nhóm thông qua cấu hình .mcp.json của dự án.
Mỗi thành viên trong nhóm vẫn xác thực bằng tài khoản Notiondesk của riêng mình.
Không nên chia sẻ thông tin đăng nhập OAuth giữa các thành viên trong nhóm.
Phạm vi người dùng
Hãy sử dụng phạm vi người dùng khi bạn muốn Notiondesk khả dụng trên tất cả các dự án Claude Code trên máy tính của bạn:
Đối với hầu hết những người thường xuyên quản lý Notiondesk từ Claude Code, phạm vi người dùng là lựa chọn thuận tiện nhất.
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.
Ví dụ:
Check the French translation status for the Developer Docs help center.claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope project notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcp- Người xem có thể sử dụng các công cụ chỉ đọc được hỗ trợ.
- Người biên tập có thể truy cập các hành động 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.
Việc thêm Notiondesk MCP vào một dự án dùng chung không chia sẻ quyền Notiondesk của một thành viên nhóm với tất cả những người khác.
Mỗi thành viên trong nhóm xác thực riêng biệt.
Khắc phục sự cố
Claude Code không thể tìm thấy máy chủ MCP Notiondesk
Chạy:
Xác nhận rằng notiondesk xuất hiện.
Nếu vẫn không được, hãy thêm lại:
claude mcp listclaude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp Quá trình xác thực OAuth không bắt đầu.
Mở ứng dụng Claude Code và nhập:
Chọn máy chủ Notiondesk và bắt đầu xác thực.
Nếu trình duyệt của bạn không tự động mở, Claude Code có thể cung cấp một URL mà bạn có thể mở thủ công.
/mcp Máy chủ Notiondesk đã được thêm nhưng chưa được xác thực.
Sử dụng:
Sau đó, chọn máy chủ Notiondesk và hoàn tất quy trình OAuth.
Việc thêm máy chủ MCP và xác thực tài khoản Notiondesk của bạn là hai bước riêng biệt.
/mcp 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 nó.
Claude Code không thể truy cập trung tâm trợ giúp nếu tài khoản được sử dụng trong quá trình xác thực OAuth không cho phép truy cập.
Một số thao tác không khả dụng.
Không gian làm việc MCP tuân theo vai trò Notiondesk của bạn.
Nếu Claude Code có thể đọc thông tin nhưng không thể thực hiện một hành động cụ thể, tài khoản của bạn có thể không có quyền cần thiết.
Xem chi tiết về vai trò, quyền hạn và bảo mật của Workspace MCP .
Quá trình xác thực ngừng hoạt động.
Mở:
Chọn máy chủ Notiondesk và xác thực lại.
Bạn cũng có thể xóa xác thực hiện có từ menu MCP trước khi kết nối lại.
/mcpXóa Notiondesk MCP
Để xóa máy chủ khỏi Claude Code:
Việc xóa máy chủ khỏi Claude Code không vô hiệu hóa Workspace MCP trong Notiondesk và không ảnh hưởng đến các kết nối từ các máy khách AI khác.
claude mcp remove notiondesk