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）将 AI 代理连接到您的 KnowSync 知识库。设置 API 密钥、配置工具，并与 Claude、Cursor 及其他 AI 助手集成。

15 分钟阅读 | KnowSync 团队 | 2025年9月18日

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 Server 卡片
进入 API 密钥选项卡：点击 API Keys 部分
创建新密钥：点击 Create API Key 按钮
配置密钥设置：
- 名称：描述性名称（例如，"Claude Desktop"、"Development Testing"）
  - 权限：选择该密钥可以访问的工具
  - 速率限制：设置每小时请求数（基于您的套餐）

可用的 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 前后对比

| 场景 | 传统方法 | 使用 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 密钥是否具有所需工具的权限

身份验证错误：

错误："Unauthorized" 或 "User identification required"
解决方案：
- 在所有请求中包含 X-User-Id 或 X-User-Email 请求头
  - 验证用户 ID/邮箱是否存在于您的组织中
  - 如有必要，重新生成 API 密钥
  - 检查 API 密钥是否具有适当的工具权限

速率限制：

错误："Rate limit exceeded"
解决方案：
- 在 MCP 仪表板中查看当前使用情况
  - 调整 API 密钥的速率限制
  - 考虑升级套餐以获得更高限额
  - 在应用程序中实现请求限流

工具权限错误：

错误："Permission denied for tool 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 平台的集成指南

支持渠道：

Starter/Professional：提供具备 MCP 专业知识的邮件支持
Enterprise：专属 MCP 集成支持
所有套餐：社区论坛和文档

自定义集成：企业客户可以与我们的团队合作，进行自定义 MCP 工具开发和高级集成模式。

🚀 准备好连接您的 AI 工具了吗？

首先在 MCP 仪表板中创建您的第一个 API 密钥，然后使用简单的搜索查询测试连接。请记得包含用户识别请求头，以确保正确的团队归属。