Model Context Protocol Remote Server v2.0

Tài Liệu Kết Nối MCP Server Cổ Chân Nhân

Hệ thống **Model Context Protocol (MCP)** cung cấp giao thức kết nối thời gian thực qua chuẩn **Server-Sent Events (SSE)**, giúp các công cụ AI (như **Cursor IDE, Claude Desktop, Antigravity AI, VS Code**) tự động tra cứu ngữ nghĩa và đồ thị tri thức nguyên tác Cổ Chân Nhân.

Vector Database

30,214

Trích đoạn Qwen3 8B 4096-dim

Knowledge Graph

6,800+

Thực thể Neo4j APOC

SSE Endpoint

/api/v1/mcp/sse

Real-time Stream Response

Danh Sách 3 MCP Tools Khả Dụng

Chuẩn JSON-RPC 2.0 Schema

search_knowledgeVector RAG

Tìm kiếm ngữ nghĩa chuyên sâu trong kho 30,214 trích đoạn truyện Cổ Chân Nhân. Tự động Rerank ưu tiên các chương quan trọng.

Tham số truyền vào (Input Parameters):

{
  "query": "Phương Nguyên Xuân Thu Thiền", // (str, bắt buộc) Câu hỏi hoặc từ khóa
  "top_k": 5                            // (int, tùy chọn) Số đoạn trích cần lấy
}

get_entity_graphNeo4j Graph

Tra cứu mạng lưới Đồ thị Tri thức Neo4j về Nhân vật, Võ học, Cổ trùng, Địa danh và Thế lực nguyên tác.

Tham số truyền vào (Input Parameters):

{
  "entity_name": "Phương Nguyên" // (str, bắt buộc) Tên nhân vật hoặc cổ trùng
}

get_chapterFull Content

Tải trực tiếp trọn bộ nội dung văn bản chi tiết của bất kỳ chương truyện nào theo số chương.

Tham số truyền vào (Input Parameters):

{
  "chapter_num": 1 // (int, bắt buộc) Số thứ tự chương cần xem
}

Hướng Dẫn Cấu Hình IDE / Agent AI

Chọn nền tảng của bạn bên dưới

Cấu hình mẫu (mcp_config.json):

{
  "mcpServers": {
    "cochannhan-ai": {
      "url": "https://ccn.andyanh.id.vn/api/v1/mcp/sse?api_key=ccn_mcp_your_api_key_here"
    }
  }
}

Vì sao nhiều người dùng khi dán Header Authorization bị lỗi 401?

Một số ứng dụng MCP Client (như Claude Desktop, Codex hoặc một số bản EventSource cũ) **không tự động gửi HTTP Headers** khi mở kết nối SSE stream ban đầu. Do đó, dán Key trực tiếp vào đường dẫn URL dưới dạng tham số ?api_key=YOUR_KEY giúp **100% ứng dụng kết nối thành công 0ms** mà không bao giờ bị báo lỗi 401!

Các bước thực hiện cho UNIVERSAL:

Copy đoạn JSON cấu hình ở trên chứa tham số ?api_key=<YOUR_API_KEY>.
Dán vào file cấu hình MCP của bất kỳ phần mềm AI nào (Cursor, Windsurf, Antigravity, VS Code, Claude Code).
Khởi động lại phần mềm để kích hoạt toàn bộ 3 MCP Tools ngay lập tức!

Lưu Ý & Quy Tắc Sử Dụng MCP Lành Mạnh

Bắt Buộc Tuân Thủ

Cam Kết Sử Dụng Dịch Vụ Văn Minh & Lành Mạnh

Để đảm bảo hệ thống máy chủ vận hành ổn định và phục vụ cộng đồng yêu thích Cổ Chân Nhân, người dùng MCP Server cần tuân thủ nghiêm ngặt các quy tắc dưới đây:

1. Mục Đích Học Thuật & Nghiên Cứu Lành Mạnh

MCP API Key được cấp nhằm hỗ trợ nghiên cứu AI, phát triển trợ lý ảo, tích hợp IDE và sáng tác văn học lành mạnh. Không sử dụng cho các mục đích vi phạm pháp luật.

2. Nghiêm Cấm Tấn Công / Cào Dữ Liệu Đại Trà

Nghiêm cấm hành vi gửi request dồn dập (DDoS), lợi dụng API để cào tự động 100% dữ liệu đại trà hoặc cố tình làm quá tải tài nguyên máy chủ.

3. Bảo Mật API Key Cá Nhân

Không chia sẻ công khai mã ccn_mcp_... lên các trang mạng xã hội hoặc repository GitHub công khai. Mỗi Key được gắn liền với tài khoản của bạn.

4. Quyền Kiểm Soát & Thu Hồi

Ban quản trị (Admin) có toàn quyền vô hiệu hóa hoặc thu hồi API Key bất kỳ lúc nào nếu hệ thống phát hiện hành vi bất thường hoặc vi phạm chính sách sử dụng.

Câu Hỏi Thường Gặp (FAQ)

Thời gian phê duyệt đơn đăng ký MCP bao lâu?

Thông thường Admin sẽ duyệt đơn trong vòng vài phút đến tối đa 24h. Sau khi được duyệt, bạn bấm vào nút “Đăng Ký & Quản Lý API Key” để nhận mã Key.

Tôi có thể sử dụng MCP Key trên nhiều máy tính không?

Có, bạn có thể dán chung 1 mã MCP Key vào cả Cursor trên máy tính làm việc lẫn Claude Desktop trên laptop cá nhân.