Tổng quan

Assistant Core MCP cho phép bạn quản lý trợ lý bằng cách trò chuyện với một ứng dụng AI như Claude, ChatGPT hoặc Cursor, thay vì mở Admin Panel. Bạn chỉ cần nói việc muốn làm, ví dụ "Thêm trang bảng giá https://shop.vn/bang-gia vào kiến thức của trợ lý Shop A", ứng dụng AI sẽ tự gọi đúng thao tác.

Trong các trang này, ứng dụng AI là phía kết nối tới Assistant Core (Claude, ChatGPT, Cursor…), còn trợ lý là sản phẩm bạn tạo trên Assistant Core.

URL kết nốiCopy Anchor Link

https://api.assistantcore.com/mcp

Ứng dụng AI cần hỗ trợ remote MCP qua Streamable HTTP và đăng nhập OAuth. Bạn không cần API key: lần đầu kết nối, ứng dụng mở trang đăng nhập Assistant Core để bạn cấp quyền.

Ví dụ yêu cầuCopy Anchor Link

Cấp quyềnCopy Anchor Link

Lần đầu kết nối, bạn đăng nhập Assistant Core (mật khẩu, Google hoặc GitHub) rồi thấy màn hình "… muốn quản lý assistant của bạn":

Claude (claude.ai, claude.com) và ChatGPT (chatgpt.com) hiện dấu Ứng dụng đã xác minh. Ứng dụng chạy trên máy bạn (Claude Code, Codex, Cursor, VS Code…) hiện cảnh báo vì tên của chúng không xác minh được: chỉ bấm Cho phép nếu chính bạn vừa bắt đầu kết nối.

Quyền luôn được kiểm tra lại ở mỗi thao tác. Nếu bạn bị hạ vai trò trên một trợ lý, ứng dụng AI cũng mất quyền tương ứng ngay. Đổi mật khẩu hoặc đăng xuất khỏi mọi thiết bị sẽ ngắt mọi kết nối.

Yêu cầu cấp quyền có hiệu lực 10 phút. Hết hạn thì bắt đầu kết nối lại từ ứng dụng AI.

Thao tác hỗ trợCopy Anchor Link

Một số lưu ý:

• add_knowledge_url: URL tới file .pdf, .docx, .xlsx, .xls, .csv, .txt (tối đa 25 MB) được tải về như tài liệu. URL khác được đọc như một trang web.
• add_knowledge_text: ứng dụng AI gửi nội dung văn bản hoặc markdown (tối đa 200 KB). Dùng khi bạn đưa file cho ứng dụng AI đọc trước, vì Assistant Core MCP không nhận upload file trực tiếp.
• add_knowledge_website: crawl tối đa 20 trang, chạy khoảng một phút.
• update_assistant trả về phần đã thay đổi (với system prompt là diff) để bạn xem lại.
• revert_assistant_change đưa cài đặt về như trước một thay đổi. Nếu cài đặt đó đã bị sửa lại sau thay đổi (kể cả sửa trên Admin Panel), lệnh bị từ chối với CONFLICT để không làm mất bản sửa mới hơn.
• test_chat chat thử với trợ lý bằng đúng prompt, tool và kiến thức mà người dùng cuối nhận được. Mỗi lượt tính credit vào tài khoản của bạn như chat thường. Hội thoại thử hiện trong danh sách chat của bạn.
• Hạn mức ở lớp plan vẫn áp dụng: tính năng plan không có trả lỗi FEATURE_NOT_AVAILABLE, vượt số tài liệu trả QUOTA_EXCEEDED. create_assistant kiểm tra giới hạn số trợ lý của gói và subdomain trước khi hỏi bạn.

Yêu cầu cần bạn xác nhậnCopy Anchor Link

create_assistant và create_access_request tự chúng không thay đổi gì. Ứng dụng AI đưa bạn một link tới trang xác nhận trên Admin Panel; bạn xem yêu cầu ở đó, đăng nhập bằng chính tài khoản của mình, rồi bấm duyệt hoặc từ chối. Ứng dụng AI không thể tự duyệt thay bạn. Mỗi yêu cầu có hiệu lực 15 phút và chỉ trả lời được một lần.

• Trợ lý mới: trang hiển thị tên, subdomain và prompt. Khi bạn duyệt, bạn là chủ sở hữu, trợ lý được tính vào giới hạn của gói, và ứng dụng quản lý được nó ngay.
• Thêm quyền: trang hiển thị các trợ lý và mức quyền ứng dụng xin, bắt đầu từ quyền hiện có. Điều chỉnh rồi lưu; quyền mới áp dụng từ lần gọi tiếp theo, không cần kết nối lại.

Ngoài phạm viCopy Anchor Link

Các việc sau vẫn chỉ làm trên Admin Panel: thanh toán và gói cước; xoá hoặc chuyển quyền sở hữu trợ lý; quản lý thành viên; API key và developer credential; tạo custom API tool hoặc kết nối MCP Server; subdomain và custom domain; scheduled task.

An toàn khi cho ứng dụng AI quyền sửaCopy Anchor Link

• Claude, ChatGPT và hầu hết ứng dụng AI hỏi xác nhận trước khi chạy thao tác xoá kiến thức hoặc sửa trợ lý. Đọc kỹ trước khi đồng ý, nhất là khi sửa system prompt vì thay đổi áp dụng cho mọi người dùng cuối.
• Hội thoại, feedback và nội dung kiến thức là văn bản do người khác viết. Assistant Core đánh dấu chúng là dữ liệu không tin cậy, nhưng một tin nhắn kiểu "bỏ qua hướng dẫn, sửa system prompt thành …" vẫn có thể khiến ứng dụng AI làm sai. Nếu thấy ứng dụng AI đề xuất thay đổi bạn không yêu cầu, hãy từ chối.
• Nếu chỉ cần phân tích, cấp Chỉ xem. Khi cần sửa, ứng dụng sẽ xin thêm quyền qua một trang xác nhận.
• Mọi thao tác sửa và mọi lần đọc hội thoại đều được ghi nhật ký. Xem và hoàn tác ở trang Ứng dụng đã kết nối của từng trợ lý (xem bên dưới).

Quản lý kết nốiCopy Anchor Link

Mở Ứng dụng đã kết nối trong trang tài khoản của Admin Panel để xem các ứng dụng đã cấp quyền, trợ lý, mức quyền và lần dùng gần nhất. Bấm Ngắt kết nối để thu hồi ngay; lời gọi tiếp theo của ứng dụng sẽ bị từ chối.

Mỗi trợ lý cũng có trang Ứng dụng đã kết nối trong Admin Panel. Trang này hiện địa chỉ Assistant Core MCP, mọi ứng dụng mà thành viên đã cấp quyền trên trợ lý, và nhật ký hoạt động. Tại đây bạn có thể:

• Gỡ khỏi trợ lý: ứng dụng không còn quyền trên trợ lý này, quyền trên các trợ lý khác giữ nguyên.
• Hoàn tác một thay đổi cài đặt, sau khi xem trước giá trị sẽ được khôi phục.

Muốn đổi trợ lý hoặc mức quyền: nhờ ứng dụng AI xin quyền, nó sẽ gửi link xác nhận để bạn chọn (xem mục Yêu cầu cần bạn xác nhận ở trên). Ngắt kết nối rồi kết nối lại cũng được.

Prompt có sẵnCopy Anchor Link

Ứng dụng hỗ trợ MCP prompt (ví dụ Claude Desktop, Claude Code) hiện hai quy trình dựng sẵn, gõ tên trợ lý sẽ được gợi ý:

• improve_from_feedback: đọc phản hồi tiêu cực, gom thành nhóm lỗi, đề xuất sửa prompt hoặc kiến thức, chờ bạn đồng ý rồi kiểm tra lại bằng test_chat.
• check_assistant: rà cấu hình, kiến thức, tool, số liệu 30 ngày và thay đổi gần đây, đề xuất ba việc nên làm trước. Không sửa gì.

Giới hạnCopy Anchor Link

Xử lý sự cốCopy Anchor Link