KnowSync AI

官方

將您分散的文檔轉換為AI就緒的知識，可與Claude、Cursor、VS Code及其他AI工具無縫協作。

造訪 knowsync.ai試用此 MCP贊助

你可以用 KnowSync AI MCP 做什麼？

搜尋知識庫 — 讓您的 AI 使用 knowsync_query 自動偵測意圖並進行 AI 重新排序，以尋找相關文件與內容。
管理文件 — 使用 knowsync_manage 列出、瀏覽及依狀態或內容類型篩選文件，以進行知識庫稽核。
新增網路內容 — 讓您的 AI 爬取特定 URL 或探索相關網頁，並透過 knowsync_manage 自動將其加入知識庫。
具備對話情境的後續追問 — 在同一對話中提出具上下文關聯的後續問題，knowsync_query 會保留對話情境，以支援自然的多輪查詢。

文件

MCP 整合

KnowSync 的模型上下文協定（MCP）伺服器讓 AI 代理程式能即時存取您組織的知識庫。將 Claude、Cursor、VS Code 及其他 AI 工具連線，即可無縫搜尋、擷取及新增內容至您的知識庫。

什麼是 MCP？

總覽

模型上下文協定（MCP）是由 Anthropic 開發的開放標準，允許 AI 應用程式安全地存取外部資料來源。KnowSync 的 MCP 伺服器提供 2 個整合工具，具備智慧快取、AI 驅動的查詢最佳化及工作階段管理，讓 AI 代理程式能透過標準化的 JSON-RPC 2.0 API 與您的知識庫互動。

主要功能

2 個整合工具：

通用查詢：具備自動意圖偵測、AI 重新排序、智慧快取及工作階段感知上下文保留的智慧搜尋與擷取
文件管理：全面的內容管理，包括網頁爬取、探索及文件操作，並附使用量追蹤

企業級安全性：

具備細緻權限的 API 金鑰驗證
速率限制與使用量追蹤
所有請求的團隊成員歸屬
IP 限制與存取控制

設定 MCP API 金鑰

建立您的第一個 API 金鑰

存取 MCP 儀表板：前往您的組織儀表板，然後按一下 MCP 伺服器 卡片
前往 API 金鑰標籤頁：按一下 API 金鑰 區段
建立新金鑰：按一下 建立 API 金鑰 按鈕
設定金鑰組態：
- 名稱：描述性名稱（例如「Claude Desktop」、「開發測試」）
  - 權限：選擇金鑰可存取的工具
  - 速率限制：設定每小時請求數（依您的方案而定）

可用的 MCP 工具

KnowSync 提供 2 個強大的整合 MCP 工具，結合了先前 5 個工具系統的功能：

通用工具（所有方案）

knowsync_query：

具備智慧快取的通用搜尋與內容擷取（回應速度提升 60-85%）
自動意圖偵測（搜尋 vs 擷取），並附查詢擴充與最佳化
具備對話記憶的工作階段感知上下文保留，支援後續追問
根據 AI 查詢分類與信心評分進行智慧參數調整
AI 驅動的結果重新排序，提升關聯性（Pro+ 方案）
嵌入相似度快取，讓重複查詢瞬間完成

管理工具（所有方案）

knowsync_manage：

具備使用量追蹤的全面文件管理操作
列出與瀏覽文件，具備進階篩選與狀態監控（0.5 API 單位）
將特定網頁加入您的知識庫，並進行完整向量處理（每個 URL 2 個 API 單位：1 次爬取 + 1 次處理）
研究與探索相關網頁內容，並自動處理（每個探索到的 URL 2 個 API 單位）
所有文件操作的統一介面，並附詳細 API 消耗追蹤

權限設定

工具層級權限：每個 API 金鑰可依您的需求授予特定工具的存取權：

僅搜尋：適合唯讀 AI 代理程式
完整存取：可存取所有可用工具
自訂：為特殊使用案例選擇特定工具

速率限制：依使用模式設定請求限制：

免費方案：每小時最多 60 個請求
入門方案：每小時最多 600 個請求
專業方案：每小時最多 3,000 個請求
企業方案：可設定自訂限制

與 AI 工具整合

Claude Desktop 設定

先決條件：

Claude Desktop 應用程式（最新版本）
具備適當權限的 KnowSync API 金鑰
用於團隊追蹤的使用者識別

設定步驟：

取得您的伺服器 URL：https://www.knowsync.ai/api/mcp
新增至 Claude Desktop 設定：

{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Cursor IDE 整合

設定說明：

開啟 Cursor 設定（Cmd/Ctrl + ,）
前往 MCP 區段
新增 KnowSync 伺服器：

{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

VS Code 整合

使用 MCP 擴充功能：

安裝 VS Code 的 MCP 擴充功能
在 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"
      }
    }
  }
}

Claude Code 設定

先決條件：

已安裝 Claude Code CLI（透過 npm install -g @anthropic-ai/claude-code 安裝，或依照官方安裝指南）
具備適當權限的 KnowSync API 金鑰
您的 KnowSync 使用者／電子郵件 ID（可在個人資料設定中找到）

設定步驟：

使用 Claude CLI 新增 KnowSync MCP 伺服器：

使用使用者 ID：

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"

使用使用者電子郵件：

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"

驗證設定：

claude mcp list

這應會在清單中顯示 knowsync 伺服器。

注意：請確保您的 API 金鑰具備必要的工具權限。請以實際值取代佔位符。

團隊成員追蹤

必要標頭：所有 MCP 請求必須包含使用者識別，以進行正確歸屬：

X-User-Id：您的 KnowSync 使用者 ID（可在個人資料設定中找到）
X-User-Email：您註冊的電子郵件地址

為何需要：

追蹤個別團隊成員的使用情況
產生每位使用者的分析與洞察
確保完整的稽核軌跡
啟用基於使用量的計費與限制

實際 MCP 使用範例

開發工作流程整合

情境 1：程式碼審查助理

使用案例：AI 代理程式在程式碼審查期間，透過存取您團隊的編碼標準與最佳實務來提供協助。

# 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
      }
    }
  }'

AI 代理程式整合：設定 Claude Code 使用此功能，在開發期間即時存取您團隊的標準。

情境 2：新團隊成員入職

使用案例：自動將最新框架文件填入知識庫，供新進員工使用。

# 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
        }
      }
    }
  }'

預期回應與 API 消耗：

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

注意：4 個 URL × 每個 2 個單位（1 次爬取 + 1 次處理）= 共 8 個 API 單位

客戶支援強化

情境 3：即時支援文件存取

使用案例：支援人員在協助客戶時，可從產品文件獲得即時解答。

# 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
      }
    }
  }'

優點：由於快取機制，回應時間加快 60-85%，AI 增強的關聯性排序會優先顯示最有幫助的解決方案。

產品管理工作流程

情境 4：競爭分析研究

使用案例：產品經理研究競爭對手功能與產業趨勢。

# 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
        }
      }
    }
  }'

情境 5：功能需求查詢

使用案例：在規劃期間快速尋找現有的功能規格與需求。

# 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"]
        }
      }
    }
  }'

銷售與行銷支援

情境 6：銷售賦能

使用案例：銷售團隊在客戶通話期間存取產品資訊與競爭定位。

# 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
      }
    }
  }'

知識庫維護

情境 7：內容缺口分析

使用案例：識別現有的文件內容，以及需要建立的內容。

# 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"
        }
      }
    }
  }'

情境 8：新增產業文件

使用案例：讓知識庫隨時保有最新的產業標準與框架。

# 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
        }
      }
    }
  }'

為何 KnowSync MCP 具有革命性

力量的差異

傳統文件系統讓您搜尋資訊。KnowSync MCP 讓資訊主動來到您面前：

使用 KnowSync MCP 之前：

在不同工具之間切換以搜尋文件
針對類似問題重複搜尋
手動拼湊來自多個來源的資訊
每次搜尋等待 2-5 秒
取得的結果可能相關，也可能不相關

使用 KnowSync MCP 之後：

AI 代理程式自動存取您的知識庫
透過智慧快取讓回應速度提升 60-85%
AI 理解上下文，並提供您確切需要的內容
工作階段記憶維持對話上下文
結果由 AI 排序，達到最大關聯性

對您工作流程的實際影響

# 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

範例：開發人員詢問「我們如何處理驗證？」時，不僅會獲得驗證文件，還會獲得與其目前專案上下文相關的特定章節，並附後續建議，全程不到 2 秒。

進階整合模式

工作階段感知對話

AI 會記住同一工作階段中跨查詢的上下文，讓自然語言追問成為可能：

# 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?"
      }
    }
  }'

效能最佳化範例

展示智慧快取的威力：

# 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!)

轉變您團隊的生產力

使用 KnowSync MCP 之前 vs 之後

| 情境 | 傳統方法 | 使用 KnowSync MCP | 節省時間 | |----------|-------------------|-------------------|------------| | 程式碼審查 | 手動搜尋文件 | AI 代理程式即時引用編碼標準 | 加快 90% | | 客戶支援 | 查閱疑難排解指南 | AI 提供確切的解決步驟 | 加快 85% | | 入職訓練 | 傳送文件連結 | AI 依情境回答特定問題 | 加快 95% | | 產品規劃 | 手動研究競爭對手功能 | AI 探索並分析最新趨勢 | 加快 80% |

複合效應

第 1 週：您的團隊每天節省 2-3 小時的文件搜尋時間 第 1 個月：每位團隊成員節省 40-60 小時 第 1 年：每位團隊成員重新獲得 2-3 週的生產時間

真實使用者影響故事

開發團隊：「與其花 30 分鐘搜尋我們的 API 模式，Claude Code 會立即顯示我確切需要的內容。我可以專注於開發，而不是搜尋。」

支援團隊：「過去需要 10 分鐘研究的客戶問題，現在 30 秒內就能獲得解答。我們的回應品質提升了，同時回應時間大幅下降。」

產品團隊：「過去需要數小時的研究，現在幾分鐘內就能完成。我們能比以往更快地分析競爭功能、尋找需求並做出決策。」

開始使用很簡單

建立 API 金鑰（2 分鐘）
連線您的 AI 代理程式（Claude、Cursor、VS Code）
開始提出問題——就是這麼簡單！

力量不在於技術本身——而在於它如何將您的日常工作從搜尋轉變為創造。

使用量分析與監控

MCP 儀表板功能

API 金鑰管理：

建立、編輯與刪除 API 金鑰
監控每個金鑰的使用統計
設定權限與速率限制
檢視請求歷史與模式

使用量分析：

依工具分類的即時請求指標
成功／錯誤率與回應時間
每位使用者的歸屬與團隊洞察
歷史趨勢與使用模式

設定組態：

網頁爬取限制與逾時設定
網域允許／封鎖清單，用於網頁探索
內容類型篩選偏好
速率限制與安全控制

團隊使用追蹤

個人分析：

追蹤哪些團隊成員使用 MCP 工具
監控整個組織的採用模式
識別重度使用者與訓練需求
為管理層產生使用報告

請求歸屬：所有 MCP 請求都需要使用者識別標頭：

X-User-Id：直接的使用者 ID 歸屬
X-User-Email：以電子郵件為基礎的使用者歸屬
未包含使用者標頭的請求將被拒絕
完整的稽核軌跡以符合法規要求

安全性與存取控制

驗證系統

API 金鑰安全性：

儲存金鑰使用 Bcrypt 雜湊
自動金鑰輪換功能
每個金鑰的速率限制以防止濫用
可疑活動的即時監控

權限模型：

工具層級權限（細緻的存取控制）
以組織為基礎的存取限制
以方案為基礎的功能可用性
自訂權限組合

企業安全性（企業方案）

進階功能：

以 IP 為基礎的存取限制
單一登入（SSO）整合
符合法規要求的稽核日誌
自訂安全政策與控制

資料保護：

所有通訊皆採用 TLS 加密
API 金鑰與使用者資料的安全儲存
符合 GDPR 與 CCPA 規範的功能
定期安全稽核與更新

疑難排解

常見問題

連線問題：

錯誤：AI 代理程式無法連線至 MCP 伺服器
解決方法：
- 確認 API 金鑰正確且尚未過期
  - 確認您的網域 URL 可存取（遠端工具請勿使用 localhost）
  - 檢查是否已包含使用者識別標頭
  - 檢視 API 金鑰對所需工具的權限

驗證錯誤：

錯誤：「未經授權」或「需要使用者識別」
解決方法：
- 在所有請求中包含 X-User-Id 或 X-User-Email 標頭
  - 確認使用者 ID／電子郵件存在於您的組織中
  - 必要時重新產生 API 金鑰
  - 檢查 API 金鑰是否具備適當的工具權限

速率限制：

錯誤：「已超過速率限制」
解決方法：
- 在 MCP 儀表板中檢視目前使用量
  - 調整 API 金鑰的速率限制
  - 考慮升級方案以獲得更高的限制
  - 在應用程式中實作請求節流

工具權限錯誤：

錯誤：「工具 X 的權限遭拒絕」
解決方法：
- 在 MCP 儀表板中編輯 API 金鑰權限
  - 確保您的方案包含進階工具的使用權限
  - 聯絡支援團隊以了解方案特定的限制

測試您的 MCP 伺服器

健康檢查：

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

# Expected response includes server info and available tools

工具測試：

# 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"}
    }
  }'

未來的 MCP 工具

KnowSync 正積極開發預計於 2025 年推出的其他 MCP 工具：

第一階段（2025 年第一季）：

knowsync_summarize：產生文件的智慧摘要
knowsync_bulk_operations：對多份文件執行批次操作
knowsync_compare：比較文件的相似處與差異處

第二階段（2025 年第二季）：

knowsync_analytics：取得使用洞察與知識庫分析
knowsync_quality_check：分析並改善內容品質

請參閱我們的 MCP 工具藍圖以了解完整詳細資訊。

取得支援

文件：

包含實際範例的完整 MCP 測試指南
所有工具的 API 參考文件
熱門 AI 平台的整合指南

支援管道：

入門版／專業版：具備 MCP 專業知識的電子郵件支援
企業版：專屬的 MCP 整合支援
所有方案：社群論壇與文件

自訂整合：企業客戶可與我們的團隊合作，進行自訂 MCP 工具開發與進階整合模式。

🚀 準備好連結您的 AI 工具了嗎？

先在 MCP 儀表板中建立您的第一個 API 金鑰，然後使用簡單的搜尋查詢測試連線。請記得包含使用者識別標頭，以確保正確的團隊歸屬。