KnowSync AI

chính thức

Biến tài liệu rải rác của bạn thành kiến thức sẵn sàng cho AI, hoạt động liền mạch với Claude, Cursor, VS Code và các công cụ AI khác.

Xem trên knowsync.aiDùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với KnowSync AI MCP?

  • Tìm kiếm cơ sở tri thức — Yêu cầu AI của bạn tìm tài liệu và nội dung liên quan bằng knowsync_query với khả năng tự động nhận diện ý định và xếp hạng lại bằng AI.
  • Quản lý tài liệu — Sử dụng knowsync_manage để liệt kê, duyệt và lọc tài liệu theo trạng thái hoặc loại nội dung phục vụ kiểm toán cơ sở tri thức.
  • Thêm nội dung web — Yêu cầu AI của bạn thu thập các URL cụ thể hoặc khám phá các trang web liên quan để tự động thêm vào cơ sở tri thức qua knowsync_manage.
  • Hỏi đáp tiếp nối theo ngữ cảnh phiên — Đặt các câu hỏi tiếp nối có ngữ cảnh trong cùng một cuộc trò chuyện, với knowsync_query giữ nguyên ngữ cảnh để hỗ trợ các truy vấn đa lượt tự nhiên.

Tài liệu

Kết nối các tác nhân AI với cơ sở kiến thức KnowSync của bạn bằng Giao thức Ngữ cảnh Mô hình (MCP). Thiết lập khóa API, cấu hình công cụ và tích hợp với Claude, Cursor và các trợ lý AI khác.

15 phút đọcBởi KnowSync Team9/18/2025

Tích hợp MCP

Máy chủ Giao thức Ngữ cảnh Mô hình (MCP) của KnowSync cho phép các tác nhân AI truy cập cơ sở kiến thức của tổ chức bạn theo thời gian thực. Kết nối Claude, Cursor, VS Code và các công cụ AI khác để tìm kiếm, truy xuất và thêm nội dung vào cơ sở kiến thức của bạn một cách liền mạch.

MCP là gì?

Tổng quan

Giao thức Ngữ cảnh Mô hình (MCP) là một tiêu chuẩn mở do Anthropic phát triển, cho phép các ứng dụng AI truy cập an toàn vào các nguồn dữ liệu bên ngoài. Máy chủ MCP của KnowSync cung cấp 2 công cụ hợp nhất với bộ nhớ đệm thông minh, tối ưu hóa truy vấn bằng AI và quản lý phiên, cho phép các tác nhân AI tương tác với cơ sở kiến thức của bạn thông qua API JSON-RPC 2.0 chuẩn hóa.

Các tính năng chính

2 Công cụ hợp nhất:

  • Truy vấn phổ quát: Tìm kiếm và truy xuất nội dung thông minh với phát hiện ý định tự động, xếp hạng lại bằng AI, bộ nhớ đệm thông minh và bảo toàn ngữ cảnh theo phiên
  • Quản lý tài liệu: Quản lý nội dung toàn diện bao gồm thu thập web, khám phá và các thao tác tài liệu với theo dõi mức sử dụng

Bảo mật doanh nghiệp:

  • Xác thực khóa API với quyền chi tiết
  • Giới hạn tốc độ và theo dõi mức sử dụng
  • Ghi nhận thành viên nhóm cho mọi yêu cầu
  • Hạn chế IP và kiểm soát truy cập

Thiết lập khóa API MCP

Tạo khóa API đầu tiên của bạn

  1. Truy cập Bảng điều khiển MCP: Điều hướng đến bảng điều khiển tổ chức của bạn và nhấp vào thẻ Máy chủ MCP
  2. Đi tới tab Khóa API: Nhấp vào phần Khóa API
  3. Tạo khóa mới: Nhấp vào nút Tạo khóa API
  4. Cấu hình cài đặt khóa:
    • Tên: Tên mô tả (ví dụ: "Claude Desktop", "Kiểm thử phát triển")
      • Quyền: Chọn công cụ mà khóa có thể truy cập
      • Giới hạn tốc độ: Đặt số yêu cầu mỗi giờ (dựa trên gói của bạn)

Các công cụ MCP có sẵn

KnowSync cung cấp 2 công cụ MCP hợp nhất mạnh mẽ, kết hợp chức năng của hệ thống 5 công cụ trước đây:

Công cụ phổ quát (Tất cả các gói)

knowsync_query:

  • Tìm kiếm và truy xuất nội dung phổ quát với bộ nhớ đệm thông minh (phản hồi nhanh hơn 60-85%)
  • Phát hiện ý định tự động (tìm kiếm so với truy xuất) với mở rộng và tối ưu hóa truy vấn
  • Bảo toàn ngữ cảnh theo phiên cho các truy vấn tiếp theo với bộ nhớ hội thoại
  • Điều chỉnh tham số thông minh dựa trên phân loại truy vấn AI và chấm điểm độ tin cậy
  • Xếp hạng lại kết quả bằng AI để cải thiện mức độ liên quan (gói Pro+)
  • Bộ nhớ đệm tương tự nhúng cho các truy vấn lặp lại cực nhanh

Công cụ quản lý (Tất cả các gói)

knowsync_manage:

  • Các thao tác quản lý tài liệu toàn diện với theo dõi mức sử dụng
  • Liệt kê và duyệt tài liệu với bộ lọc nâng cao và giám sát trạng thái (0,5 đơn vị API)
  • Thêm các trang web cụ thể vào cơ sở kiến thức của bạn với xử lý vector đầy đủ (2 đơn vị API cho mỗi URL: 1 thu thập + 1 xử lý)
  • Nghiên cứu và khám phá nội dung web liên quan với xử lý tự động (2 đơn vị API cho mỗi URL được khám phá)
  • Giao diện hợp nhất cho tất cả các thao tác tài liệu với theo dõi tiêu thụ API chi tiết

Cấu hình quyền

Quyền cấp công cụ: Mỗi khóa API có thể được cấp quyền truy cập vào các công cụ cụ thể dựa trên nhu cầu của bạn:

  • Chỉ tìm kiếm: Lý tưởng cho các tác nhân AI chỉ đọc
  • Toàn quyền truy cập: Truy cập đầy đủ vào tất cả các công cụ có sẵn
  • Tùy chỉnh: Chọn các công cụ cụ thể cho các trường hợp sử dụng chuyên biệt

Giới hạn tốc độ: Cấu hình giới hạn yêu cầu dựa trên mô hình sử dụng:

  • Gói miễn phí: Tối đa 60 yêu cầu/giờ
  • Gói khởi đầu: Lên đến 600 yêu cầu/giờ
  • Gói chuyên nghiệp: Lên đến 3.000 yêu cầu/giờ
  • Gói doanh nghiệp: Giới hạn tùy chỉnh có sẵn

Tích hợp với các công cụ AI

Thiết lập Claude Desktop

Điều kiện tiên quyết:

  • Ứng dụng Claude Desktop (phiên bản mới nhất)
  • Khóa API KnowSync với quyền thích hợp
  • Nhận dạng người dùng để theo dõi nhóm

Cấu hình:

  1. Lấy URL máy chủ của bạn: https://www.knowsync.ai/api/mcp
  2. Thêm vào Cài đặt Claude Desktop:
{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Tích hợp Cursor IDE

Hướng dẫn thiết lập:

  1. Mở Cài đặt Cursor (Cmd/Ctrl + ,)
  2. Điều hướng đến phần MCP
  3. Thêm Máy chủ KnowSync:
{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Tích hợp VS Code

Sử dụng tiện ích mở rộng MCP:

  1. Cài đặt tiện ích mở rộng MCP cho VS Code
  2. Cấu hình trong settings.json:
{
  "mcp.servers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Thiết lập Claude Code

Điều kiện tiên quyết:

  • Claude Code CLI đã cài đặt (cài đặt qua npm install -g @anthropic-ai/claude-code hoặc làm theo hướng dẫn cài đặt chính thức)
  • Khóa API KnowSync với quyền thích hợp
  • ID người dùng/email KnowSync của bạn (tìm thấy trong cài đặt hồ sơ)

Cấu hình:

  1. Thêm Máy chủ MCP KnowSync bằng Claude CLI:
  • với ID người dùng:
claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-User-Id: your_user_id_here"
  • với Email người dùng:
claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-User-Email: your_user_email_here"
  1. Xác minh cấu hình:
claude mcp list

Thao tác này sẽ hiển thị máy chủ knowsync trong danh sách.

Lưu ý: Đảm bảo khóa API của bạn có quyền công cụ cần thiết. Thay thế các trình giữ chỗ bằng giá trị thực tế.

Theo dõi thành viên nhóm

Tiêu đề bắt buộc: Tất cả các yêu cầu MCP phải bao gồm nhận dạng người dùng để ghi nhận đúng:

  • X-User-Id: ID người dùng KnowSync của bạn (tìm thấy trong cài đặt hồ sơ)
  • X-User-Email: Địa chỉ email đã đăng ký của bạn

Tại sao cần thiết:

  • Theo dõi mức sử dụng của từng thành viên nhóm
  • Tạo phân tích và thông tin chi tiết theo người dùng
  • Đảm bảo dấu vết kiểm toán phù hợp
  • Cho phép thanh toán và giới hạn dựa trên mức sử dụng

Ví dụ sử dụng MCP trong thực tế

Tích hợp quy trình phát triển

Kịch bản 1: Trợ lý đánh giá mã

Trường hợp sử dụng: Tác nhân AI hỗ trợ trong quá trình đánh giá mã bằng cách truy cập các tiêu chuẩn mã hóa và phương pháp hay nhất của nhóm bạn.

# Query for coding standards
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What are our React component naming conventions and prop validation requirements?",
        "mode": "retrieve",
        "limit": 4
      }
    }
  }'

Tích hợp tác nhân AI: Cấu hình Claude Code để sử dụng tính năng này nhằm truy cập tức thì các tiêu chuẩn của nhóm bạn trong quá trình phát triển.

Kịch bản 2: Tiếp nhận thành viên nhóm mới

Trường hợp sử dụng: Tự động điền vào cơ sở kiến thức tài liệu khung mới nhất cho nhân viên mới.

# Discover and add latest documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "discover",
        "query": "Next.js 15 App Router migration guide 2024",
        "options": {
          "maxResults": 8,
          "maxUrls": 4,
          "relevanceThreshold": 0.8
        }
      }
    }
  }'

Phản hồi dự kiến với mức tiêu thụ API:

{
  "success": true,
  "documentsCreated": 4,
  "apiUnitsConsumed": 8,
  "message": "Successfully discovered and processed 4 documents into knowledge base (8 API units consumed)"
}

Lưu ý: 4 URL × 2 đơn vị mỗi URL (1 thu thập + 1 xử lý) = 8 đơn vị API tổng cộng

Nâng cao hỗ trợ khách hàng

Kịch bản 3: Truy cập tài liệu hỗ trợ tức thì

Trường hợp sử dụng: Nhân viên hỗ trợ nhận câu trả lời tức thì từ tài liệu sản phẩm trong khi hỗ trợ khách hàng.

# Search for troubleshooting information
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: support_agent_123" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "Customer getting 401 errors during payment processing, what are the common causes and solutions?",
        "mode": "auto",
        "limit": 6
      }
    }
  }'

Lợi ích: Thời gian phản hồi nhanh hơn 60-85% nhờ bộ nhớ đệm, xếp hạng mức độ liên quan nâng cao bằng AI hiển thị các giải pháp hữu ích nhất trước tiên.

Quy trình quản lý sản phẩm

Kịch bản 4: Nghiên cứu phân tích cạnh tranh

Trường hợp sử dụng: Quản lý sản phẩm nghiên cứu tính năng của đối thủ cạnh tranh và xu hướng ngành.

# Discover latest competitive analysis
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: product_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "discover",
        "query": "SaaS pricing strategy trends 2024 freemium models",
        "options": {
          "maxResults": 10,
          "maxUrls": 5,
          "relevanceThreshold": 0.7
        }
      }
    }
  }'

Kịch bản 5: Tra cứu yêu cầu tính năng

Trường hợp sử dụng: Nhanh chóng tìm các đặc tả và yêu cầu tính năng hiện có trong quá trình lập kế hoạch.

# Search existing requirements
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: product_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "user authentication flow requirements two-factor authentication implementation",
        "mode": "retrieve",
        "filters": {
          "contentTypes": ["documents"],
          "documentIds": ["spec_docs_collection"]
        }
      }
    }
  }'

Hỗ trợ bán hàng và tiếp thị

Kịch bản 6: Hỗ trợ bán hàng

Trường hợp sử dụng: Đội ngũ bán hàng truy cập thông tin sản phẩm và định vị cạnh tranh trong các cuộc gọi với khách hàng.

# Quick product feature lookup
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: sales_rep" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 6,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What security certifications do we have? SOC 2 compliance status enterprise security features",
        "mode": "search",
        "limit": 5
      }
    }
  }'

Bảo trì cơ sở kiến thức

Kịch bản 7: Phân tích khoảng trống nội dung

Trường hợp sử dụng: Xác định tài liệu nào đã tồn tại và tài liệu nào cần được tạo.

# Audit existing documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: content_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 7,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "list",
        "filters": {
          "limit": 50,
          "status": "ready",
          "contentType": "markdown"
        }
      }
    }
  }'

Kịch bản 8: Thêm tài liệu ngành

Trường hợp sử dụng: Giữ cho cơ sở kiến thức cập nhật với các tiêu chuẩn và khung ngành mới nhất.

# Add specific technical documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: tech_writer" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 8,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "crawl",
        "url": "https://nextjs.org/docs/app/building-your-application/authentication",
        "options": {
          "respectRobots": true,
          "timeout": 45,
          "followLinks": false
        }
      }
    }
  }'

Tại sao KnowSync MCP mang tính cách mạng

Sự khác biệt về sức mạnh

Các hệ thống tài liệu truyền thống khiến bạn phải tìm kiếm thông tin. KnowSync MCP khiến thông tin đến với bạn:

Trước KnowSync MCP:

  • Chuyển đổi giữa các công cụ để tìm kiếm tài liệu
  • Lặp lại các tìm kiếm cho các câu hỏi tương tự
  • Tự tay ghép nối thông tin từ nhiều nguồn
  • Chờ 2-5 giây cho mỗi lần tìm kiếm
  • Nhận kết quả có thể liên quan hoặc không

Với KnowSync MCP:

  • Các tác nhân AI tự động truy cập cơ sở kiến thức của bạn
  • Phản hồi nhanh hơn 60-85% thông qua bộ nhớ đệm thông minh
  • AI hiểu ngữ cảnh và cung cấp chính xác những gì bạn cần
  • Bộ nhớ phiên duy trì ngữ cảnh hội thoại
  • Kết quả được AI xếp hạng để đạt mức độ liên quan tối đa

Tác động thực tế đến quy trình làm việc của bạn

# Traditional approach: Manual search in documentation
# Time: 2-5 minutes per question
# Result: May not find the right answer

# KnowSync MCP approach: AI agent instantly knows
# Time: 2-5 seconds per question
# Result: Contextual, accurate, source-cited answers

Ví dụ: Một nhà phát triển hỏi "Chúng ta xử lý xác thực như thế nào?" không chỉ nhận được tài liệu xác thực, mà cụ thể là các phần liên quan đến ngữ cảnh dự án hiện tại của họ, kèm theo các gợi ý tiếp theo, trong vòng chưa đầy 2 giây.

Các mẫu tích hợp nâng cao

Hội thoại nhận biết phiên

AI ghi nhớ ngữ cảnh qua các truy vấn trong cùng một phiên, cho phép các câu hỏi tiếp theo tự nhiên:

# First query
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: developer_session_123" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "How do we handle user authentication in our React apps?"
      }
    }
  }'

# Follow-up query (AI maintains context)
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: developer_session_123" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What about logout and session management for that?"
      }
    }
  }'

Ví dụ tối ưu hóa hiệu suất

Chứng minh sức mạnh của bộ nhớ đệm thông minh:

# First time query (full processing)
time curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "deployment pipeline configuration Docker containerization"
      }
    }
  }'
# Response time: ~800ms

# Similar query (cached response)
time curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "how to configure deployment pipelines with Docker containers"
      }
    }
  }'
# Response time: ~120ms (85% faster!)

Chuyển đổi năng suất của nhóm bạn

Trước và sau KnowSync MCP

| Kịch bản | Phương pháp truyền thống | Với KnowSync MCP | Thời gian tiết kiệm | |----------|-------------------|-------------------|------------| | Đánh giá mã | Tìm kiếm tài liệu thủ công | Tác nhân AI trích dẫn ngay các tiêu chuẩn mã hóa | Nhanh hơn 90% | | Hỗ trợ khách hàng | Tra cứu hướng dẫn khắc phục sự cố | AI cung cấp các bước giải pháp chính xác | Nhanh hơn 85% | | Tiếp nhận | Gửi liên kết đến tài liệu | AI trả lời các câu hỏi cụ thể theo ngữ cảnh | Nhanh hơn 95% | | Lập kế hoạch sản phẩm | Nghiên cứu tính năng đối thủ thủ công | AI khám phá và phân tích xu hướng mới nhất | Nhanh hơn 80% |

Hiệu ứng cộng dồn

Tuần 1: Nhóm của bạn tiết kiệm 2-3 giờ mỗi ngày cho việc tìm kiếm tài liệu Tháng 1: Tiết kiệm 40-60 giờ cho mỗi thành viên nhóm Năm 1: Mỗi thành viên nhóm lấy lại được 2-3 tuần thời gian làm việc hiệu quả

Câu chuyện tác động thực tế từ người dùng

Đội ngũ phát triển: "Thay vì dành 30 phút tìm kiếm các mẫu API của chúng tôi, Claude Code ngay lập tức hiển thị chính xác những gì tôi cần. Tôi có thể tập trung vào việc xây dựng thay vì tìm kiếm."

Đội ngũ hỗ trợ: "Các câu hỏi của khách hàng trước đây mất 10 phút để nghiên cứu giờ được trả lời trong 30 giây. Chất lượng phản hồi của chúng tôi được cải thiện trong khi thời gian phản hồi giảm đáng kể."

Đội ngũ sản phẩm: "Nghiên cứu trước đây mất hàng giờ giờ chỉ mất vài phút. Chúng tôi có thể phân tích tính năng cạnh tranh, tìm yêu cầu và đưa ra quyết định nhanh hơn bao giờ hết."

Bắt đầu thật đơn giản

  1. Tạo khóa API (2 phút)
  2. Kết nối tác nhân AI của bạn (Claude, Cursor, VS Code)
  3. Bắt đầu đặt câu hỏi - chỉ vậy thôi!

Sức mạnh không nằm ở công nghệ - mà nằm ở cách nó chuyển đổi công việc hàng ngày của bạn từ tìm kiếm sang sáng tạo.

Phân tích mức sử dụng và giám sát

Tính năng bảng điều khiển MCP

Quản lý khóa API:

  • Tạo, chỉnh sửa và xóa khóa API
  • Giám sát thống kê mức sử dụng cho từng khóa
  • Cấu hình quyền và giới hạn tốc độ
  • Xem lịch sử và mẫu yêu cầu

Phân tích mức sử dụng:

  • Số liệu yêu cầu theo thời gian thực theo công cụ
  • Tỷ lệ thành công/lỗi và thời gian phản hồi
  • Ghi nhận theo người dùng và thông tin chi tiết nhóm
  • Xu hướng lịch sử và mẫu sử dụng

Cấu hình cài đặt:

  • Giới hạn thu thập web và cài đặt thời gian chờ
  • Danh sách cho phép/chặn miền cho khám phá web
  • Tùy chọn lọc loại nội dung
  • Giới hạn tốc độ và kiểm soát bảo mật

Theo dõi mức sử dụng nhóm

Phân tích cá nhân:

  • Theo dõi thành viên nhóm nào sử dụng công cụ MCP
  • Giám sát mẫu áp dụng trên toàn tổ chức
  • Xác định người dùng tích cực và nhu cầu đào tạo
  • Tạo báo cáo mức sử dụng cho quản lý

Ghi nhận yêu cầu: Tất cả các yêu cầu MCP đều yêu cầu tiêu đề nhận dạng người dùng:

  • X-User-Id: Ghi nhận trực tiếp theo ID người dùng
  • X-User-Email: Ghi nhận người dùng dựa trên email
  • Các yêu cầu không có tiêu đề người dùng sẽ bị từ chối
  • Dấu vết kiểm toán đầy đủ để tuân thủ

Bảo mật và kiểm soát truy cập

Hệ thống xác thực

Bảo mật khóa API:

  • Băm Bcrypt cho các khóa được lưu trữ
  • Khả năng xoay khóa tự động
  • Giới hạn tốc độ cho mỗi khóa để ngăn chặn lạm dụng
  • Giám sát theo thời gian thực cho hoạt động đáng ngờ

Mô hình quyền:

  • Quyền cấp công cụ (kiểm soát truy cập chi tiết)
  • Hạn chế truy cập dựa trên tổ chức
  • Khả năng sẵn có tính năng dựa trên gói
  • Kết hợp quyền tùy chỉnh

Bảo mật doanh nghiệp (Gói doanh nghiệp)

Tính năng nâng cao:

  • Hạn chế truy cập dựa trên IP
  • Tích hợp Đăng nhập một lần (SSO)
  • Nhật ký kiểm toán cho các yêu cầu tuân thủ
  • Chính sách và kiểm soát bảo mật tùy chỉnh

Bảo vệ dữ liệu:

  • Mã hóa TLS cho mọi giao tiếp
  • Lưu trữ an toàn khóa API và dữ liệu người dùng
  • Các tính năng tuân thủ GDPR và CCPA
  • Kiểm tra và cập nhật bảo mật định kỳ

Xử lý sự cố

Các vấn đề thường gặp

Sự cố kết nối:

  • Lỗi: Tác nhân AI không thể kết nối tới máy chủ MCP
  • Giải pháp:
    • Xác minh khóa API chính xác và chưa hết hạn
      • Xác nhận URL miền của bạn có thể truy cập (không phải localhost đối với công cụ từ xa)
      • Kiểm tra rằng các tiêu đề nhận dạng người dùng được bao gồm
      • Xem lại quyền của khóa API cho các công cụ cần thiết

Lỗi xác thực:

  • Lỗi: "Unauthorized" hoặc "User identification required"
  • Giải pháp:
    • Bao gồm tiêu đề X-User-Id hoặc X-User-Email trong mọi yêu cầu
      • Xác minh ID/email người dùng tồn tại trong tổ chức của bạn
      • Tạo lại khóa API nếu cần thiết
      • Kiểm tra khóa API có quyền công cụ phù hợp

Giới hạn tốc độ:

  • Lỗi: "Rate limit exceeded"
  • Giải pháp:
    • Xem lại mức sử dụng hiện tại trong bảng điều khiển MCP
      • Điều chỉnh giới hạn tốc độ cho khóa API của bạn
      • Cân nhắc nâng cấp gói của bạn để có giới hạn cao hơn
      • Triển khai kiểm soát tần suất yêu cầu trong ứng dụng của bạn

Lỗi quyền công cụ:

  • Lỗi: "Permission denied for tool X"
  • Giải pháp:
    • Chỉnh sửa quyền khóa API trong bảng điều khiển MCP
      • Đảm bảo gói của bạn bao gồm quyền truy cập vào các công cụ nâng cao
      • Liên hệ hỗ trợ để biết các giới hạn cụ thể của gói

Kiểm tra máy chủ MCP của bạn

Kiểm tra sức khỏe:

# Test server connectivity
curl https://www.knowsync.ai/api/mcp

# Expected response includes server info and available tools

Kiểm tra công cụ:

# Test initialize method
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {"tools": true},
      "clientInfo": {"name": "test-client", "version": "1.0.0"}
    }
  }'

Các công cụ MCP trong tương lai

KnowSync đang tích cực phát triển các công cụ MCP bổ sung dự kiến cho năm 2025:

Giai đoạn 1 (Q1 2025):

  • knowsync_summarize: Tạo bản tóm tắt thông minh cho tài liệu
  • knowsync_bulk_operations: Thực hiện các thao tác hàng loạt trên nhiều tài liệu
  • knowsync_compare: So sánh tài liệu để tìm điểm tương đồng và khác biệt

Giai đoạn 2 (Q2 2025):

  • knowsync_analytics: Nhận thông tin chi tiết về mức sử dụng và phân tích cơ sở tri thức
  • knowsync_quality_check: Phân tích và cải thiện chất lượng nội dung

Xem Lộ trình công cụ MCP để biết chi tiết đầy đủ.

Nhận hỗ trợ

Tài liệu:

  • Hướng dẫn kiểm tra MCP hoàn chỉnh với các ví dụ thực tế
  • Tài liệu tham khảo API cho tất cả các công cụ
  • Hướng dẫn tích hợp cho các nền tảng AI phổ biến

Kênh hỗ trợ:

  • Starter/Professional: Hỗ trợ qua email với chuyên môn về MCP
  • Enterprise: Hỗ trợ tích hợp MCP chuyên biệt
  • Tất cả các gói: Diễn đàn cộng đồng và tài liệu

Tích hợp tùy chỉnh: Khách hàng Enterprise có thể làm việc với đội ngũ của chúng tôi để phát triển công cụ MCP tùy chỉnh và các mẫu tích hợp nâng cao.

🚀 Sẵn sàng kết nối các công cụ AI của bạn?

Bắt đầu bằng cách tạo khóa API đầu tiên của bạn trong bảng điều khiển MCP, sau đó kiểm tra kết nối với một truy vấn tìm kiếm đơn giản. Hãy nhớ bao gồm các tiêu đề nhận dạng người dùng để phân bổ công việc theo nhóm chính xác.