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 cloud.execute và kiểm tra bản phát hành, chính sách tổ chức cùng quyền runtime dự án

Thiếu công cụ ghi

Yêu cầu sự đồng ý mới cho cloud.write và kiểm tra quyền công cụ rõ ràng cùng quyền dự án của tổ chức

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.