MCP 服务器

每个 Jamdesk 站点都内置 MCP（Model Context Protocol）服务器。llms.txt 为 AI 工具提供文档的静态快照，而 MCP 支持交互式搜索和查询 — 当 AI 代理需要查找特定答案，而不是阅读全部内容时，这非常有用。

什么是 MCP？

Model Context Protocol 是一种开放标准，允许 AI 工具访问外部数据源。您的 Jamdesk 文档通过 MCP 提供两个工具：

端点 URL

您的 MCP 端点是在文档 URL 后追加 /_mcp。如果您已有在线的自定义域名，请使用该域名：

快速设置

claude mcp add --transport http my-docs https://docs.acme.com/_mcp

可用工具

searchDocs

搜索您的文档并获取按相关性排序的结果。

参数：

请求示例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "searchDocs",
    "arguments": {
      "query": "authentication",
      "limit": 5
    }
  }
}

响应示例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"query\":\"authentication\",\"total\":1,\"results\":[{\"title\":\"Authentication\",\"description\":\"How to authenticate API requests\",\"url\":\"/docs/api/authentication\",\"type\":\"api\",\"score\":0.95}]}"
    }]
  }
}

getPage

获取特定文档页面的完整内容。

参数：

请求示例：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "getPage",
    "arguments": {
      "slug": "api/authentication"
    }
  }
}

响应示例：

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"title\":\"Authentication\",\"description\":\"How to authenticate\",\"content\":\"## Overview\\n\\nUse API keys to authenticate...\",\"url\":\"/docs/api/authentication\"}"
    }]
  }
}

测试端点

您可以直接使用 curl 测试 MCP 端点：

# List available tools
curl -X POST https://docs.acme.com/_mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Search for content
curl -X POST https://docs.acme.com/_mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"searchDocs","arguments":{"query":"getting started"}}}'

工作原理

MCP 端点使用与文档一起构建的搜索索引：

• BM25 排名 - 按相关性对结果排序
• 模糊匹配 - 处理拼写错误（容许 1 个字符的差异）
• 字段加权 - 标题和章节标题的权重高于正文内容
• 类型筛选 - 按内容类型筛选结果（API、指南等）

每次部署时都会重新构建索引。

速率限制

MCP 端点按 IP 地址限制速率：每分钟 60 个请求。这足以满足 AI 助手的正常使用需求。如果超过限制，您将收到 429 响应。

故障排除

curl https://docs.acme.com/_mcp

接下来做什么？