Xử lý sự cố MCP
Tìm bước tiếp theo khi gặp vấn đề kết nối.
Không thể kết nối ứng dụng khách được lưu trữ
Kiểm tra URL đã cấu hình là https://mcp.altifigence.com/cloud-mcp và ứng dụng khách hỗ trợ Streamable HTTP với OAuth. Làm theo hướng dẫn kết nối và trạng thái đánh giá hiện tại. Trang sức khỏe máy chủ và siêu dữ liệu OAuth không chứng minh ứng dụng khách cụ thể đã hoàn tất ủy quyền.
Kết quả | Bước tiếp theo |
|---|---|
HTTP 401 | Kết nối lại Altifigence Cloud nếu ủy quyền hết hạn hoặc bị thu hồi; hoàn tất lại luồng ủy quyền ứng dụng khách |
HTTP 403 | Kiểm tra tổ chức đã đồng ý, quyền dự án hiện tại và chính sách công cụ; kết nối lại với quyền cần thiết sau khi tổ chức bật công cụ |
Công cụ trống hoặc thiếu | Kiểm tra danh mục đã phát hành, phê duyệt tổ chức rõ ràng và sự đồng ý mới cho từng công cụ; làm mới token cũ không thêm công cụ |
Không đọc được không gian làm việc | Kiểm tra trạng thái và quyền không gian làm việc trong Cloud; thử lại khi đã sẵn sàng |
Thiếu công cụ thực thi | Yêu cầu sự đồng ý mới cho |
Thiếu công cụ ghi | Yêu cầu sự đồng ý mới cho |
Xung đột thay đổi tệp | Đọc lại manifest và tệp, xem thay đổi đồng thời rồi gửi thay đổi dự định với phiên bản hiện tại |
Chưa xác nhận tạo dự án hoặc thay đổi Git | Kiểm tra danh sách dự án, kho hoặc trạng thái remote trước khi thử lại; tạo, commit hoặc push lặp lại có thể gây tác động ngoài ý muốn |
Xóa dự án đã được chấp nhận | Theo dõi trạng thái dự án/không gian làm việc tới khi dọn dẹp xong; được chấp nhận không có nghĩa hoàn tất |
Chuyển dữ liệu nhà cung cấp Git bị từ chối | Kiểm tra kho, nhánh đã chọn và kết nối nhà cung cấp hiện tại; công cụ không thể vượt qua quyền nhà cung cấp |
Chưa xác nhận thao tác runtime | Đọc trạng thái runtime và giữ ID thao tác; tiếp tục dùng ID thao tác của runtime đã dừng |
Thế hệ dự án, phiên bản tệp hoặc chính sách đã đổi | Lấy ước tính mới và xem đề nghị được chọn cùng chính sách sử dụng của nó |
Chưa xác nhận gửi tác vụ | Kiểm tra cùng ID tác vụ; chỉ thử lại với đối số giống hệt và cùng ID đó |
Kết quả chưa sẵn sàng | Đọc trạng thái tác vụ trước khi yêu cầu kết quả lần nữa |
Không đủ tín dụng | Xem trạng thái thanh toán của tổ chức trong Cloud |
HTTP 413 | Giảm yêu cầu theo các đối số trong schema công cụ đã khám phá |
HTTP 501 từ công cụ cục bộ | Runtime đã cài không triển khai thao tác này; chỉ khám phá công cụ không chứng minh có hỗ trợ |
HTTP 503 | Đợi dịch vụ phục hồi; giữ điểm cuối đã cấu hình |
Yêu cầu đọc không bắt đầu hay khởi động lại dự án. Tên công cụ không biết hoặc chưa được cho phép không bật chỉnh sửa hay thực thi. Sửa điều kiện kết nối hoặc quyền truy cập trước khi thử lại; không cung cấp thông tin xác thực thay thế trong đối số.
Quá nhiều yêu cầu
Nếu phản hồi gồm HTTP 429, đợi khoảng thời gian Retry-After chỉ định trước khi thử lại. Tránh lặp lại đăng ký hay đăng nhập.
Liên hệ hỗ trợ
Liên hệ Hỗ trợ Altifigence kèm tên ứng dụng khách, phiên bản, thời điểm xảy ra và thông điệp lỗi sau khi loại bỏ thông tin nhạy cảm. Không đưa thông tin xác thực, cookie hay nội dung dự án vào.
Khôi phục mà không lặp công việc
Điểm thất bại | Kiểm tra trước khi thử lại |
|---|---|
Danh tính hoặc khám phá | Phiên bản ứng dụng khách, điểm cuối, đăng nhập/phiên và danh sách công cụ đã đồng ý. |
Tiếp tục đọc tệp | Phiên bản tệp và manifest; bắt đầu lại khi bản chụp thay đổi. |
Ghi tệp, commit hoặc push | Tệp đã lưu hiện tại, kho và trạng thái remote. |
Gửi tác vụ | ID tác vụ hiện có và trạng thái; giữ danh tính ban đầu. |
Đầu vào terminal hoặc yêu cầu AI | Phiên/đầu ra hiện tại; không tự động phát lại đầu vào. |
Ghi yêu cầu tái hiện nhỏ nhất với giá trị thay thế cho dữ liệu dự án. Giữ mã lỗi, trạng thái HTTP, mã yêu cầu nếu hiển thị và dấu thời gian. Loại bỏ token và nội dung mã nguồn trước khi chia sẻ chẩn đoán.