# Fix ausliefern und Vercel-Deploy prüfen

> Ein Bugfix heißt: Editor, GitHub und Deploy-Logs ständig wechseln.

Dieses Setup richtet sich an Entwickler, die auf Vercel deployen und einen Bug vom Fix bis zur geprüften Preview vom Agenten begleiten lassen wollen. Der Agent in Claude Code oder Cursor ändert den Code, öffnet einen Pull Request auf GitHub und liest anschließend das Preview-Deployment und die Build-Logs auf Vercel. Am Ende haben Sie einen Pull Request mit geprüftem Preview-Link, und die Entscheidung zum Mergen bleibt bei Ihnen.

## Schritte

1. **GitHub verbinden**: Verbinden Sie den GitHub-MCP-Server per OAuth oder mit einem Fine-grained Personal Access Token, beschränkt auf die Repositories, an denen Sie arbeiten. Erlauben Sie das Lesen von Code, Pushen auf Branches und Öffnen von Pull Requests. Schützen Sie den main-Branch in GitHub, damit Änderungen nur über einen geprüften Pull Request hineinkommen.
   Tipp: Der Branch-Schutz auf main ist die eigentliche Absicherung, unabhängig davon, was das Token erlaubt.
2. **Vercel verbinden**: Fügen Sie den MCP-Server von Vercel hinzu und melden Sie sich per OAuth mit Ihrem Vercel-Konto an. Lassen Sie den Agenten Ihre Projekte und die letzten Deployments dieses Repositorys auflisten, um den Zugriff zu prüfen. Danach kann er Status und Build-Logs der Preview lesen, die jeder Pull Request erzeugt.
   Tipp: Nennen Sie das Projekt beim Namen, wenn Ihr Team viele Vercel-Projekte hat.
3. **Preview prüfen**: Sobald der Pull Request offen ist, lassen Sie den Agenten auf das Preview-Deployment warten, die Build-Logs lesen und Fehler oder Warnungen melden. Öffnen Sie die Preview-URL selbst und testen Sie den Fix im Browser. Mergen Sie erst, wenn der Build grün ist und der Fix funktioniert.
   Tipp: Ist die Preview geschützt, kann der Agent die Seite eventuell nicht laden; prüfen Sie sie im eigenen Browser.

## Prompts zum Ausprobieren

- Behebe den Bug, bei dem die Warenkorbsumme Rabattcodes ignoriert, pushe auf einen neuen Branch und öffne einen Pull Request.
- Prüfe die Vercel-Preview zu diesem Pull Request und sag mir, ob und warum der Build fehlgeschlagen ist.
- Lies die Build-Logs des letzten fehlgeschlagenen Deployments im Projekt storefront und schlage einen Fix vor.
- Vergleiche die Build-Warnungen der Preview mit dem letzten Produktions-Deployment.
- Schreib eine kurze Pull-Request-Beschreibung mit Bug, Fix und Testanleitung für die Preview.

## Was Sie brauchen

- GitHub-Repository, das mit einem Vercel-Projekt verbunden ist
- Vercel-Konto mit Zugriff auf dieses Projekt
- Claude Code oder Cursor
- Branch-Schutz auf dem Produktions-Branch

## Grenzen

- Der Agent liest Build-Logs und Deployment-Status; im Browser testet er Ihre App nicht von selbst.
- Geschützte Preview-Deployments können automatische Seitenprüfungen blockieren.
- Laufzeitfehler, die nur unter echtem Traffic auftreten, zeigt eine Preview nicht.

## Sicherheitshinweise

- Dem Agenten nie Merge-Rechte geben.
- Vercel-Zugriff ist schreibgeschützt.

## MCP-Server

- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write
- [Vercel MCP Server](https://vercel.com/docs/mcp): project-read, deployment-read, logs-read

## Häufige Fragen

**Kann der Agent in Produktion deployen?**

Auf Vercel entsteht ein Produktions-Deployment normalerweise beim Merge in den Produktions-Branch, und das Mergen bleibt in diesem Setup bei Ihnen. Lassen Sie den Branch-Schutz aktiv und geben Sie dem Agenten keine Merge-Rechte.

**Brauche ich einen kostenpflichtigen Vercel-Plan?**

Der Vercel-MCP-Server funktioniert mit Ihrem bestehenden Konto, und Preview-Deployments gibt es auch im Hobby-Plan. Team-Funktionen und die Aufbewahrung mancher Logs hängen vom Plan ab; Details stehen auf der Vercel-Preisseite.

**Claude Code oder Cursor?**

Beide können Code ändern und MCP-Server aufrufen. Claude Code passt zur Arbeit im Terminal und kann Tests und git-Befehle ausführen; Cursor eignet sich, wenn Sie Änderungen lieber im Editor verfolgen.

**Was, wenn der Build grün ist, der Fix aber falsch?**

Ein grüner Build zeigt nur, dass der Code kompiliert und deployt wurde. Testen Sie die Preview selbst oder lassen Sie den Agenten vor dem Merge einen Test schreiben, der den Bug nachstellt.

## Tools

- **[GitHub](https://suiteintent.com/t/github?m=DE)**: Code-Hosting, Issues und Pull Requests. · Ideal für: Teams mit Code-Review per Pull Request · Gratis-Tarif · 10000
- **[Vercel](https://suiteintent.com/t/vercel?m=DE)**: Hosting, das Web-Apps direkt aus Git deployt. · Ideal für: Preview-Links bei jedem Push fürs Team · Gratis-Tarif · 30000
