Kết nối không gian làm việc Notiondesk MCP với VS Code

Kết nối Workspace MCP Notiondesk với Visual Studio Code để truy cập workspace Notiondesk của bạn từ các công cụ AI của VS Code.

Bạn có thể cài đặt kết nối trực tiếp từ Notiondesk hoặc cấu hình máy chủ MCP từ xa theo cách thủ công.

Workspace MCP sử dụng OAuth và tuân theo quyền hạn của đồng đội Notiondesk người đã ủy quyền kết nối.

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.

• Bạn đang sử dụng phiên bản VS Code có hỗ trợ MCP.

Nếu Workspace MCP chưa được bật, hãy xem phần Bật Workspace MCP trong Notiondesk .

Kết nối Notiondesk từ bảng điều khiển

Cách thiết lập đơn giản nhất bắt đầu từ Notiondesk.

1. Mở bảng điều khiển Notiondesk của bạn

2. Hãy chọn trung tâm trợ giúp nơi Workspace MCP được bật.

3. Vào Cài đặt → Chung

4. Tìm phần Workspace MCP

5. Mở trình cài đặt trong ứng dụng của bạn.

6. Chọn VS Code

7. Nhấp vào Thêm vào VS Code

VS Code mở thông tin chi tiết máy chủ MCP Notiondesk.

1. Kiểm tra lại tên máy chủ và URL.

2. Nhấp vào Cài đặt

3. Khởi động máy chủ nếu VS Code yêu cầu bạn.

4. Hoàn tất quá trình xác thực OAuth Notiondesk trong trình duyệt của bạn.

Sau khi quá trình xác thực hoàn tất, các công cụ Notiondesk sẽ khả dụng trong VS Code.

Cấu hình thủ công MCP cho Notiondesk

Bạn cũng có thể cấu hình Workspace MCP bằng tệp mcp.json của VS Code.

Để thiết lập kết nối dành riêng cho dự án, hãy tạo hoặc mở:

Thêm vào:

Lưu tập tin.

VS Code sẽ tự động phát hiện máy chủ MCP mới.

Đảm bảo Notiondesk có sẵn trên tất cả các dự án.

Nếu bạn thường xuyên sử dụng Notiondesk trong nhiều dự án khác nhau, bạn có thể thêm máy chủ vào hồ sơ người dùng VS Code của mình thay vì chỉ một không gian làm việc duy nhất.

Mở bảng lệnh và chạy:

Thêm máy chủ HTTP từ xa:

Hãy chọn hồ sơ người dùng của bạn làm mục tiêu cấu hình.

Máy chủ MCP cấp người dùng có sẵn trên tất cả các không gian làm việc VS Code của bạn.

Khởi động máy chủ MCP Notiondesk

Mở bảng lệnh và chạy:

Chọn notiondesk .

Từ đó, bạn có thể khởi động, dừng, khởi động lại hoặc kiểm tra máy chủ.

Khi thiết lập kết nối lần đầu tiên, VS Code có thể yêu cầu bạn xác nhận rằng bạn tin tưởng máy chủ MCP.

Xem lại cấu hình và phê duyệt để tiếp tục.

Xác thực bằng Notiondesk

Khi VS Code kết nối với Notiondesk Workspace MCP, nó sẽ bắt đầu quy trình ủy quyền OAuth.

.vscode/mcp.json

{
  "servers": {
    "notiondesk": {
      "type": "http",
      "url": "https://mcp.notiondesk.so/mcp"
    }
  }
}

MCP: Add Server

https://mcp.notiondesk.so/mcp

MCP: List Servers

Notiondesk sẽ mở trong trình duyệt của bạn.

Sau đó:

1. Đăng nhập vào Notiondesk nếu cần.

2. Hãy xác nhận rằng không gian làm việc chính xác đã được hiển thị.

3. Xem xét lại các quyền được yêu cầu

4. Phê duyệt kết nối

5. Quay lại VS Code

Xác minh kết nối

Hãy bắt đầu với yêu cầu chỉ đọc trong VS Code:

Xác nhận rằng các trung tâm hỗ trợ dự kiến ​​đã được khôi phục.

Sau đó hãy thử:

Bạn cũng có thể hỏi:

Hoặc:

Hãy bắt đầu bằng các yêu cầu chỉ đọc trước khi yêu cầu VS Code thực hiện thay đổi.

Sử dụng Workspace MCP từ VS Code

Sau khi kết nối, VS Code có thể sử dụng các công cụ có sẵn khi chúng phù hợp với yêu cầu của bạn.

Ví dụ:

Nếu vai trò Notiondesk của bạn cho phép các hành động được hỗ trợ, bạn cũng có thể hỏi:

Các công cụ có sẵn 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.

Làm việc với nhiều trung tâm hỗ trợ

Cùng một kết nối VS Code có thể truy cập nhiều trung tâm trợ giúp Notiondesk khác nhau.

Trung tâm hỗ trợ sẽ hoạt động khi:

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 recent chatbot conversations and identify repeated customer questions.

Review article feedback and help center analytics from the last 30 days. Show me which articles need attention first.

Trigger a sync for the onboarding collection.

• 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 đó.

Bạn không cần cấu hình MCP riêng cho mỗi trung tâm trợ giúp.

Khi làm việc với nhiều trung tâm hỗ trợ, hãy chỉ rõ bạn đang muốn liên hệ với trung tâm nào:

Cấu hình không gian làm việc so với cấu hình người dùng

Sử dụng cấu hình không gian làm việc khi Notiondesk MCP chỉ nên được cấu hình cho một dự án duy nhất:

Hãy sử dụng cấu hình người dùng khi bạn muốn Notiondesk MCP khả dụng trong tất cả các không gian làm việc VS Code của mình.

Nếu cấu hình không gian làm việc được đưa vào hệ thống kiểm soát phiên bản, các thành viên khác trong nhóm có thể nhận được cùng một định nghĩa máy chủ MCP, nhưng mỗi thành viên vẫn phải xác thực bằng tài khoản Notiondesk của riêng họ.

Không nên chia sẻ thông tin đăng nhập OAuth giữa các thành viên trong nhóm.

Khắc phục sự cố

Check the translation status for the Developer Docs help center.

.vscode/mcp.json

MCP: List Servers

{
  "servers": {
    "notiondesk": {
      "type": "http",
      "url": "https://mcp.notiondesk.so/mcp"
    }
  }
}

MCP: List Servers

https://mcp.notiondesk.so/mcp

Ngắt kết nối Notiondesk khỏi VS Code

Bạn có thể vô hiệu hóa hoặc xóa máy chủ MCP Notiondesk khỏi VS Code khi không còn muốn sử dụng nó nữa.

Chạy:

Chọn máy chủ Notiondesk và vô hiệu hóa hoặc xóa nó.

Nếu bạn đã cấu hình thủ công, bạn cũng có thể xóa mục notiondesk khỏi mcp.json của mình.

Việc ngắt kết nối khỏi VS Code 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.

MCP: List Servers