Domain-Weiterleitungen (Redirect-Domains) — MCP-Plan
Status: Phase 1 live (FB-8FNRZSUX) — Vercel-Redirect per AgencyOS/MCP; Phasen 2–4 offen.
Was
Center haben oft mehrere Domain-Varianten (Apex, www, .de/.com), die per 308 auf die Primärdomain zeigen sollen — zusätzlich zur eigentlichen Website-Domain in Vercel.
Warum
cockpit_go_live_domain/cockpit_publish_website_liveregistrieren Domains als Center-Domains (Traffic aufs Projekt), nicht als Redirect-only.- United-Domains-Web-Forwards sind in
cockpit_ud_accountnur lesbar (QueryWebFwdList), nicht schreibbar. - Reine Vercel-Redirects über externen MCP scheitern oft an Team/Projekt-Kontext (404).
Wer ist betroffen
Center-Betrieb, Dev/Agenten (Go-Live, MCP), IT (UD + Vercel).
Zielbild (Phasen)
| Phase | Lieferung | Risiko |
|---|---|---|
| 1 | ✅ Vercel: addProjectDomain mit redirect + redirectStatusCode (308); AgencyOS POST …/domain-redirects; MCP cockpit_add_domain_redirect | Mittel — falsches Projekt/Team |
| 2 | Center-Metadaten: redirectDomains[] in DB/Config (Quelle, Ziel, Status) + Anzeige im Dashboard Domains-Reiter | Niedrig |
| 3 | UD: HEXONET/Web-Forward Set-Befehl (sofern API verfügbar) oder manueller Runbook-Schritt mit geplanten DNS-Zielen | Hoch — DNS-Fehler |
| 4 | Orchestrierung wie Go-Live: DNS erst nach Vercel-Redirect bestätigt | Hoch |
API-Skizze (Phase 1)
POST /api/agencyos/v1/centers/{centerId}/domain-redirects
{
"domain": "durlach-center.de",
"redirectTo": "www.durlachcenter.de",
"statusCode": 308,
"dryRun": true
}
Voraussetzungen: VERCEL_API_TOKEN, aufgelöstes Vercel-Projekt (resolveVercelProjectId), Primärdomain bereits am Projekt.
So testen (wenn Phase 1 live)
- Shadow-Center mit bekanntem Vercel-Projekt wählen.
dryRun=true— geplante Vercel-Payload prüfen.dryRun=false— Domain in Vercel als Redirect anlegen,GETDomain-Config prüfen.- Erst danach UD-DNS auf Vercel zeigen lassen (Phase 3).
Betrieb
- Env wie Go-Live:
VERCEL_API_TOKEN, UD-Reselling-Variablen (siehe Hosting-Doku). - Kein automatisches DNS-Umstellen in Phase 1.
Links
- AgencyOS-Integration (UD inspect)
- Go-Live:
domain-go-live.ts,vercel-api.ts
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/domain-redirect-mcp-plan