Plugin de Xcode para Claude Code: instalación y errores MCP

Conecta Claude Code con Xcode mediante el plugin de Apple o el registro manual de MCP. Comprueba el comando de exportación local y la instalación de Xcode seleccionada, permite agentes externos y verifica una compilación real. Resuelve la falta de herramientas y conecta Codex sin confundir el alcance del plugin con la facturación del modelo.

Índice
Plugin de Xcode para Claude Code: instalación y errores MCP

Claude Code puede editar archivos Swift y aun así no tener acceso a las compilaciones, pruebas y vistas previas de Xcode. En tu Mac, permite el acceso de agentes externos en Xcode y abre el proyecto antes de conectar Claude Code. Instala xcode@claude-plugins-official si funciona su comando de exportación local; de lo contrario, usa la conexión con xcrun mcpbridge documentada por Apple.

Estas instrucciones siguen la documentación oficial disponible a fecha de 2026-11-16. La guía de Apple para agentes externos explica los permisos y la conexión directa por MCP.

Comprueba qué Xcode está seleccionado en tu Mac

Usa una instalación completa de Xcode y una versión actual de Claude Code CLI. La entrada del marketplace obtiene el plugin de las herramientas de Xcode instaladas en tu Mac. Instalar el paquete del marketplace no instala Xcode si falta.

En Bash, desde el repositorio de tu aplicación, comprueba la versión del cliente y el directorio de desarrollo seleccionado:

claude --version
xcode-select --print-path

El directorio de desarrollo debe corresponder a la instalación de Xcode que quieras usar. El resultado /Library/Developer/CommandLineTools identifica el paquete independiente de herramientas de línea de comandos, no la aplicación Xcode. La guía de Apple para configurar las herramientas de línea de comandos explica esta diferencia.

Después, ejecuta el mismo comando que usa el marketplace:

xcrun agent plugin path --plugin-format claude

Si el comando de exportación funciona, muestra la ruta absoluta del directorio del plugin. Mantén ese directorio intacto: el marketplace usa mode: "link", que carga los archivos generados desde su ubicación original.

Claude Code añadió las fuentes de plugins basadas en comandos en 2.1.229, según su registro oficial de cambios. Usa una versión actual en lugar de quedarte en aquella versión. Para Xcode, comprueba que el comando de exportación funciona. No des por hecho que una instalación con mcpbridge también incluye agent plugin path.

Si no encuentras el propio comando claude, completa la instalación y las comprobaciones iniciales de Claude Code antes de diagnosticar Xcode.

Permite agentes externos y abre el proyecto

Autoriza el acceso del proceso externo desde los ajustes Intelligence de Xcode. Este permiso es independiente de la instalación del plugin de Claude Code.

  1. Abre Xcode > Settings > Intelligence.
  2. En Model Context Protocol, configura Allow External Agents to Use Xcode Tools como While Xcode is Open o Always.
  3. Abre el proyecto o espacio de trabajo que deba usar el agente.

Elige While Xcode is Open para este flujo interactivo. Mantén el proyecto abierto durante las comprobaciones siguientes. Según Apple, Xcode avisa cuando se conecta un agente externo y mientras está activo.

Mantén también la conexión al modelo que ya funciona. Una suscripción de Claude compatible consume la cuota del plan; una cuenta de Claude Console factura el uso de la API por separado. Elige la suscripción si su cuota es suficiente, o la API para pagar según el uso. Consulta la autenticación de Claude Code y revisa la disponibilidad regional de Anthropic antes de pagar por el acceso.

BetterToken ofrece otra vía de acceso a la API con pago por uso. Necesitas tu propia cuenta, una clave creada en la consola y la configuración documentada para Claude Code. Elígela para acceder a la API con un saldo independiente. Antes de pagar, comprueba las unidades de facturación del modelo, los métodos de pago y las comisiones. No incluye una suscripción a Claude. Consulta los precios actuales de los modelos y confirma las condiciones de pago en la consola.

Elige el plugin o la conexión directa por MCP

Usa el plugin si funciona el comando de exportación de tu Xcode. Registra MCP directamente si solo necesitas la conexión mediante el puente o si el comando de exportación no está disponible, pero mcpbridge funciona.

La entrada oficial del marketplace indica Apple Inc. como autor. La fuente del plugin ejecuta xcrun agent plugin path --plugin-format claude en tu equipo. En cambio, el comando de conexión directa registra xcrun mcpbridge como servidor MCP.

La diferencia está en cómo se distribuye el paquete, no en que una vía haya demostrado mejores resultados de compilación. Un plugin puede incluir habilidades (skills) y otros componentes junto con la configuración MCP. Inspecciona el paquete instalado; no presupongas una lista fija de habilidades ni una equivalencia completa de funciones. Empieza con una sola vía para facilitar el diagnóstico de fallos.

Instala xcode@claude-plugins-official

Inicia Claude Code desde el repositorio con claude. Introduce lo siguiente en su sesión interactiva, no en Bash:

/plugin install xcode@claude-plugins-official

Revisa las opciones de instalación y elige el alcance local para una primera prueba limitada al repositorio. Antes de autorizar el comando de exportación mostrado, comprueba que coincide con el anterior. Sigue las instrucciones de recarga del resumen de instalación, si aparecen, o inicia una sesión nueva de Claude Code.

Después, comprueba la instalación desde Bash en el mismo repositorio:

claude plugin list
claude plugin details xcode@claude-plugins-official

Comprueba que el paquete esté habilitado y revisa su lista de componentes. La referencia de comandos de plugins describe esta lista, incluidas las habilidades y los servidores MCP.

En Claude Code, ejecuta /mcp e inspecciona el servidor que aporta el plugin. Los servidores MCP de plugins usan nombres con el formato plugin:<plugin>:<server>; no tiene por qué aparecer el nombre simple xcode.

Para cambiar el alcance o eliminar el paquete más adelante, consulta la guía de instalación, verificación y eliminación de plugins.

Registra xcrun mcpbridge directamente

Ejecuta el comando exacto de registro de Apple en Bash, desde el repositorio donde vayas a usar Claude Code:

claude mcp add --transport stdio xcode -- xcrun mcpbridge
claude mcp list
claude

Esto registra una conexión con un proceso local mediante la entrada y la salida estándar. El nombre de servidor elegido en el comando es xcode. En la sesión interactiva, ejecuta /mcp y revisa el estado de la conexión antes de pedir una compilación.

Por defecto, el alcance de MCP es local al proyecto. Claude Code guarda la configuración en ~/.claude.json, asociada al proyecto, sin aplicarla automáticamente a todos los repositorios. La documentación del alcance de MCP explica esta distinción.

El registro por sí solo no confirma que todo funcione. Comprueba que el servidor se conecta y puede trabajar con el proyecto abierto en Xcode.

Verifica una compilación antes de pedir cambios en la aplicación

Primero pide una compilación sin modificar archivos. Así separas los problemas de conexión de los cambios que pueda introducir el modelo.

Envía este mensaje en la sesión de Claude Code conectada a Xcode. Pide identificar el proyecto y el esquema activos, compilar para un simulador disponible e informar del resultado sin editar archivos:

Use Xcode tools to identify the open project and active scheme.
Build that scheme for an available iOS Simulator destination.
Do not edit files.
Report the build result and the first actionable error, if any.

Busca una llamada real a una herramienta de Xcode y el resultado de compilación que devuelve. Xcode también debería indicar la actividad del agente externo. Un error del compilador puede confirmar que la conexión funciona, aunque la aplicación aún no compile. En ese caso, corrige el error del proyecto en lugar de reinstalar el plugin.

El marketplace describe la compilación, ejecución y prueba de esquemas; vistas previas de SwiftUI; operaciones con simuladores y dispositivos; registros de compilación, diagnósticos y búsqueda en la documentación de Apple. Comprueba qué operaciones están disponibles en tu instalación de Xcode y en la lista de herramientas conectadas.

Por ejemplo, las notas de Xcode 27 describen el arranque de simuladores, la instalación y ejecución de aplicaciones, la entrada táctil y las capturas de pantalla. Comprueba que las herramientas correspondientes estén disponibles antes de pedir una tarea que interactúe con la interfaz.

Después de verificar la compilación, pide al agente que identifique las pruebas disponibles y ejecute una prueba o conjunto pertinente. Para cambiar una vista, solicita que renderice una vista previa existente de SwiftUI e inspecciona el resultado. Exige el resultado de las pruebas o la propia vista previa, no solo una afirmación de que la tarea terminó bien.

Limita la primera tarea. Antes de añadir compilaciones repetidas y grandes volúmenes de diagnóstico, usa el método para medir el coste de contexto de MCP con una tarea reproducible.

Corrige el componente que falla, no toda la instalación

Elige la comprobación que corresponda a tu resultado. Son alternativas para situaciones distintas, no una secuencia que debas ejecutar completa.

xcrun no encuentra agent o mcpbridge

Comprueba primero xcode-select --print-path. Si está seleccionado un Xcode antiguo o el paquete independiente de herramientas de línea de comandos, el terminal puede usar herramientas distintas de las de la ventana de Xcode abierta.

Si la aplicación que quieres usar está en /Applications/Xcode.app, selecciónala en Bash:

sudo xcode-select --switch /Applications/Xcode.app

Si está instalada en otra ubicación, usa su ruta real. Este comando cambia el directorio de desarrollo predeterminado. Confirma la selección y vuelve a ejecutar el comando que falló.

Si agent plugin path sigue sin estar disponible, pero la conexión directa por MCP funciona, usa esa conexión. Si ninguna vía funciona, instala o selecciona una versión de Xcode con las herramientas necesarias antes de cambiar las credenciales del modelo en Claude Code.

claude mcp list no muestra una entrada llamada solo xcode

Para la conexión directa, ejecuta el comando desde el repositorio donde añadiste el servidor. Un registro local al proyecto no aparecerá automáticamente en otro repositorio.

Para el plugin, consulta claude plugin list y después /mcp dentro de Claude Code. Busca un servidor cuyo nombre incluya el del plugin, en vez de buscar solo xcode. Si el plugin está instalado pero desactivado, actívalo mediante /plugin e inicia una sesión nueva.

Si el instalador no encuentra la entrada del marketplace, actualiza su catálogo desde la sesión de Claude Code:

/plugin marketplace update claude-plugins-official

Repite la instalación después de actualizarlo. Si falta el propio marketplace, ejecuta primero /plugin marketplace add anthropics/claude-plugins-official. La guía de Anthropic para resolver problemas de plugins distingue estos errores de catálogo de los tipos de fuente no admitidos.

El servidor se conecta, pero el proyecto no está disponible

Abre el proyecto correcto en Xcode y revisa de nuevo Allow External Agents to Use Xcode Tools. Mantén Xcode abierto, inicia una sesión nueva del agente y repite la petición de compilación sin cambios.

La entrada del servidor confirma que existe una configuración. La información del proyecto y el resultado de compilación confirman que el agente ha accedido al proyecto correcto. Si la herramienta devuelve un error específico del proyecto, usa ese diagnóstico para decidir el siguiente paso.

Conecta Codex al mismo proyecto de Xcode

Puedes conectar Codex directamente por MCP, según las instrucciones de Apple, sin instalar el plugin del marketplace de Claude Code. Mantén el mismo permiso de Xcode y deja el proyecto abierto.

Con Codex CLI instalado y la autenticación completada, ejecuta estos comandos en Bash:

codex mcp add xcode -- xcrun mcpbridge
codex mcp list
codex

Dentro de Codex, usa /mcp para inspeccionar los servidores activos, como indica la documentación de OpenAI sobre MCP. Después, envía la misma petición de compilación sin cambios e inspecciona el resultado.

Para revocar el acceso de agentes externos, vuelve a los ajustes Intelligence de Xcode y elige Never en Allow External Agents to Use Xcode Tools.

¿Quieres optimizar tu flujo de trabajo con LLM?

Conecta modelos mediante una API, gestiona claves y controla el gasto en IA.

Empezar gratis