MCP-gesteuerte Coding-Agenten in GitHub Copilot und Xcode einrichten
Bevor du beginnst
- Ein GitHub-Konto mit GitHub-Copilot-Zugang
- Eine Xcode-Installation (mit agentischem Coding-Support) oder spaeter auf macOS
- Ein unterstuetztes Coding-Agent-Konto fuer Xcode, wie Anthropic Claude Code oder OpenAI Codex
- Grundlegende Git-Kenntnisse (clone, commit, push, Pull Request erstellen)
- Berechtigung zum Aendern von Repository-Einstellungen, wenn Sie MCP-Server in GitHub hinzufuegen moechten
Was du lernen wirst
- Erklaeren, wie sich Coding-Agenten von Autocomplete und reinen Chat-Assistenten unterscheiden
- GitHub Copilot Coding Agent auf einem echten Repository aktivieren und verifizieren
- Xcode (mit agentischem Coding-Support) agentisches Coding einrichten und einen unterstuetzten Agenten verbinden
- MCP-basierte Tools hinzufuegen und bestaetigen, dass der Agent sie verwenden kann
- Einen echten Bug-Fix- und Test-Workflow ueber GitHub und Xcode durchfuehren
- Agent-Ergebnisse sicher ueberpruefen und praktische Leitplanken fuer die Nutzung einrichten
Auf dieser Seite
MCP-gesteuerte Coding-Agenten ueberschreiten endlich die Grenze von interessanten Demos zu praktischem taeglichem Tooling. Statt bei Inline-Vorschlaegen oder Chat-Antworten aufzuhoeren, koennen Coding-Agenten Ihr Repo inspizieren, Arbeit planen, Tools verwenden, Aenderungen vornehmen, Builds oder Tests ausfuehren und Ihnen etwas Konkretes zum Review uebergeben.
Das ist gerade jetzt wichtig, weil sowohl GitHub als auch Apple dieses Modell naeher an den normalen Entwicklerworkflow gebracht haben. Auf der GitHub-Seite kann der Coding Agent aus dem Repository-Kontext arbeiten und MCP-gestuetzte Tools verwenden. Auf der Xcode-Seite fuegt Xcode (mit agentischem Coding-Support) agentisches Coding hinzu und kann Xcode-Faehigkeiten ueber das Model Context Protocol exponieren, was lokale Apple-Plattform-Workflows viel nuetzlicher macht als reines Copy-Paste-Prompting.
In diesem Tutorial werden Sie ein kleines Swift-Paket einrichten, Coding-Agenten in GitHub Copilot und Xcode aktivieren, MCP-basierte Tools verbinden und einen echten Workflow durchfuehren: den Agenten bitten, die Codebasis zu erklaeren, einen Bug zu fixen, Tests hinzuzufuegen und dann das Ergebnis zu validieren, bevor Sie es akzeptieren.
Bevor Sie beginnen, stellen Sie sicher, dass Sie auf GitHub Copilot zugreifen koennen, ein Projekt in Xcode (mit agentischem Coding-Support) oder spaeter oeffnen koennen und sich mit einem unterstuetzten Coding-Produkt in Xcode authentifizieren koennen. Sie brauchen keine riesige Codebasis fuer diese Anleitung. Ein winziges Swift-Paket reicht aus, um zu beweisen, dass der Workflow Ende-zu-Ende funktioniert.
Schritt 1: Die beweglichen Teile verstehen
Bevor Sie Features aktivieren, hilft es, zu verstehen, was jede Schicht tut. Die meisten Agent-Setup-Probleme sind eigentlich mentale-Modell-Probleme: Das falsche Tool ist aktiviert, der Agent hat den falschen Scope, oder der Entwickler erwartet Autocomplete-Verhalten von einem System, das fuer die Erledigung von Aufgaben konzipiert ist.
Was Agent HQ ist
In GitHub ist der Coding Agent nicht einfach “Copilot-Chat, aber staerker.” Er laeuft als autonomer aufgabenorientierter Workflow, der an Ihr Repository und Ihren Pull-Request-Prozess gebunden ist. Je nach Ihrem Plan und Setup koennen Sie vom Agents-Tab des Repositorys oder der globalen Agenten-Seite aus arbeiten, ein Repository waehlen, einen Task starten und die Live-Session ueberwachen, waehrend der Agent Code liest, Dateien bearbeitet und einen Pull Request vorbereitet.
Das unterscheidet sich grundlegend von Autocomplete. Autocomplete sagt vorher, was als Naechstes am Cursor kommt. Ein Coding Agent evaluiert ein Ziel, zerlegt es in Schritte, navigiert durch Ihre Codebasis und arbeitet auf eine Implementierung hin, die Sie ueberpruefen koennen.
Was Xcode agentisches Coding tut
Xcode (mit agentischem Coding-Support) fuegt lokal eine aehnliche Verschiebung hinzu. Statt nur Snippets zu generieren, kann Xcode mit einem externen Coding-Agenten arbeiten, der Xcode-bereitgestellte Faehigkeiten verwendet, um Ihr Projekt zu inspizieren, Apple-Dokumentation zu durchsuchen, zu bauen, zu testen und zu iterieren. Das bedeutet, Ihr Xcode-Setup kann zu einer echten Ausfuehrungsumgebung fuer Agentenarbeit werden, statt nur ein Texteditor, der Prompts an ein Modell sendet.
Wo MCP hineinpasst
MCP ist der Kleber zwischen Modellen und Tools. Ein Modell allein kann ueber Text nachdenken, den Sie ihm senden, aber MCP laesst den Agenten strukturierte Tools und externen Kontext auf standardisierte Weise verwenden. In der Praxis bedeutet das Dinge wie:
- Repository- und Issue-Zugriff
- Build- und Test-Befehle
- Dokumentations-Lookup
- Bug- und Exception-Kontext
- Issue-Tracker- oder Deployment-Daten
Auf GitHub kann MCP Tools von konfigurierten Servern dem Coding Agent zur Verfuegung stellen. In Xcode ist MCP der Weg, wie externe Coding-Tools auf Xcode-Faehigkeiten wie Build, Test und Dokumentationssuche zugreifen koennen.
Denken Sie an MCP als den Tool-Vertrag, nicht als das Modell. Das Modell entscheidet, was zu tun ist; MCP definiert, wie es sicher Tools aufrufen und Kontext verbrauchen kann.
Ein gutes Arbeitsmodell ist dieses:
- GitHub Coding Agent ist ideal fuer Hintergrund-Repo-Aufgaben, die in einem Pull Request enden sollten.
- Xcode agentisches Coding ist ideal fuer interaktive lokale Entwicklung, Debugging und Apple-Plattform-Kontext.
- MCP ist das, was beiden Zugriff auf mehr als reinen Text gibt.
Sie sollten nun verstehen, warum dieses Setup maechiger ist als Autocomplete allein, und warum GitHub plus Xcode plus MCP eine nuetzliche Kombination ist statt drei unzusammenhaengende Features.
Schritt 2: Coding-Agenten in GitHub aktivieren
Dieser Schritt bringt den GitHub Copilot Coding Agent auf einem Repository zum Laufen, das Sie kontrollieren. Das Ziel ist sicherzustellen, dass der Agent das Repo sehen, einen Task starten und am richtigen Ort arbeiten kann, bevor Sie zusaetzliche MCP-Tools hinzufuegen.
Ein kleines Uebungs-Repository erstellen
Wenn Sie noch kein sicheres Repo zum Testen haben, erstellen Sie ein kleines Swift-Paket. Das gibt Ihnen etwas, das Xcode oeffnen und GitHub bearbeiten kann.
Erstellen Sie einen neuen Ordner und initialisieren Sie das Paket:
mkdir AgentPlayground
cd AgentPlayground
swift package init --type library
mkdir -p Sources/AgentPlayground
mkdir -p Tests/AgentPlaygroundTests
Ersetzen Sie Package.swift mit:
// swift-tools-version: 6.0
import PackageDescription
let package = Package(
name: "AgentPlayground",
products: [
.library(
name: "AgentPlayground",
targets: ["AgentPlayground"]
)
],
targets: [
.target(
name: "AgentPlayground"
),
.testTarget(
name: "AgentPlaygroundTests",
dependencies: ["AgentPlayground"]
)
]
)
Erstellen Sie Sources/AgentPlayground/TipCalculator.swift:
import Foundation
public enum TipCalculator {
public static func total(amount: Double, tipPercent: Int) -> Double {
let tip = amount * Double(tipPercent / 100)
return amount + tip
}
}
Diese Datei hat einen absichtlichen Bug: tipPercent / 100 fuehrt ganzzahlige Division vor der Konvertierung durch, sodass 15 / 100 zu 0 wird.
Committen Sie das Repo:
git init
git add .
git commit -m "Create AgentPlayground sample"
Pushen Sie es zu einem neuen GitHub-Repository:
git branch -M main
git remote add origin git@github.com:YOUR-USER/agent-playground.git
git push -u origin main
GitHub Copilot Coding Agent-Zugriff aktivieren
Die Verfuegbarkeit des GitHub Copilot Coding Agent haengt von Ihrem Plan und den Admin-Einstellungen ab. Als individueller Abonnent ist er moeglicherweise bereits aktiviert. In Business- oder Enterprise-Umgebungen muss ein Administrator ihn moeglicherweise zuerst aktivieren und den Repository-Zugriff erlauben.
Pruefen Sie auf hoher Ebene diese Punkte:
- Oeffnen Sie die GitHub Copilot-Einstellungen.
- Bestaetigen Sie, dass der Coding Agent fuer Ihr Konto oder Ihre Organisation aktiviert ist.
- Bestaetigen Sie, dass Ihr Ziel-Repository im Repository-Zugriff enthalten ist.
- Oeffnen Sie das Repository und suchen Sie nach dem Agents-Tab oder verwenden Sie die globale Agenten-Seite.
Wenn Sie Copilot Business oder Enterprise nutzen und das Feature fehlt, ist das Problem oft die Organisationsrichtlinie, nicht Ihr Repository.
Ihre erste Agent-Session starten
Oeffnen Sie das Repository in GitHub und starten Sie dann einen neuen Task vom Agents-Tab oder der globalen Agenten-Seite. Waehlen Sie Ihr Repository und den Basis-Branch.
Fuer Ihren ersten Task verwenden Sie einen Read-Only-Prompt, der beweist, dass der Agent das Repo sehen kann:
Explain the structure of this repository. Identify the package name,
the main target, and the file most likely responsible for tip
calculations. Do not make any changes yet.
Eine gute Antwort sollte erwaehnen:
- das
AgentPlayground-Paket - das
AgentPlayground-Target Sources/AgentPlayground/TipCalculator.swift
Wenn Ihr Plan mehrere Agenten oder Modellauswahlen umfasst, waehlen Sie zuerst den Standard-Copilot-Coding-Agent. Optimieren Sie die Modellauswahl nicht, bevor Sie bestaetigt haben, dass der grundlegende Repository-Zugriff funktioniert.
Verifizieren, dass der Agent die Codebasis sehen kann
Die einfachste Verifikation ist nicht, ob die Session startet. Es ist, ob der Agent Dateien, Targets und wahrscheinliche Bearbeitungsstellen genau beschreiben kann, ohne zu halluzinieren.
Sie sollten nun eine Session sehen, die Ihr Paket benennen, TipCalculator.swift identifizieren und die Repository-Struktur korrekt referenzieren kann. Wenn das nicht moeglich ist, stoppen Sie hier und beheben Sie den Repository-Zugriff, bevor Sie weitermachen.
Schritt 3: Agentisches Coding in Xcode einrichten
Jetzt konfigurieren Sie die lokale Seite des Workflows. Das Ziel ist, ein unterstuetztes Coding-Produkt in Xcode zu verbinden, Xcodes MCP-gestuetzte Tools zu aktivieren und zu bestaetigen, dass der Agent Ihren Projektkontext inspizieren kann.
Dasselbe Projekt in Xcode oeffnen
Oeffnen Sie aus dem Repo-Root das Swift-Paket in Xcode:
xed .
Wenn xed nicht verfuegbar ist, oeffnen Sie Xcode manuell und waehlen Sie die Package.swift-Datei oder den Ordner.
Coding-Intelligence aktivieren und einen unterstuetzten Agenten verbinden
Oeffnen Sie in Xcode:
Xcode > Settings > Intelligence
Aktivieren Sie dort das Coding-Produkt, das Sie verwenden moechten. Xcode (mit agentischem Coding-Support) unterstuetzt direkte Setup-Flows fuer unterstuetzte Coding-Agenten, und der Coding-Assistent laesst Sie waehlen, welches Produkt in einer Konversation verwendet werden soll.
Wenn das Produkt Authentifizierung erfordert, melden Sie sich an und beenden Sie das Setup, bevor Sie fortfahren.
Verwenden Sie fuer diesen ersten Durchlauf ein unterstuetztes Agent-Konto und halten Sie den Workflow einfach. Sobald das Setup funktioniert, koennen Sie das Agent-Verhalten bei derselben Aufgabe vergleichen, statt mehrere Setup-Variablen gleichzeitig zu debuggen.
Einen Agenten im Coding-Assistenten waehlen
Oeffnen Sie den Coding-Assistenten in Xcode. Starten Sie in der Coding-Assistenten-Toolbar eine neue Konversation und verwenden Sie den Produktwaehler, um das aktivierte Coding-Produkt auszuwaehlen.
Verwenden Sie diesen ersten Prompt:
Inspect the open Swift package and explain where the business logic
lives, where tests should go, and which file you would change to fix
the tip calculation bug. Do not edit anything yet.
Eine gute Antwort sollte identifizieren:
- Geschaeftslogik in
Sources/AgentPlayground/TipCalculator.swift - Tests in
Tests/AgentPlaygroundTests - der Bug haengt wahrscheinlich mit der Prozentrechnung zusammen
Bestaetigen, dass der Agent echten Projektkontext hat
Testen Sie nun, ob Xcode dem Agenten nuetzlichen Kontext gibt statt nur rohen Prompttext. Fragen Sie:
Before making changes, list the package target names and summarize the
current implementation of TipCalculator.total(amount:tipPercent:).
Wenn die Antwort mit dem tatsaechlichen Code uebereinstimmt, gibt Xcode erfolgreich Projektkontext weiter.
Sie sollten nun eine funktionierende Xcode-Konversation haben, die das geoeffnete Projekt sehen, Ihre Swift-Paketstruktur identifizieren und ueber den Bug-Standort nachdenken kann, bevor sie Code bearbeitet.
Schritt 4: MCP-basierten Kontext und Tools hinzufuegen
Hier wird der Workflow wirklich “agentisch” statt nur Chat mit Dateikontext. In diesem Schritt werden Sie Tool-Zugriff in GitHub einrichten und Xcodes MCP-basierte Xcode Tools aktivieren, damit der Agent mehr tun kann als Quelltext bearbeiten.
Eine Repository-Level-MCP-Konfiguration in GitHub hinzufuegen
Oeffnen Sie auf GitHub Ihr Repository und navigieren Sie zu:
Settings > Copilot > Coding agent
Finden Sie den MCP-Konfigurationsbereich und fuegen Sie eine minimale Konfiguration hinzu. Fuer ein erstes Setup ist eine Read-Only-GitHub-MCP-Konfiguration ein guter Startpunkt, weil sie den Scope eng haelt.
Verwenden Sie dieses JSON:
{
"mcpServers": {
"github-mcp-server": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/readonly",
"tools": ["*"],
"headers": {
"X-MCP-Toolsets": "repos,issues,pull_requests,actions,web_search"
}
}
}
}
Diese Konfiguration haelt den Server im Read-Only-Modus und beschraenkt den Zugriff auf eine Teilmenge der GitHub-Toolsets. Es ist nicht die engstmoegliche Konfiguration, aber ein praktischer erster Schritt fuer Lernen und Verifikation. Pruefen Sie GitHubs aktuelle MCP-Dokumentation fuer die neuesten Endpunkt-URLs und Konfigurationsoptionen, da sich diese aendern koennen.
Der GitHub Coding Agent kann MCP-Tools autonom verwenden. Exponieren Sie keine breiten schreibfaehigen Tools, bis Sie sicher sind, dass Scope und Genehmigungsflow korrekt sind.
Secrets nur hinzufuegen, wenn Ihr MCP-Server sie benoetigt
Einige MCP-Server benoetigen API-Keys oder Token. Erstellen Sie in GitHub ein Repository-Environment namens copilot und fuegen Sie Secrets oder Variablen mit dem Praefix COPILOT_MCP_ hinzu.
Zum Beispiel:
COPILOT_MCP_SENTRY_AUTH_TOKENCOPILOT_MCP_GITHUB_PERSONAL_ACCESS_TOKEN
Wenn Ihr Server zur Laufzeit zusaetzliche Abhaengigkeiten benoetigt, brauchen Sie moeglicherweise auch einen copilot-setup-steps.yml-Workflow, damit die Agentenumgebung sie installieren kann, bevor der Server gestartet wird.
Fuer dieses Tutorial koennen Sie das ueberspringen, es sei denn, Ihr MCP-Server erfordert benutzerdefiniertes Setup.
Xcode Tools fuer externe Agenten aktivieren
Gehen Sie in Xcode zurueck zu:
Xcode > Settings > Intelligence
Aktivieren Sie unter Model Context Protocol die Xcode Tools.
Diese Einstellung erlaubt es unterstuetzten externen Agenten, Xcode-Faehigkeiten ueber MCP zu nutzen. In der Praxis kann das Aktionen umfassen wie:
- das Projekt bauen
- Tests ausfuehren
- Diagnosen lesen
- Apple-Dokumentation durchsuchen, die relevant fuer den Code ist
MCP-gestuetzten Tool-Zugriff testen
Verwenden Sie zuerst einen Tool-orientierten Prompt in GitHub:
Using the available tools, summarize the open issues and pull requests
for this repository, then explain whether there is already a tracked
bug related to tip calculation. Do not make changes.
Verwenden Sie dann einen Tool-orientierten Prompt in Xcode:
Use Xcode tools to inspect the project, then tell me whether the
package builds cleanly right now and what would need to change to add
regression tests for TipCalculator.
Ein erfolgreiches Ergebnis wird normalerweise Tool-Aktivitaet, Projektinspektion, Build/Test-Kontext oder Dokumentations-Lookup erwaehnen, statt eine rein generische Antwort zu geben.
Sie sollten nun MCP-gestuetzte Tools in GitHub und Xcode funktionieren haben: GitHub ueber Repository-MCP-Konfiguration und Xcode ueber dem Coding-Produkt exponierte Xcode Tools.
Schritt 5: Einen echten Task ausfuehren
Jetzt, da die Infrastruktur steht, koennen Sie einen tatsaechlichen Agenten-Workflow ausfuehren. Der sicherste erste Task ist eng, testbar und einfach zu reviewen: einen einfachen Bug fixen und Regressionstests hinzufuegen.
Den Agenten bitten, die Architektur zu erklaeren, bevor er Code aendert
Beginnen Sie mit diesem Prompt in GitHub oder Xcode:
Before editing anything, explain the architecture of this package in
5 bullet points. Then propose the smallest safe change needed to fix
the tip calculation bug and the tests you would add.
Das ist ein unterschaetztes Muster. Es zwingt den Agenten, Verstaendnis zu demonstrieren, bevor er beginnt, Dateien zu aendern. Wenn die Erklaerung falsch ist, koennen Sie sie frueh korrigieren, statt spaeter einen breiten, niedrigqualitativen Diff zu reviewen.
Den GitHub Coding Agent bitten, den Bug zu fixen
Erstellen Sie ein Issue in GitHub mit einer eng gefassten Beschreibung:
Titel: Fix tip percentage calculation and add regression tests
Body:
The function `TipCalculator.total(amount:tipPercent:)` currently
calculates the tip incorrectly because the percentage math uses
integer division.
Please:
1. Fix the bug so `tipPercent = 15` on `amount = 100` returns `115.0`
2. Add focused regression tests for 0%, 15%, and 20%
3. Keep the change minimal
4. Do not add new dependencies
Weisen Sie das Issue dem Copilot Coding Agent zu oder starten Sie einen Agent-Task vom Agents-Tab mit derselben Anweisung.
Ein guter GitHub-Agent-Durchlauf sollte:
TipCalculator.swiftinspizieren- die Berechnung aktualisieren
- eine Testdatei erstellen
- einen Pull Request mit einer praegnanten Zusammenfassung oeffnen
Xcode agentisches Coding bitten, dasselbe lokal zu tun
Verwenden Sie in Xcode diesen Prompt:
Fix the bug in TipCalculator.total(amount:tipPercent:). Then add
XCTest regression tests for 0%, 15%, and 20%. Build or test the
package after your changes and summarize exactly what you changed.
Wenn Sie einen kleineren ersten Durchgang wollen, teilen Sie es in zwei Prompts auf:
- Nur den Bug fixen.
- Tests hinzufuegen und ausfuehren.
Das gibt Ihnen engere Kontrolle und macht den Diff einfacher zu reviewen.
Wie der korrigierte Code aussehen sollte
Eine korrekte Implementierung in Sources/AgentPlayground/TipCalculator.swift sollte funktional aequivalent zu diesem sein:
import Foundation
public enum TipCalculator {
public static func total(amount: Double, tipPercent: Int) -> Double {
let tip = amount * (Double(tipPercent) / 100.0)
return amount + tip
}
}
Und eine fokussierte Testdatei unter Tests/AgentPlaygroundTests/TipCalculatorTests.swift sollte so aussehen:
import XCTest
@testable import AgentPlayground
final class TipCalculatorTests: XCTestCase {
func testZeroPercentTip() {
XCTAssertEqual(TipCalculator.total(amount: 100.0, tipPercent: 0), 100.0, accuracy: 0.0001)
}
func testFifteenPercentTip() {
XCTAssertEqual(TipCalculator.total(amount: 100.0, tipPercent: 15), 115.0, accuracy: 0.0001)
}
func testTwentyPercentTip() {
XCTAssertEqual(TipCalculator.total(amount: 100.0, tipPercent: 20), 120.0, accuracy: 0.0001)
}
}
Der beste “erste echte Task” fuer einen Coding-Agenten ist kein Feature-Work. Es ist ein kleiner, reversibler Bug-Fix mit klaren Pass/Fail-Tests und minimaler architektonischer Ambiguitaet.
Sie sollten nun entweder einen GitHub Pull Request oder ein lokales Xcode-Changeset haben, das den Bug fixt und Regressionstests hinzufuegt.
Schritt 6: Ergebnisse ueberpruefen und validieren
Dieser Schritt ist der Ort, an dem der meiste Wert gewonnen oder verloren wird. Ein Coding-Agent, der Code produzieren kann, ist nuetzlich. Ein Entwickler, der diesen Code schnell validieren und formen kann, ist der Ort des echten Produktivitaetsgewinns.
Den Diff ueberpruefen, bevor Sie die Zusammenfassung lesen
Agent-Zusammenfassungen sind hilfreich, aber der Diff ist immer noch die Wahrheitsquelle. Pruefen Sie:
- Hat er nur
TipCalculator.swiftund die Testdatei beruehrt? - Hat er unnoetige Formatierungsaenderungen vermieden?
- Hat er Projekteinstellungen oder Abhaengigkeiten geaendert, ohne gefragt zu werden?
- Hat er Tests hinzugefuegt, die tatsaechlich zum Bug passen?
Wenn das Changeset breiter als erwartet ist, bitten Sie um eine engere Revision, statt alles selbst zu reparieren.
Tests lokal ausfuehren
Fuehren Sie aus dem Repository-Root aus:
swift test
Wenn Sie lieber ueber Xcodes Toolchain direkt validieren moechten, koennen Sie auch von der Kommandozeile bauen und testen:
xcodebuild test \
-scheme AgentPlayground \
-destination 'platform=macOS'
Fuer dieses Beispielpaket ist swift test die einfachste Bestaetigung.
Auf riskante Aenderungen pruefen
Wenn der Agent etwas ausserhalb des angeforderten Umfangs geaendert hat, ueberpruefen Sie diese Dateien sorgfaeltig. Das ist besonders wichtig, wenn der Durchlauf MCP-Tools, Build/Test-Automatisierung oder Drittanbieter-Kontextquellen involvierte.
Verwenden Sie diese Checkliste:
- Keine neue Abhaengigkeit wurde ohne Grund hinzugefuegt
- Kein Secret, Token oder Credential-Referenz wurde eingefuehrt
- Keine Projekteinstellungen wurden unerwartet geaendert
- Tests decken die beabsichtigte Regression ab
- Die Implementierung ist der minimale vernuenftige Fix
Bestandene Tests beweisen nicht, dass die Aenderung sicher ist. Sie beweisen nur, dass die getesteten Faelle bestehen. Ueberpruefen Sie auf Scope, Wartbarkeit und unbeabsichtigte Seiteneffekte.
Mit gezieltem Feedback iterieren
Wenn das Ergebnis nah, aber nicht merge-bereit ist, geben Sie praezise Anweisungen, statt von vorne zu beginnen. Zum Beispiel:
Keep the calculation fix, but rewrite the tests to be more explicit
and avoid repeated literal values. Do not modify production code.
Oder:
The bug fix is correct, but the diff is too broad. Revert unrelated
formatting changes and keep only the functional fix and regression tests.
Sie sollten nun ein validiertes Ergebnis haben: reviewter Diff, bestandene Tests und ein klares Verstaendnis dessen, was der Agent geaendert hat und warum.
Schritt 7: Leitplanken um die Nutzung setzen
Sobald der Workflow funktioniert, ist das naechste Ziel nicht “Agenten ueberall einsetzen.” Es ist, sie vorhersagbar nuetzlich zu machen. Gute Leitplanken machen Agenten zum Hebel. Schlechte oder fehlende Leitplanken machen sie zu Aufraeum-Arbeit.
Berechtigungen und Scope einschraenken
In GitHub:
- Repository-Zugriff auf die Repos beschraenken, die den Coding Agent tatsaechlich brauchen
- MCP-Server eng und schreibgeschuetzt halten, es sei denn, breiterer Zugriff ist gerechtfertigt
- Allowlisted Tools gegenueber weit offenen
*-Konfigurationen in der Produktion bevorzugen - MCP-Servern keine unnoetigeh Secrets geben
In Xcode:
- nur die Coding-Produkte aktivieren, die Sie tatsaechlich verwenden
- Tasks eng scopen
- vermeiden, dass der erste Prompt Architektur-Aenderungen, Abhaengigkeits-Aenderungen und Bug-Fixes in einem Schuss kombiniert
Einen benutzerdefinierten GitHub-Agenten fuer enge Bug-Fix-Arbeit erstellen
Ein benutzerdefinierter Agent ist eine gute Moeglichkeit, konsistentes Verhalten fuer repetitive Arbeit durchzusetzen. Erstellen Sie .github/agents/bugfix-ios.agent.md:
---
name: bugfix-ios
description: Specialized agent for narrow Swift bug fixes and regression tests
tools: ['read', 'search', 'edit']
---
You are a Swift maintenance agent.
Rules:
- Focus only on the files required to fix the requested bug.
- Prefer the smallest safe change.
- Add or update regression tests when behavior changes.
- Do not add dependencies.
- Do not change package configuration or build settings unless explicitly asked.
- Explain your plan before making broad edits.
- If the task is ambiguous, choose the most conservative implementation and note assumptions in the summary.
Das loest nicht jedes Qualitaetsproblem, macht aber das Standardverhalten vorhersagbarer.
Entscheiden, welche Tasks Agenten tun sollten und welche nicht
Gute Tasks fuer Coding-Agenten:
- fokussierte Bug-Fixes
- Tests hinzufuegen oder verschaerfen
- kleine Refactorings
- Dokumentations-Updates
- repetitive mechanische Aenderungen
- einen ersten Entwurf eines Features mit klaren Einschraenkungen generieren
Schlechte erste Kandidaten:
- Auth-Redesigns
- Billing- oder Geldbewegungs-Logik
- grosse Schema-Migrationen
- sicherheitssensible Rewrites
- Incident-Response-Aenderungen
- mehrdeutige Produktarbeit ohne Akzeptanzkriterien
Menschen in der Review-Schleife halten
Das Gewinnmuster ist nicht “Agent ersetzt Entwickler.” Es ist “Agent macht den ersten Durchgang, Mensch hat die Akzeptanz.” Das bedeutet:
- der Mensch definiert den Scope
- der Agent fuehrt aus
- der Mensch reviewt, testet und mergt
Die besten Teams halten die Merge-Entscheidung menschlich, selbst wenn die Aufgabe selbst stark automatisiert ist.
Sie sollten nun sowohl das technische Setup als auch die operationellen Leitplanken haben, die noetig sind, um MCP-gesteuerte Coding-Agenten nuetzlich zu machen, ohne sie auf alles loszulassen.
Haeufige Einrichtungsprobleme
Agent kann nicht auf das Projekt zugreifen
Symptome:
- Der GitHub-Agent kann nicht auf dem Repo starten
- Der Xcode-Agent gibt generische Antworten und kann keine Dateien identifizieren
- Das Repo fehlt in der Auswahl-UI
Wahrscheinliche Ursachen:
- GitHub Coding Agent ist fuer Ihren Plan, Ihre Organisation oder Ihr Repository deaktiviert
- Ihr Repository liegt ausserhalb der erlaubten Zugriffsliste
- In Xcode ist das Coding-Produkt nicht vollstaendig aktiviert oder authentifiziert
- Der falsche Ordner oder das falsche Projekt ist in Xcode geoeffnet
Loesung:
- In GitHub bestaetigen, dass der Coding Agent aktiviert ist und das Repository erlaubt ist
- In Xcode Xcode > Settings > Intelligence erneut oeffnen und das Produkt-Setup verifizieren
- Das tatsaechliche Projekt oder Paket-Root erneut oeffnen, nicht ein Elternverzeichnis
- Einen Read-Only-Prompt ausfuehren, der den Agenten bittet, Dateien zu benennen, bevor Sie ihn bitten, Code zu bearbeiten
MCP-Tool wird nicht erkannt
Symptome:
- GitHub akzeptiert die Konfiguration, aber das Tool erscheint nie in Logs
- Der Agent verhaelt sich, als waeren keine Tools verfuegbar
- Der Xcode-Agent kann nicht ueber Xcode-Tools bauen, testen oder Docs durchsuchen
Wahrscheinliche Ursachen:
- Ungueltiges JSON in den Repository-MCP-Einstellungen
- Fehlendes
COPILOT_MCP_-Secret oder Variable-Praefix - Der MCP-Server benoetigt Abhaengigkeiten oder Setup, das in der Agent-Umgebung nicht vorhanden ist
- Xcode Tools ist unter Model Context Protocol nicht aktiviert
Loesung:
- Das JSON sorgfaeltig auf Kommas, Anfuehrungszeichen und Objekt-Verschachtelung pruefen
- Bestaetigen, dass Secrets und Variablen das
COPILOT_MCP_-Praefix verwenden - Das Session-Log auf den Start MCP Servers-Schritt in GitHub pruefen
- In Xcode Xcode Tools erneut aktivieren und die Konversation neu starten
Kontext ist unvollstaendig
Symptome:
- Der Agent bearbeitet die falsche Datei
- Er beschreibt die Architektur falsch
- Er uebersieht offensichtliche Tests oder Module
Wahrscheinliche Ursachen:
- Ihr Prompt ist zu vage
- Die Repo-Struktur ist unklar
- Der Agent begann zu bearbeiten, bevor er Verstaendnis bewies
- Es gibt nicht genug explizite Einschraenkungen in der Aufgabe
Loesung:
Beginnen Sie mit einem Architektur-First-Prompt wie:
Before editing anything, summarize the package structure, identify the
exact files you plan to change, and explain why.
Folgen Sie dann mit dem Bearbeitungsauftrag erst, nachdem die Erklaerung korrekt ist.
Generierte Aenderungen sind zu breit
Symptome:
- Der Agent formatiert unzusammenhaengende Dateien um
- Er aendert Config, Paket- oder Build-Einstellungen ohne Aufforderung
- Der Pull Request ist viel groesser als das Problem
Wahrscheinliche Ursachen:
- Der Task war unterspezifiziert
- Der Agent hatte zu viel Freiheit
- Die Anweisung definierte nicht, was nicht beruehrt werden soll
Loesung:
Verwenden Sie engere Prompts:
Fix only the bug in TipCalculator.total(amount:tipPercent:). Add
regression tests. Do not change dependencies, formatting outside
edited files, or package configuration.
Falls noetig, erstellen Sie einen benutzerdefinierten Agenten mit expliziten Scope-Regeln und verwenden Sie diesen statt des Standard-Agenten.
Zusammenfassung
Sie haben nun ein funktionierendes Cross-Tool-Setup fuer MCP-gesteuerte Coding-Agenten in GitHub Copilot und Xcode. Sie haben den GitHub Coding Agent aktiviert, Xcode agentisches Coding konfiguriert, MCP-gestuetzten Tool-Zugriff eingeschaltet, einen echten Bug-Fix-Task ausgefuehrt und das Ergebnis mit Tests und Diff-Review validiert.
Die naechsten nuetzlichen Dinge zum Automatisieren sind klein und repetitiv: Regressionstests, Dokumentations-Updates, enge Refactorings und Issue-getriebene Bug-Fixes. Sobald diese zuverlaessig sind, fuegen Sie benutzerdefinierte Agenten und spezifischere MCP-Server hinzu, damit der Workflow schaerfer statt breiter wird.
Als Faustregel: Verwenden Sie einen Agenten fuer einen eng gescopteten Task, der in einer einzigen reviewten Aenderung enden sollte. Verwenden Sie mehrere Agenten oder Produkte, wenn Sie Ansaetze vergleichen moechten, explorative lokale Arbeit von Repository-PR-Arbeit trennen oder einen Agenten fuer Tests und einen anderen fuer die Implementierung spezialisieren moechten. Der Grund, dies jetzt zu tun, ist einfach: Die GitHub- und Xcode-Teile sind nah genug am echten Entwicklungsflow, dass die Zeit fuer das Setup sich endlich in der taeglichen Arbeit auszahlen kann, statt eine Neuheit zu bleiben.
Verwandte Artikel
GitHub Copilot Coding Agent mit MCP-Tools erweitern
Erfahren Sie, wie Sie den GitHub Copilot Coding Agent mit MCP-Tools erweitern, externen Kontext verbinden, Tool-Nutzung validieren und Berechtigungen sicher halten.
Einen benutzerdefinierten MCP-Server erstellen, absichern und deployen: Von der Tool-Definition bis zur Produktion
Schritt-fuer-Schritt-Tutorial zum Erstellen eines MCP-Servers jenseits von Hello-World mit PostgreSQL, Authentifizierung, Query-Sandboxing und Docker-Deployment.
AI-Coding-Agent-Pipelines absichern: Sandbox-Konfiguration, Berechtigungsgrenzen und automatisierte Review-Gates
Erfahren Sie, wie Sie AI-Coding-Agent-Pipelines mit Erkennung, Policy-as-Code, Sicherheitsscans, Sandbox-Testausfuehrung, risikogestuften Review-Gates und Audit-Logging absichern.