MCP 接入指南
将税享会TaxAI 的知识库能力接入你的 AI 助手(WorkBuddy / Claude / Cursor 等),两种方式任选
一、接入方式(任选其一)
方式一:开发者控制台 · 一键授权(推荐)
前往开发者控制台,获取 API Token 并完成自动配置,无需手动填写配置文件:
流程:注册/登录 → 获取 API Token → 将 Token 填入 MCP 客户端配置(或使用 OAuth 一键授权链接自动完成)。适用于 WorkBuddy / Claude Desktop / Cursor 等支持 MCP 的客户端。
方式二:手动配置(mcp.json)
适合熟悉 MCP 配置的开发者,手动添加以下服务器配置:
{
"mcpServers": {
"税享会TaxAI": {
"type": "streamableHttp",
"url": "https://taxai.top/mcp/servers/<server_id>",
"headers": {
"Authorization": "Bearer <API Key>"
}
}
}
}
说明:
<server_id> 和 <API Key> 由管理员在 Dify 控制台「发布 → MCP Server」生成后提供。请勿将 API Key 泄露给第三方。
二、接口协议
2.1 端点信息
| 项 | 值 |
|---|---|
| 协议 | Streamable HTTP(MCP) |
| 地址 | https://taxai.top/mcp/servers/<server_id> |
| 鉴权 | Bearer Token(请求头 Authorization) |
| 数据源 | 税享会财税知识库(25K+ 法规条目) |
2.2 能力
- 语义检索:基于向量相似度的法规检索,支持自然语言提问
- 元数据过滤:按税种、法规层级、地区、行业等维度过滤
- 引用溯源:返回结果附带法规原文出处
2.3 请求示例(MCP tools/call)
{
"method": "tools/call",
"params": {
"name": "search_knowledge",
"arguments": {
"query": "小规模纳税人增值税免税额度"
}
}
}
2.4 响应示例
{
"content": [
{
"type": "text",
"text": "…检索结果(含法规原文与出处)…"
}
]
}
2.5 限流
- 默认单用户每秒最多 5 次请求
- 超限返回 429,请适当降低请求频率