Kết nối Claude và trợ lý AI

Coherently hỗ trợ MCP (Model Context Protocol) — chuẩn chung để trợ lý AI như Claude đọc và làm việc với dữ liệu của bạn. Kết nối xong, bạn có thể nhắn "liệt kê bài chưa chấm của lớp IELTS 6.5" hay "tạo bộ từ vựng 20 từ về môi trường cho lớp tối thứ 3" thay vì tự bấm từng màn hình.

Đường link kết nối

https://api.onemoretest.vn/mcp

Giáo viên và học viên dùng cùng một link. Sau khi đăng nhập, hệ thống tự chọn bộ chức năng theo tài khoản của bạn.

Cách 1 — Claude (claude.ai hoặc app Claude): đăng nhập Google

1. Mở Settings → Connectors → Add custom connector
2. Đặt tên (vd Coherently) và dán đường link ở trên
3. Bấm Connect → chọn tài khoản Google bạn dùng để đăng nhập Coherently
4. Quay lại Claude: connector báo đã kết nối, danh sách chức năng hiện ra

Xong. Mở cuộc trò chuyện mới và nhắn thử: "Liệt kê các lớp của tôi".

Nếu bạn không đăng nhập Coherently bằng Google, dùng Cách 2.

Cách 2 — Claude Code, Cursor và trợ lý khác: mã truy cập

1. Đăng nhập Coherently → Cài đặt → Access Tokens
2. Đặt tên cho mã, chọn Read-Write (hoặc Read only nếu chỉ muốn cho xem) → Generate token
3. Sao chép mã ngay — mã chỉ hiện một lần. Mã có hạn tối đa 90 ngày; hết hạn thì tạo mã mới.

Claude Code — chạy trong terminal:

claude mcp add --transport http coherently https://api.onemoretest.vn/mcp --header "Authorization: Bearer <mã-của-bạn>"

Cursor — thêm vào file cấu hình MCP (.cursor/mcp.json):

{
  "mcpServers": {
    "coherently": {
      "url": "https://api.onemoretest.vn/mcp",
      "headers": { "Authorization": "Bearer <mã-của-bạn>" }
    }
  }
}

Trợ lý nào hỗ trợ MCP qua HTTP đều dùng được cùng cách: đường link ở trên + mã truy cập trong header Authorization.

Bạn sẽ thấy những chức năng nào

Học viên không thấy chức năng của giáo viên và ngược lại. Trợ lý chỉ đọc được đúng dữ liệu tài khoản của bạn được xem trên website — không hơn.

Chế độ chỉ xem

Muốn trợ lý chỉ đọc, không được thay đổi gì? Dùng mã truy cập loại Read only (Cách 2).

• Trợ lý chỉ thấy các chức năng xem (giáo viên: 16 chức năng)
• Nếu trợ lý cố làm thay đổi dữ liệu, nó nhận thông báo rằng kết nối chỉ được xem — dữ liệu không bị đụng tới
• Kiểm tra đề hợp lệ và Chấm thử đáp án vẫn dùng được, vì hai chức năng này không lưu gì

An toàn khi dùng

• Claude hỏi trước khi thay đổi dữ liệu — mỗi chức năng tạo, sửa, xoá, gửi đều được đánh dấu để Claude xin xác nhận. Bạn có thể đặt từng chức năng là luôn cho phép, hỏi mỗi lần hoặc chặn trong trang connector.
• Thu hồi bất cứ lúc nào — gỡ connector trong Claude, hoặc bấm Revoke trên mã trong Cài đặt → Access Tokens. Mã bị thu hồi ngừng hoạt động trong vòng một phút.
• Tài khoản bị khoá thì kết nối cũng bị khoá — không cần làm gì thêm.

Vài câu để bắt đầu

Giáo viên

• "Tuần này lớp IELTS 6.5 còn bao nhiêu bài Writing chưa chấm? Liệt kê theo hạn nộp."
• "Mở bài của Minh Anh, tóm tắt 3 lỗi lớn nhất theo tiêu chí chấm."
• "Tạo bộ 20 từ vựng chủ đề môi trường, rồi giao cho lớp tối thứ 3."

Học viên

• "Hôm nay mình còn bài tập nào đến hạn?"
• "Cho mình xem nhận xét bài Writing gần nhất, lỗi nào lặp lại nhiều nhất?"
• "Ôn giúp mình các từ vựng đến hạn hôm nay."

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

Claude báo "Couldn't register with sign-in service"? Mỗi phút hệ thống chỉ nhận vài lượt đăng ký kết nối mới. Chờ khoảng một phút rồi bấm Connect lại.

Trợ lý chỉ thấy chức năng xem, dù tôi muốn giao bài? Bạn đang dùng mã Read only. Tạo mã Read-Write và kết nối lại.

Danh sách chức năng trong Claude chưa cập nhật? Claude lưu tạm danh sách chức năng. Ngắt kết nối rồi kết nối lại connector để tải bản mới — các lựa chọn luôn cho phép / hỏi / chặn bạn đã đặt vẫn được giữ.

Trợ lý có dùng dữ liệu của tôi để huấn luyện AI không? Coherently không huấn luyện model trên dữ liệu của bạn. Dữ liệu trợ lý đọc qua kết nối tuân theo chính sách của nhà cung cấp trợ lý bạn chọn (vd Anthropic với Claude).