用途：帮助把 Xcode 的 MCP 服务（mcpbridge）接入各类 MCP 客户端，让 AI 工具访问 Xcode 项目。
前提：Xcode 26.3+ 且支持 MCP；macOS 已安装并运行 Xcode；Xcode 中至少打开一个项目或工作区。
启用：打开 Xcode 设置（Cmd+,），进入 Intelligence 标签，勾选 Enable Model Context Protocol，并确保 Xcode Tools 开关为 ON。否则 xcrun mcpbridge 能连上但不返回任何工具。
客户端配置：Claude Code 用 claude mcp add --transport stdio xcode -- xcrun mcpbridge，可用 claude mcp list 验证；Codex 用 codex mcp add xcode -- xcrun mcpbridge；Gemini CLI 用 gemini mcp add xcode -- xcrun mcpbridge；Cursor 在项目根目录 .cursor/mcp.json 中配置 command 为 xcrun、args 为 mcpbridge；VS Code + GitHub Copilot 在 .vscode/mcp.json 中配置 type 为 stdio、command 为 xcrun、args 为 mcpbridge。
验证：调用无参数的 XcodeListWindows，应返回 tabIdentifier 与 workspacePath；若为空列表，确认 Xcode 中已打开项目。
权限：客户端首次连接时 Xcode 弹出权限对话框，按 PID 标识进程，需在 Xcode 界面批准；权限按进程授予，客户端重启（新 PID）会再次弹窗，属预期行为。
多实例：默认自动选择——仅一个 Xcode 进程时用它，多个时用与 xcode-select 匹配的，没有则报错。可用 MCP_XCODE_PID 指定实例，如 claude mcp add --transport stdio xcode -- env MCP_XCODE_PID=12345 xcrun mcpbridge；用 pgrep -x Xcode 查 PID。MCP_XCODE_SESSION_ID 可提供稳定 UUID 用于跨重连跟踪会话。
限制与排查：Cursor 是严格 MCP 客户端，Xcode 的 mcpbridge 在工具声明 outputSchema 时省略 structuredContent，违反规范，可改用 XcodeMCPWrapper 作代理。连接被拒多为 Xcode 未运行或 MCP 开关关闭；工具指向错误项目时用 XcodeListWindows 核对 tabIdentifier；提示 No such command: mcpbridge 说明 Xcode 低于 26.3；调用缓慢多因大项目索引未完成。Xcode 内置助手另有配置文件位于 ~/Library/Developer/Xcode/CodingAssistant/codex 与 ClaudeAgentConfig。