Khắc phục sự cố và tham khảo

Không nhập hoặc xử lý được tài liệu

Đọc lỗi theo đúng bước: chọn file, đọc nội dung, trích hồ sơ hay lưu kết quả. Kiểm tra file có mở được, có mật khẩu, quá dung lượng hoặc vượt số trang không. URL cần truy cập được từ bên ngoài, không chỉ từ trình duyệt đã đăng nhập của bạn.

Thử lại với một file nhỏ có nội dung đại diện. Nếu file đó chạy được, tách tài liệu lớn theo chương hoặc xuất bản có lớp chữ. Nếu lỗi liên quan phiên đăng nhập, đăng nhập lại rồi kiểm tra trạng thái tác vụ trước khi gửi lại.

Một lượt đang xử lý chưa phải là một lượt thất bại. Không gửi lặp cả bộ tài liệu khi chưa biết kết quả; tác vụ AI có thể dùng credit và tạo dữ liệu cần đối chiếu.

Hồ sơ thiếu dữ liệu hoặc AI trả lời sai

Trước tiên kiểm tra đúng thương hiệu đang được dùng. Sau đó mở trường hồ sơ và nguồn mà câu trả lời tham chiếu.

• Không có dữ liệu: bổ sung nguồn thật hoặc trả lời phần phỏng vấn còn thiếu.
• Có dữ liệu nhưng sai: xác định lỗi đọc, lỗi trích hay thông tin đã cũ; sửa nguồn/hồ sơ theo đúng quyền.
• Dẫn chứng không hỗ trợ kết luận: yêu cầu trích nguyên văn và chỉ rõ đoạn nào hỗ trợ. Không chấp nhận một mã dẫn chứng chỉ vì nó có hình thức giống nguồn.
• Dùng kết quả cũ: yêu cầu AI đọc lại hồ sơ; mở phiên mới nếu công cụ vẫn giữ ngữ cảnh của thương hiệu khác.

Ghi lại câu hỏi, đoạn trả lời sai, nguồn mong đợi và thời điểm xảy ra. Những dữ liệu này hữu ích hơn một ảnh chụp ghi “AI không đúng”.

Không kết nối được hoặc hết quyền truy cập

Kiểm tra URL chính xác là https://mcp.antiem.io/mcp, loại server HTTP từ xa và đăng nhập OAuth. Không dùng URL của trang tài liệu làm URL server.

Nếu không thấy công cụ, bật Antiem trong cuộc trò chuyện hoặc mở phiên mới. Nếu thấy công cụ nhưng không thấy thương hiệu, kiểm tra tài khoản đăng nhập và lời mời. Nếu báo không đủ quyền khi ghi, quyền đọc không đủ; cần cả quyền mcp:write và vai trò chủ thương hiệu hoặc quản trị viên trong thương hiệu đó.

Khi kết nối bị thu hồi hoặc hết phiên, xác thực lại từ công cụ AI. Khi chạm hạn mức lượt gọi, dừng thử lặp và xem thông báo về hạn mức. Nếu không thấy mục tạo connector, kiểm tra quyền của workspace hoặc dùng một client được hướng dẫn trong Quick install.

Câu hỏi thường gặp

Tôi có phải biết kỹ thuật không?

Không để dùng hồ sơ, nhập tài liệu và Brand Agent trên web. Các lệnh CLI chỉ dành cho người đã dùng công cụ đó; bạn có thể kết nối bằng giao diện trong Claude hoặc Cursor.

Có thể dùng ngay mà không có tài khoản không?

Bạn đọc được tài liệu này mà không đăng nhập. Đọc dữ liệu thương hiệu qua app hoặc MCP cần tài khoản và quyền truy cập; chưa có quyền beta thì đăng ký waitlist.

MCP có tạo thương hiệu hoặc tự xuất bản bài không?

MCP hiện không tạo thương hiệu mới. Tạo thương hiệu ở web app. Antiem cũng không cung cấp luồng tự đăng bài lên mạng xã hội trong các hướng dẫn này.

Hỏi “chỉ đọc” có đảm bảo AI không ghi gì không?

Prompt mô tả ý định; giới hạn quyền thực tế do server và token quyết định. Màn hình đăng nhập hiện những gì công cụ yêu cầu và bạn chỉ có thể cho phép hoặc từ chối cả gói, nên công cụ xin mcp:write vẫn ghi được dù prompt nói gì. Ngay cả khi đó, thay đổi vẫn cần một bước xác nhận và vai trò chủ thương hiệu hoặc quản trị viên. Bạn có thể cắt một kết nối bất cứ lúc nào trong Kết nối MCP.

Thuật ngữ

• Hồ sơ thương hiệu: thông tin có cấu trúc về bản sắc, khách hàng, giá trị và biểu hiện.
• Nguồn/dẫn chứng: nội dung hỗ trợ một thông tin hoặc kết luận, có thể đối chiếu với tài liệu.
• Ranh giới: những điều thương hiệu xác định không làm hoặc không trở thành.
• Đề xuất: thay đổi chờ xem xét; chưa đồng nghĩa với giá trị đang có hiệu lực.
• MCP: giao thức cho AI gọi công cụ và đọc dữ liệu của dịch vụ được kết nối.
• OAuth: luồng đăng nhập và cấp quyền, giúp kết nối mà không đưa mật khẩu cho AI.
• Scope: phạm vi quyền trên kết nối, chẳng hạn đọc hoặc ghi.
• Credit: hạn mức dùng cho các tác vụ cần xử lý AI; khác với số lượt gọi MCP.

Danh mục công cụ MCP

AI nên bắt đầu bằng antiem_get_brands, chọn thương hiệu rồi gọi antiem_get_brand trước khi làm việc. Tên thương hiệu trong prompt cần được đối chiếu với danh sách được phép truy cập.

Dùng antiem_get_brand_docs để tìm hoặc đọc nguồn, antiem_get_brand_fields để xem trường hồ sơ và antiem_get_brand_gaps để xem phần còn thiếu. Các công cụ kiểm tra như antiem_check_brand_content và antiem_check_brand_health hỗ trợ đối chiếu nội dung và hồ sơ, không thay việc người đọc lại kết quả.

Công cụ nạp tài liệu hoặc cập nhật dữ liệu cần quyền ghi và quy trình tương ứng. Một thao tác tạo đề xuất không có cùng tác động với thao tác duyệt đề xuất. Bảng dưới đây liệt kê công cụ và quyền đang có ngay lúc này; bảng được tạo từ registry của ứng dụng.

Có gì mới và liên hệ hỗ trợ

Bộ hướng dẫn này được đối chiếu với phiên bản mã nguồn ngày 12/10/2026. Các công cụ MCP đã được đổi tên và gom theo công việc; nếu client vẫn lưu tên cũ, làm mới danh sách công cụ hoặc kết nối lại thay vì yêu cầu AI gọi một công cụ không còn có.

Khi cần hỗ trợ trong beta, dùng kênh liên hệ đã được cung cấp trong lời mời hoặc email trao đổi với đội Antiem. Nếu chưa có quyền truy cập, bắt đầu từ waitlist.

Gửi tên client và phiên bản, thời điểm xảy ra lỗi, tên thao tác, thông báo lỗi và bước tái hiện. Che dữ liệu nhạy cảm trong ảnh. Không gửi token, mật khẩu hay toàn bộ tài liệu khách hàng khi chỉ cần một đoạn để giải thích lỗi.