MCP 1.0 • OAuth 2.1 Ready • Enterprise Pilot

Thinking School AI Connector

Cổng kết nối Model Context Protocol (MCP) chính thức của Thinking School. Cho phép trợ lý AI (ChatGPT, Microsoft Copilot Studio, Claude) truy xuất an toàn kho tri thức bài giảng, làm quiz tương tác, và xây dựng lộ trình học tập cá nhân hoá theo từng gói thành viên.

🔌 Điểm kết nối (Gateway Endpoints)

Địa chỉ máy chủ MCP (hỗ trợ Streamable HTTP và Server-Sent Events):

https://mcp.thinkingschool.vn/api/mcp

OAuth 2.1 Standard Discovery (RFC 8414, RFC 9728, RFC 7591)

Hệ thống triển khai chuẩn xác thực OAuth 2.1 mới nhất, hỗ trợ Dynamic Client Registration và khám phá cấu hình tự động:

Thành phần	Giao thức / Chuẩn	URL Endpoint
Authorization Server Metadata	RFC 8414	`https://mcp.thinkingschool.vn/.well-known/oauth-authorization-server`
Protected Resource Metadata	RFC 9728	`https://mcp.thinkingschool.vn/.well-known/oauth-protected-resource`
Authorization Endpoint	OAuth 2.1 PKCE	`https://mcp.thinkingschool.vn/authorize`
Token Endpoint	RFC 6749 / RFC 7636	`https://mcp.thinkingschool.vn/oauth/token`
Dynamic Registration	RFC 7591	`https://mcp.thinkingschool.vn/oauth/register`

🚀 Hướng dẫn kết nối từng bước

🤖

ChatGPT (Custom Connector)

ChatGPT Plus / Team / Enterprise

1Vào Settings → Apps & Connectors → Bật Developer mode (nếu dùng tài khoản cá nhân) hoặc vào Workspace Settings (nếu là Admin tổ chức).
2Bấm Create Connector (hoặc Add Connector). Nhập tên Thinking School và dán URL MCP:
https://mcp.thinkingschool.vn/api/mcp
3Tại mục Authentication, chọn OAuth. ChatGPT sẽ tự động truy vấn Discovery và đăng ký Client qua RFC 7591.
4Bấm Connect → Hệ thống chuyển sang màn hình đăng nhập. Nhập email Thinking School để nhận mã xác thực OTP qua email.
5Xác nhận phê duyệt (Consent). ChatGPT sẵn sàng trả lời bài học và kích hoạt các Prompt Socratic.

💼

Microsoft Copilot Studio

Khách hàng Doanh nghiệp / Tổ chức

1Liên hệ Thinking School để tạo Static Client cho tổ chức của bạn (nhận Client ID & Client Secret bảo mật qua lệnh client:create).
2Mở Copilot Studio → Chọn Copilot của bạn → Actions / Tools → Add a tool → chọn Model Context Protocol.
3Điền Server URL:
https://mcp.thinkingschool.vn/api/mcp
4
Cấu hình OAuth 2.0:
- Auth URL: https://mcp.thinkingschool.vn/authorize
- Token URL: https://mcp.thinkingschool.vn/oauth/token
- Scope: tks.read
- Method: client_secret_post + PKCE S256
5Kiểm thử kết nối trong bảng Test panel và xuất bản Agent cho các phòng ban trong công ty.

🛠️ Danh sách 6 Công cụ MCP (Tools)

Tích hợp chuẩn JSON-RPC 2.0

search_knowledge

Tìm kiếm ngữ nghĩa hybrid (Gemini Embeddings + FTS) toàn bộ kho bài học, tình huống và ví dụ thực hành.

get_course_outline

Xem mục lục bài học chi tiết của một khoá học, kèm trạng thái hoàn thành và tiến độ thực tế của người học.

get_lesson

Đọc tóm tắt sư phạm hoặc toàn văn transcript từng trang bài học, kiểm soát quyền truy cập chặt chẽ theo gói.

list_my_learning

Liệt kê danh sách khoá học học viên đang tham gia, số bài đã hoàn thành và số ngày học liên tục (Streak).

build_learning_path

Xây dựng lộ trình học tập tối ưu theo mục tiêu công việc hoặc vai trò nghề nghiệp của cá nhân hoặc doanh nghiệp.

get_practice

Cung cấp câu hỏi trắc nghiệm kiến thức hoặc bài tập tình huống thực hành kèm đáp án và phân tích sư phạm.

🎓 3 Prompts Chuẩn Sư Phạm (Pedagogical Prompts)

Phương pháp giảng dạy Thinking School

1. tks_coach — Huấn luyện gợi mở (Socratic)arg: topic

Trợ lý đóng vai huấn luyện viên tư duy. Sử dụng phương pháp gợi mở từng câu hỏi một giúp học viên tự suy luận, đào sâu bản chất vấn đề và chỉ đưa ra gợi ý/nguồn trích dẫn khi học viên gặp khó khăn.

2. tks_apply — Áp dụng vào tình huống công việcarg: situation

Tìm kiếm 1–3 framework tư duy phù hợp nhất trong thư viện Thinking School để giải quyết bài toán thực tế của học viên, kèm kế hoạch hành động từng bước cụ thể.

3. tks_plan — Lập lộ trình học tậparg: goal

Phỏng vấn ngắn về vai trò và quỹ thời gian học tập, đối chiếu các khoá học người dùng đã học và xây dựng lộ trình theo từng tuần với liên kết bài học trực tiếp.