泰芯MCP服务器使用说明
介绍泰芯 MCP 服务器的价值、能力范围、接入方式、AI 助手区别、Cursor、VS Code、Claude Code 等客户端配置方法以及安全边界。
为什么使用泰芯 MCP
泰芯 MCP 服务器用于把泰芯官网公开资料接入到支持 MCP 的 AI 工具中。研发人员在 Cursor、VS Code、Claude Code、Codex CLI 等工具里提问时,AI 可以通过 MCP 检索泰芯官网的产品、方案、下载资料、技术文档和常见问题,再基于检索结果生成回答。
这种方式的价值在于:不用离开当前开发环境,也能让 AI 参考泰芯官方公开资料;可以减少模型只凭记忆回答造成的偏差;在型号选型、资料定位、技术支持和问题排查场景中,能更快找到可追溯的上下文。
请注意,MCP 返回的是公开资料检索上下文,AI 最终生成的回答仍可能存在不准确之处。关键规格、认证、价格、交期和项目承诺,请以官网正式资料或泰芯团队确认为准。
泰芯 MCP 服务器是什么
MCP 是 Model Context Protocol 的缩写,可以理解为 AI 工具调用外部资料和工具的一种标准接口。泰芯 MCP 服务器把官网资料封装成 AI 可调用的检索工具,让 AI 在回答泰芯相关问题时有机会先查官方资料,再组织答案。
泰芯 MCP 服务器不是后台管理接口,也不是客户私有资料接口。它默认只面向公开资料检索,不提供登录、数据修改、文件上传、内部系统访问、密钥读取或未公开资料查询能力。
服务器能力
当前 MCP 服务以官方资料检索为主,后续可以继续扩展产品选型、下载资料定位和 FAQ 检索等专用工具。
| 工具名称 | 用途 | 主要参数 | 返回内容 |
|---|---|---|---|
search_taixin_sources |
检索泰芯官网公开资料 | query、language |
相关资料片段、来源类型和可追溯上下文 |
- 资料范围:产品中心、解决方案、下载资料、技术文档、新闻活动、常见问题以及后台已发布的公开内容。
- 语言范围:支持中文和英文资料检索,具体返回内容取决于官网中已发布和已索引的资料。
- 典型用户:研发、FAE、销售支持、代理商技术人员和需要快速查询公开资料的客户。
MCP 服务器与网页 AI 助手的区别
泰芯官网同时提供网页 AI 助手和 MCP 服务器。两者使用同一批公开资料,但适合的使用场景不同。
| 能力 | 网页 AI 助手 | 泰芯 MCP 服务器 |
|---|---|---|
| 入口 | 官网右下角 AI 浮窗或独立聊天页 | Cursor、VS Code、Claude Code、Codex CLI 等 AI 工具 |
| 适合场景 | 客户快速问答、资料定位、销售支持咨询 | 开发环境内查资料、写代码时补充上下文、排查问题 |
| 交互方式 | 用户直接和网页聊天 | AI 客户端按需调用 MCP 工具检索资料 |
| 使用建议 | 适合泛问题和非研发用户 | 适合研发、FAE 和长期使用 AI 编码工具的用户 |
从 AI 助手一键接入
打开官网右下角的泰芯文档 AI 助手,点击右上角的 MCP 服务器 按钮,可以看到连接到 AI 工具的入口。
- 点击 添加到 Cursor,浏览器会尝试打开 Cursor,并带入 MCP 服务器配置。
- 点击 添加到 VS Code,浏览器会尝试打开 Visual Studio Code,并带入 MCP 服务器配置。
- 点击 添加到 Claude Code,会复制 Claude Code CLI 添加命令。
- 点击 复制 MCP 链接,可以把服务地址用于其他支持 MCP 的客户端。
浏览器可能会弹出确认框,询问是否允许打开本机应用。确认后,对应工具会继续完成 MCP 服务器添加流程。
服务器地址
本页示例会按照当前部署环境使用对应的 MCP 服务地址:
https://taixin-semi.com/api/mcp
预览环境使用:
https://preview.taixin-semi.com/api/mcp
正式环境使用:
https://taixin-semi.com/api/mcp
如果是在本地开发环境验证,地址通常为:
http://localhost:3100/api/mcp
如果站点部署在反向代理或 CDN 后面,请确认该路径允许 POST 请求,并保留必要的请求头。
添加到 Cursor
在官网 AI 助手的 MCP 下拉菜单中点击 添加到 Cursor 后,浏览器会调用 Cursor 协议链接。如果本机已经安装 Cursor,系统会提示是否允许打开该应用。
也可以手动在 Cursor 的 MCP 配置中添加:
{
"mcpServers": {
"taixin-documentation": {
"url": "https://taixin-semi.com/api/mcp"
}
}
}
保存配置并重启 Cursor 后,可以在 AI 对话里提问泰芯产品、方案或资料下载相关问题。
添加到 VS Code
在官网 AI 助手的 MCP 下拉菜单中点击 添加到 VS Code 后,浏览器会调用 Visual Studio Code 协议链接。如果本机已经安装 VS Code,系统会提示是否允许打开该应用。
也可以在 VS Code 的 MCP 配置中手动添加:
{
"mcp": {
"servers": {
"taixin-documentation": {
"type": "http",
"url": "https://taixin-semi.com/api/mcp"
}
}
}
}
保存配置后,在支持 MCP 的 VS Code AI 扩展中选择该服务器即可查询官网资料。
添加到 Claude Code
点击 添加到 Claude Code 会复制以下命令,也可以在终端手动执行:
claude mcp add taixin-documentation --url "https://taixin-semi.com/api/mcp"
配置完成后,可以在 Claude Code 中询问泰芯产品资料,例如 TXW8301 适合哪些应用场景、Wi-Fi HaLow 资料在哪里下载等。
添加到 Claude Desktop
如果你的 Claude Desktop 版本支持远程或 HTTP MCP 服务器,可以在连接器或 MCP 配置中添加以下服务器信息:
| 服务器名称 | taixin-documentation |
|---|---|
| 服务器地址 | https://taixin-semi.com/api/mcp |
如果当前版本只支持本地 stdio MCP,请使用支持 HTTP MCP 的代理方式,或优先使用 Claude Code、Cursor、VS Code 等已支持远程 MCP 的工具。
添加到 Gemini CLI 或其他客户端
不同 MCP 客户端的配置字段略有差异,但核心信息一致:服务器名称使用 taixin-documentation,服务器地址使用 https://taixin-semi.com/api/mcp。
以 Codex CLI 为例:
codex mcp add taixin-documentation --url "https://taixin-semi.com/api/mcp"
如果客户端需要选择传输类型,请选择 HTTP、Streamable HTTP 或远程 MCP 服务器;如果客户端只支持本地命令方式,请参考该客户端文档配置 HTTP MCP 代理。
如何确认 MCP 已生效
添加完成后,可以用以下方式确认 AI 工具是否真的调用了泰芯 MCP:
- 在 AI 工具里查看是否出现
taixin-documentation或search_taixin_sources之类的工具调用记录。 - 提出一个泰芯官网资料相关问题,例如“请参考泰芯官方资料,说明 TXW8301 适合哪些场景”。
- 如果 AI 没有自动调用 MCP,可以在提示词里明确写“请调用泰芯 MCP 服务器检索官方资料后回答”。
- 如果工具支持 MCP 服务器列表,确认
taixin-documentation处于启用状态。
使用建议
- 提问时尽量写清产品型号、应用场景和资料类型,例如“TXW8301 在低功耗摄像头场景有哪些优势”。
- 涉及代码、选型或排障时,让 AI 先检索泰芯 MCP,再根据检索结果给建议。
- 涉及关键规格、认证、价格、交期时,要求 AI 给出资料来源,并回到官网或泰芯团队确认。
- 不要把客户隐私、项目未公开信息、密钥、Token、内部报价或合同信息放进 MCP 查询问题。
- 在长期项目中,可以在项目说明里要求 AI 优先调用泰芯 MCP。
例如可以在项目的 AGENTS.md 或团队 AI 使用说明中加入:
当问题涉及泰芯产品、方案、下载资料、技术支持或型号比较时,
优先调用 taixin-documentation MCP 服务器检索泰芯官方公开资料;
无法确认的信息需要说明不确定性,并建议回到官网资料或泰芯团队确认。
推荐提问示例
- 请调用泰芯 MCP,说明 TXW8301 适合哪些应用场景,并按场景分类总结。
- 哪里可以下载 Wi-Fi HaLow 模组资料?请给出相关资料入口。
- 某个产品是否有认证资料或规格书?请基于官网公开资料回答。
- 如何提交技术支持问题?请给出官网路径和注意事项。
- 请根据泰芯官网公开资料比较两个型号的定位差异。
- 请帮我整理一个客户选型回复草稿,但所有关键结论都要基于泰芯 MCP 检索结果。
使用限制
- 泰芯 MCP 只做公开资料检索,不执行代码、不修改用户项目、不操作本机文件。
- MCP 检索结果不等同于正式承诺,AI 生成的总结也不等同于官方最终结论。
- 服务会受到泰芯安全策略保护,包括请求频率限制、异常访问识别、重复问题检测和日志留存。
- 如果访问频率过高、请求异常或疑似自动化滥用,系统可能临时限制 MCP 请求。
- 泛聊天、销售咨询或非研发用户,建议优先使用官网网页 AI 助手。
安全与权限边界
- MCP 服务只面向公开资料检索,不提供后台登录、数据修改、文件上传或内部系统访问能力。
- 管理员可在后台调整 MCP 每分钟请求限制、每日 IP 请求限制、敏感信息拦截和提示注入拦截。
- 用户提交给 AI 客户端的检索问题可能会作为查询发送给泰芯 MCP 服务,请避免包含敏感信息。
- 如后续启用账号、认证或更细粒度访问控制,具体规则以官网安全策略和服务说明为准。
常见问题排查
浏览器没有弹出打开软件的提示
请确认本机已经安装 Cursor 或 VS Code,并且浏览器允许调用 cursor://、vscode: 等应用协议。也可以改用“复制 MCP 链接”后手动配置。
AI 工具没有调用泰芯 MCP
请确认 MCP 服务器已经启用,并检查工具是否允许当前会话调用该服务器。部分 AI 工具需要在会话里手动允许工具调用,也可以在提示词中明确写“请调用泰芯 MCP 检索官方资料”。
AI 工具提示没有检索到资料
请检查问题中是否包含具体产品型号、资料类型或应用场景。若官网资料尚未发布、未归入公开资料或暂未完成索引,MCP 服务可能无法返回相关结果。
提示请求过于频繁
这通常是触发了访问保护规则。请稍后重试,或联系管理员在后台调整 MCP 请求频率限制。
是否需要联网
需要。泰芯 MCP 是远程服务,AI 客户端需要能够访问 https://taixin-semi.com/api/mcp。如果公司网络有代理、防火墙或域名白名单,请允许访问该地址。
是否需要账号
需要。首次连接时,MCP 客户端会打开泰芯官网的 OAuth 登录授权页面。完成授权后,客户端才能调用泰芯 MCP 的公开资料检索工具。
有几个 MCP 服务器
当前只需要添加一个服务器:taixin-documentation,地址为 https://taixin-semi.com/api/mcp。
是否需要在本机启动服务
不需要。测试或正式使用时连接泰芯官网远程 MCP 服务即可。本地地址 http://localhost:3100/api/mcp 仅用于泰芯官网开发调试。
如何确认回答是否可靠
MCP 服务会尽量提供来自官网公开资料的上下文,但最终结论仍建议回到对应产品页、技术文档、下载中心或联系泰芯团队确认。涉及规格、认证、价格和交期时,不建议只依赖 AI 生成内容。