Kết nối Workspace MCP Notiondesk với Codex để xem thông tin workspace và thực hiện các thao tác Notiondesk được hỗ trợ từ Codex CLI hoặc tiện ích mở rộng IDE.
Notiondesk hoạt động như một máy chủ MCP từ xa và sử dụng OAuth để xác thực tài khoản Notiondesk của bạn.
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.
- Codex đã đượ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 Codex
Chạy:
Thao tác này sẽ thêm máy chủ MCP Workspace Notiondesk vào cấu hình Codex của bạn.
Xác thực bằng Notiondesk
Sau khi thêm máy chủ, hãy chạy lệnh sau:
Trình duyệt của bạn đang mở trang xác thực OAuth Notiondesk.
Sau đó:
codex mcp add notiondesk --url https://mcp.notiondesk.so/mcpcodex mcp login notiondesk- Đă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 Codex.
Bạn không cần phải thêm thủ công khóa API, mật khẩu hoặc mã thông báo Notiondesk.
Việc xác thực được thực hiện thông qua OAuth.
Xác minh kết nối
Kiểm tra các máy chủ MCP đã được cấu hình của bạn:
Xác nhận rằng notiondesk xuất hiện và được kích hoạt.
Sau đó, bạn có thể khởi động Codex:
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ử:
Việc bắt đầu bằng các yêu cầu chỉ đọc giúp dễ dàng xác nhận rằng Codex đã được 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 thao tác.
Sử dụng Workspace MCP từ Codex.
Sau khi kết nối, Codex có thể sử dụng các công cụ Notiondesk có sẵn khi chúng phù hợp với nhiệm vụ 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 Codex thực hiện các hành động:
Các hành động khả dụng phụ thuộc vào vai trò của bạn và các trung tâm trợ giúp mà bạn có thể truy cập.
Sử dụng Notiondesk MCP từ tiện ích mở rộng Codex IDE.
Codex chia sẻ cấu hình MCP của mình giữa giao diện dòng lệnh (CLI) và các tích hợp IDE được hỗ trợ.
Sau khi cấu hình Notiondesk với:
Máy chủ MCP tương tự cũng có thể được truy cập thông qua tiện ích mở rộng Codex IDE.
codex mcp listcodexList the Notiondesk help centers I can access.Show the sync status for my main help center.Review the last 30 days of article feedback and analytics. Show me which documentation needs attention first.Review recent chatbot conversations and identify repeated customer questions that are not covered well by our documentation.Trigger a sync for the onboarding collection.codex mcp add notiondesk --url https://mcp.notiondesk.so/mcpNếu tiện ích mở rộng đã được mở sẵn khi bạn thêm máy chủ, hãy tải lại tiện ích mở rộng nếu Notiondesk không xuất hiện.
Mỗi kết nối Notiondesk đã được xác thực sẽ tiếp tục tuân theo quyền truy cập không gian làm việc của bạn.
Cấu hình thủ công Notiondesk
Codex lưu trữ cấu hình MCP của nó tại:
Bạn có thể cấu hình Notiondesk theo cách thủ công bằng lệnh:
Sau khi lưu cấu hình, hãy xác thực bằng:
Việc sử dụng codex mcp add thường đơn giản hơn so với việc chỉnh sửa cấu hình thủ công.
Làm việc với nhiều trung tâm hỗ trợ
Một kết nối Codex có thể truy cập nhiều trung tâm trợ giúp Notiondesk.
Trung tâm hỗ trợ sẽ hoạt động khi:
~/.codex/config.toml[mcp_servers.notiondesk]
url = "https://mcp.notiondesk.so/mcp"codex mcp login notiondesk- 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 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 hỗ trợ, hãy chỉ định trung tâm nào mà Codex nên hợp tác:
Quyền hạn
Workspace MCP tuân theo các quyền của tài khoản Notiondesk được sử dụng trong quá trình ủy quyền OAuth.
Ví dụ:
Check the French translation status for the Developer Docs help center.- Người xem có thể truy cập thông tin 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 và 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 kết nối Notiondesk với Codex không cấp thêm quyền nào cho tài khoản của bạn.
Khắc phục sự cố
Notiondesk không xuất hiện trong Codex
Chạy:
Xác nhận rằng notiondesk xuất hiện.
Nếu vẫn không được, hãy thêm máy chủ lại:
codex mcp listcodex mcp add notiondesk --url https://mcp.notiondesk.so/mcp Notiondesk đã được cấu hình nhưng chưa được xác thực.
Chạy:
Việc thêm máy chủ MCP và hoàn tất xác thực OAuth là hai bước riêng biệt.
codex mcp login notiondesk Xác thực OAuth không được mở
Hãy xác nhận URL MCP của Workspace là:
Sau đó thử lại:
Không thêm /sse vào URL MCP của Workspace.
https://mcp.notiondesk.so/mcpcodex mcp login notiondesk 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 đó.
Codex không thể truy cập trung tâm trợ giúp nếu tài khoản Notiondesk được sử dụng trong quá trình xác thực OAuth không khả dụng.
Một số công cụ Notiondesk 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 Codex có thể đọc thông tin không gian làm việc nhưng không thể thực hiện thao tác, 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 .
Máy chủ xuất hiện trong codex mcp list nhưng không khả dụng trong phiên.
codex mcp list nhưng không khả dụng trong phiên.Khởi tạo một phiên Codex mới sau khi cấu hình máy chủ MCP.
Nếu bạn sử dụng tiện ích mở rộng IDE, hãy tải lại nó sau khi thay đổi cấu hình MCP.
Xóa Notiondesk MCP
Để ngắt kết nối khỏi Codex, hãy sử dụng các lệnh quản lý MCP có sẵn trong phiên bản Codex mà bạn đã cài đặt.
Bạn cũng có thể xóa mục notiondesk khỏi:
Việc ngắt kết nối Codex không vô hiệu hóa Workspace MCP trong Notiondesk và không ảnh hưởng đến các máy khách AI hoặc đồng đội khác.
~/.codex/config.toml