Zum Inhalt springen
Zurück zu Tutorials

MCP-gesteuerte Coding-Agenten in GitHub Copilot und Xcode einrichten

Fortgeschritten · 45 minutes · 19 Min. Lesezeit · Byte Smith ·

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
1
2
3
4
5
6
7
8
9
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.

Info

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:

  1. Oeffnen Sie die GitHub Copilot-Einstellungen.
  2. Bestaetigen Sie, dass der Coding Agent fuer Ihr Konto oder Ihre Organisation aktiviert ist.
  3. Bestaetigen Sie, dass Ihr Ziel-Repository im Repository-Zugriff enthalten ist.
  4. Oeffnen Sie das Repository und suchen Sie nach dem Agents-Tab oder verwenden Sie die globale Agenten-Seite.
Hinweis

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.

Tipp

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.

Warnung

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_TOKEN
  • COPILOT_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.swift inspizieren
  • 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:

  1. Nur den Bug fixen.
  2. 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)
    }
}
Tipp

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.swift und 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
Warnung

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:

  1. In GitHub bestaetigen, dass der Coding Agent aktiviert ist und das Repository erlaubt ist
  2. In Xcode Xcode > Settings > Intelligence erneut oeffnen und das Produkt-Setup verifizieren
  3. Das tatsaechliche Projekt oder Paket-Root erneut oeffnen, nicht ein Elternverzeichnis
  4. 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:

  1. Das JSON sorgfaeltig auf Kommas, Anfuehrungszeichen und Objekt-Verschachtelung pruefen
  2. Bestaetigen, dass Secrets und Variablen das COPILOT_MCP_-Praefix verwenden
  3. Das Session-Log auf den Start MCP Servers-Schritt in GitHub pruefen
  4. 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.