用途：帮助把 Xcode 的 MCP 能力接入外部 AI 客户端，让客户端通过 xcrun mcpbridge 调用 Xcode 工具。
前提：Xcode 26.3+ 且支持 MCP；macOS 已安装并运行 Xcode；Xcode 中至少打开一个项目或工作区。
启用：打开 Xcode 设置（Cmd+,），进入 Intelligence 标签，勾选 Enable Model Context Protocol，并确保 Xcode Tools 开关为 ON。否则 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；MCP_XCODE_SESSION_ID 可提供稳定 UUID。
限制与排错：连接被拒多为 Xcode 未运行或 MCP 开关关闭；tools/list 为空多为未打开项目或未授权；工具指向错误项目时用 XcodeListWindows 核对 tabIdentifier；Cursor 等严格客户端因缺少 structuredContent 报错时，可用 XcodeMCPWrapper 作为代理；提示 No such command: mcpbridge 说明 Xcode 低于 26.3；调用缓慢可能因大项目索引未完成。Xcode 内置助手的 MCP 配置位于 ~/Library/Developer/Xcode/CodingAssistant/codex 与 ClaudeAgentConfig，与外部客户端配置相互独立。