latest / 指南 / 中文

泰芯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 检索泰芯官网公开资料 querylanguage 相关资料片段、来源类型和可追溯上下文
  • 资料范围:产品中心、解决方案、下载资料、技术文档、新闻活动、常见问题以及后台已发布的公开内容。
  • 语言范围:支持中文和英文资料检索,具体返回内容取决于官网中已发布和已索引的资料。
  • 典型用户:研发、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-documentationsearch_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 生成内容。