02
必需 · 第一步
先连接 Espressif Documentation
完整工作流程依赖官方资料检索。先完成添加和独立认证,再继续接入 Espressif Engineering。
- 配置名称
- espressif-docs
- Server URL
- https://mcp.espressif.com/docs
认证步骤
SEPARATE AUTH
- 打开 Cursor 的 Settings → Tools & MCP。
- 找到 espressif-docs 并点击 Connect。
- 在外部浏览器中使用 GitHub 或微信账号完成 Espressif Documentation 的独立认证,然后返回 Cursor。
03
必需 · 第二步
再连接 Espressif Engineering
Espressif Documentation 就绪后,添加工程问题处理服务,并按客户端提示完成 GitHub 授权。
- 配置名称
- espressif-engineering
- Server URL
- https://ts-mcp.espressif.com/mcp
GitHub 授权步骤
GITHUB AUTH
- 在 Settings → Tools & MCP 中找到 espressif-engineering。
- 点击 Connect,允许 Cursor 打开外部浏览器。
- 在浏览器中完成 GitHub 授权后返回 Cursor。
04
在客户端中验证
确认完整工作流程可用
网页不会读取客户端内部状态。请按这里的入口在客户端中逐项确认。
A
检查连接和认证状态
在 Cursor 的 Settings → Tools & MCP 中检查两项服务。
Espressif DocumentationCONNECTED / AUTHENTICATED
Espressif EngineeringCONNECTED / AUTHENTICATED
B
验证两项 MCP 服务
在新建会话中发送以下提示词。预期结果会列出当前可用的 MCP Server,其中应包含 espressif-docs 和 espressif-engineering。
检查当前有哪些 mcp server 可用
连接失败时的检查顺序与恢复方法
先按顺序检查
- 01
核对服务配置服务名称 · Server URL
- 02
确认连接状态是否启用 · 是否完成认证
- 03
检查调用条件工具权限 · 配置作用域
- 04
重新加载客户端重启客户端后重新检查状态
针对当前客户端的恢复方法
- 一键入口未打开时,打开 ~/.cursor/mcp.json,将两个 Server 合并到现有的 mcpServers 中。
- 服务已添加但没有认证入口时,确认服务已启用,并重新打开 Settings → Tools & MCP。
- 只看到一项服务时,确认两项服务都位于同一份 ~/.cursor/mcp.json 的 mcpServers 中,并重启 Cursor。
- 服务已连接但 Agent 不调用工具时,检查当前会话是否允许 MCP 工具权限。