Claude Code: Xcode-Plugin einrichten und MCP-Fehler beheben

Verbinde Claude Code über Apples Plugin oder eine manuelle MCP-Registrierung mit Xcode. Prüfe den lokalen Exportbefehl und die ausgewählte Xcode-Installation, erlaube externe Agenten und bestätige die Verbindung mit einem echten Build. Finde fehlende Werkzeuge und verbinde Codex, ohne Plugin-Geltungsbereiche und Modellabrechnung zu verwechseln.

Inhalt
Claude Code: Xcode-Plugin einrichten und MCP-Fehler beheben

Claude Code kann Swift-Dateien bearbeiten und trotzdem keinen Zugriff auf Builds, Tests und Vorschauen in Xcode haben. Erlaube auf deinem Mac externe Agenten in Xcode und öffne dein Projekt, bevor du Claude Code verbindest. Installiere xcode@claude-plugins-official, wenn der lokale Exportbefehl funktioniert; andernfalls nutze den von Apple dokumentierten Weg über xcrun mcpbridge.

Die folgende Anleitung entspricht der offiziellen Dokumentation mit Stand 2026-11-16. Apples Anleitung für externe Agenten beschreibt die Berechtigungen und die direkte MCP-Verbindung.

Prüfe vor der Installation, welches Xcode auf dem Mac ausgewählt ist

Verwende eine vollständige Xcode-Installation und eine aktuelle Version der Claude Code CLI. Der Marktplatz-Eintrag bezieht das Plugin aus den Xcode-Werkzeugen auf deinem Mac. Die Installation des Marktplatz-Pakets installiert kein fehlendes Xcode nach.

Prüfe in Bash aus dem Repository deiner App die CLI-Version und das ausgewählte Entwicklerverzeichnis:

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

Das Entwicklerverzeichnis muss zur Xcode-Installation gehören, die du verwenden möchtest. Die Ausgabe /Library/Developer/CommandLineTools steht für das eigenständige Paket mit Befehlszeilenwerkzeugen, nicht für die Xcode-App. Apples Anleitung zu den Einstellungen der Befehlszeilenwerkzeuge erklärt den Unterschied.

Führe anschließend genau den Befehl aus, den der Marktplatz verwendet:

xcrun agent plugin path --plugin-format claude

Ein erfolgreicher Exportbefehl gibt den absoluten Pfad zum Plugin-Verzeichnis aus. Lass dieses Verzeichnis unverändert bestehen: Der Marktplatz verwendet mode: "link" und lädt die erzeugten Dateien direkt an ihrem Speicherort.

Laut offiziellem Änderungsprotokoll unterstützt Claude Code seit 2.1.229 Plugin-Quellen, die einen Befehl ausführen. Nutze eine aktuelle Version, statt diese alte Version festzuschreiben. Prüfe bei Xcode, ob der Exportbefehl erfolgreich läuft. Setze nicht voraus, dass eine Installation mit mcpbridge auch agent plugin path bereitstellt.

Fehlt bereits der Befehl claude, erledige zuerst die Installation und die Prüfungen für den ersten Start von Claude Code. Untersuche erst danach Xcode.

Erlaube externe Agenten und öffne das Projekt

Erteile dem externen Prozess den Zugriff in den Intelligence-Einstellungen von Xcode. Diese Berechtigung ist von der Installation des Claude-Code-Plugins getrennt.

  1. Öffne Xcode > Settings > Intelligence.
  2. Setze unter Model Context Protocol die Option Allow External Agents to Use Xcode Tools auf While Xcode is Open oder Always.
  3. Öffne das Projekt oder den Arbeitsbereich, den der Agent verwenden soll.

Wähle für diesen interaktiven Ablauf While Xcode is Open. Lass das Projekt während der folgenden Prüfungen geöffnet. Laut Apple meldet Xcode, wenn sich ein externer Agent verbindet und während er aktiv ist.

Behalte auch deine funktionierende Modellverbindung bei. Ein geeignetes Claude-Abonnement nutzt das Kontingent des jeweiligen Tarifs; ein Claude-Console-Konto ermöglicht separat abgerechnete API-Nutzung. Wähle das Abonnement, wenn dein vorhandenes Kontingent ausreicht, oder die API für eine nutzungsabhängige Abrechnung. Lies die Hinweise zur Authentifizierung in Claude Code und prüfe vor dem Kauf die von Anthropic unterstützten Regionen.

BetterToken bietet einen weiteren API-Zugang mit nutzungsabhängiger Abrechnung. Verwende dein eigenes Konto und einen in der Konsole erstellten Schlüssel mit der dokumentierten Claude-Code-Konfiguration. Wähle diesen Weg für API-Zugriff mit separat aufgeladenem Guthaben. Prüfe vor der Zahlung die Abrechnungseinheiten des Modells, die Zahlungswege und die Gebühren. Ein Claude-Abonnement ist nicht enthalten. Prüfe die aktuellen Modellpreise und bestätige die Zahlungsbedingungen in der Konsole.

Wähle das Plugin oder die direkte MCP-Verbindung

Verwende das Plugin, wenn der Exportbefehl deines Xcode funktioniert. Registriere MCP direkt, wenn du nur die Verbindung über die Bridge brauchst oder der Exportbefehl fehlt, aber mcpbridge funktioniert.

Der offizielle Marktplatz-Eintrag nennt Apple Inc. als Autor. Die Plugin-Quelle führt xcrun agent plugin path --plugin-format claude lokal aus. Der Befehl für die direkte Verbindung registriert dagegen xcrun mcpbridge als MCP-Server.

Das ist ein Unterschied bei der Bereitstellung. Er belegt nicht, dass einer der Wege bessere Build-Ergebnisse liefert. Ein Plugin kann neben der MCP-Konfiguration auch Skills und weitere Komponenten enthalten. Prüfe das installierte Paket, statt eine feste Skill-Liste oder identische Funktionen beider Wege vorauszusetzen. Beginne mit einem Weg, damit sich Fehler leichter eingrenzen lassen.

Installiere xcode@claude-plugins-official

Starte Claude Code aus deinem Repository mit claude. Gib den folgenden Befehl in der interaktiven Claude-Code-Sitzung ein, nicht in Bash:

/plugin install xcode@claude-plugins-official

Prüfe die Installationsoptionen und wähle für den ersten Versuch den lokalen Geltungsbereich, der auf dieses Repository begrenzt ist. Genehmige den angezeigten Exportbefehl erst, nachdem du ihn mit dem obigen Befehl verglichen hast. Befolge gegebenenfalls die Anweisung zum Neuladen in der Installationsübersicht oder starte eine neue Claude-Code-Sitzung.

Prüfe die Installation anschließend in Bash im selben Repository:

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

Stelle sicher, dass das Paket aktiviert ist, und prüfe seine Komponentenliste. Die Referenz der Plugin-Befehle beschreibt diese Liste, einschließlich vorhandener Skills und MCP-Server.

Führe in Claude Code /mcp aus und prüfe den vom Plugin bereitgestellten Server. MCP-Server aus Plugins verwenden Namen im Format plugin:<plugin>:<server>. Ein Eintrag, der nur xcode heißt, ist deshalb nicht erforderlich.

Wenn du später den Geltungsbereich ändern oder das Paket entfernen möchtest, nutze die Anleitung zum Installieren, Prüfen und Entfernen von Plugins.

Registriere xcrun mcpbridge direkt

Führe Apples Registrierungsbefehl unverändert in Bash aus, und zwar im Repository, in dem du Claude Code verwenden wirst:

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

Damit registrierst du eine Verbindung zu einem lokalen Prozess über die Standardein- und -ausgabe. Der im Befehl gewählte Servername lautet xcode. Führe in der interaktiven Sitzung /mcp aus und prüfe den Verbindungsstatus, bevor du einen Build anforderst.

Der standardmäßige MCP-Geltungsbereich ist auf das aktuelle Projekt beschränkt. Claude Code speichert die Konfiguration projektbezogen in ~/.claude.json, statt sie automatisch auf alle Repositories anzuwenden. Die Dokumentation zu MCP-Geltungsbereichen erklärt den Unterschied.

Die Registrierung allein bestätigt noch keine funktionierende Verbindung. Prüfe, ob sich der Server verbindet und mit dem in Xcode geöffneten Projekt arbeiten kann.

Prüfe einen Build, bevor du Änderungen an der App anforderst

Fordere zuerst einen Build ohne Dateiänderungen an. So trennst du Verbindungsprobleme von Änderungen, die das Modell möglicherweise einführt.

Verwende diesen Prompt in der verbundenen Claude-Code-Sitzung. Er fordert den Agenten auf, das geöffnete Projekt und das aktive Schema zu ermitteln und ohne Dateiänderungen für einen verfügbaren Simulator zu bauen:

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.

Achte auf einen tatsächlichen Xcode-Werkzeugaufruf und das zurückgegebene Build-Ergebnis. Xcode sollte ebenfalls die Aktivität des externen Agenten anzeigen. Auch ein zurückgegebener Compilerfehler kann bestätigen, dass die Verbindung funktioniert, obwohl sich die App noch nicht bauen lässt. Behebe dann den Projektfehler, statt das Plugin neu zu installieren.

Der Marktplatz beschreibt das Bauen, Ausführen und Testen von Schemata, SwiftUI-Vorschauen, Simulator- und Geräteaktionen, Build-Logs, Diagnosen und die Suche in Apples Entwicklerdokumentation. Welche Aktionen verfügbar sind, musst du anhand deiner Xcode-Installation und der Liste verbundener Werkzeuge prüfen.

Apples Versionshinweise zu Xcode 27 nennen etwa das Starten von Simulatoren, das Installieren und Starten von Apps, Touch-Eingaben und Screenshots. Prüfe, ob die entsprechenden Werkzeuge verfügbar sind, bevor du eine Aufgabe zur Bedienung der Oberfläche anforderst.

Lass den Agenten nach der Build-Prüfung die verfügbaren Tests ermitteln und einen passenden Test oder eine Testsuite ausführen. Bei einer Änderung an einer Ansicht soll er eine vorhandene SwiftUI-Vorschau rendern. Prüfe das zurückgegebene Ergebnis. Verlange das Testergebnis oder die Vorschau selbst, nicht nur eine Erfolgsmeldung.

Begrenze die erste Aufgabe. Bevor du wiederholte Builds und umfangreiche Diagnosen hinzufügst, vergleiche eine reproduzierbare Aufgabe mit der Methode zur Messung der MCP-Kontextkosten.

Behebe den Fehler an der betroffenen Stelle, nicht an der gesamten Installation

Wähle den Abschnitt, der zu deinem Ergebnis passt. Diese Prüfungen sind Alternativen für unterschiedliche Situationen und keine Schrittfolge, die jeder vollständig ausführen muss.

xcrun findet agent oder mcpbridge nicht

Prüfe zuerst xcode-select --print-path. Wenn ein älteres Xcode oder das eigenständige Paket der Befehlszeilenwerkzeuge ausgewählt ist, kann dein Terminal andere Werkzeuge verwenden als das geöffnete Xcode.

Ist die gewünschte App unter /Applications/Xcode.app installiert, wähle sie in Bash aus:

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

Verwende den tatsächlichen Installationspfad, falls er abweicht. Dadurch ändert sich das standardmäßige Entwicklerverzeichnis. Bestätige die Auswahl und führe den fehlgeschlagenen Befehl erneut aus.

Bleibt agent plugin path nicht verfügbar, während die direkte MCP-Verbindung funktioniert, nutze diese Verbindung. Funktioniert keiner der beiden Wege, installiere oder wähle eine Xcode-Version mit den benötigten Werkzeugen. Prüfe das zuerst, bevor du die Modellzugangsdaten von Claude Code änderst.

claude mcp list zeigt keinen Eintrag, der nur xcode heißt

Führe den Befehl bei einer direkten Verbindung aus dem Repository aus, in dem du den Server hinzugefügt hast. Eine projektlokale Registrierung erscheint nicht automatisch in einem anderen Repository.

Prüfe beim Plugin zunächst claude plugin list und anschließend /mcp in Claude Code. Suche nach einem Servernamen mit Plugin-Präfix statt nach dem Namen xcode allein. Ist das Plugin installiert, aber deaktiviert, aktiviere es über /plugin und starte eine neue Sitzung.

Findet die Installation den Marktplatz-Eintrag nicht, aktualisiere den Katalog in der Claude-Code-Sitzung:

/plugin marketplace update claude-plugins-official

Wiederhole die Installation nach der Aktualisierung. Fehlt der Marktplatz selbst, führe zuerst /plugin marketplace add anthropics/claude-plugins-official aus. Anthropic unterscheidet in der Anleitung zur Plugin-Fehlerbehebung zwischen solchen Katalogfehlern und nicht unterstützten Quelltypen.

Der Server verbindet sich, aber das Projekt ist nicht verfügbar

Öffne das gewünschte Projekt in Xcode und prüfe erneut Allow External Agents to Use Xcode Tools. Lass Xcode geöffnet, starte eine neue Agentensitzung und wiederhole den Prompt für einen Build ohne Änderungen.

Ein Servereintrag bestätigt, dass eine Konfiguration existiert. Die zurückgegebenen Projektinformationen und das Build-Ergebnis bestätigen, dass der Agent das richtige Projekt erreicht hat. Meldet das Werkzeug einen projektspezifischen Fehler, richte den nächsten Schritt nach dieser Diagnose aus.

Verbinde Codex mit demselben Xcode-Projekt

Codex kann Apples direkte MCP-Verbindung nutzen, ohne das Plugin aus dem Claude-Code-Marktplatz zu installieren. Behalte dieselbe Berechtigungseinstellung in Xcode bei und lass das Projekt geöffnet.

Führe nach Installation und Authentifizierung der Codex CLI diese Befehle in Bash aus:

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

Prüfe innerhalb von Codex mit /mcp die aktiven Server, wie in OpenAIs MCP-Dokumentation beschrieben. Verwende anschließend denselben Prompt für einen Build ohne Änderungen und prüfe das zurückgegebene Ergebnis.

Um externen Agenten den Zugriff später zu entziehen, öffne wieder die Intelligence-Einstellungen von Xcode. Wähle unter Allow External Agents to Use Xcode Tools die Option Never.

Bereit, Ihren LLM-Workflow zu optimieren?

Verbinden Sie Modelle über eine API, verwalten Sie Schlüssel und behalten Sie KI-Kosten im Blick.

Kostenlos starten