Skip to main content

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_live registrieren Domains als Center-Domains (Traffic aufs Projekt), nicht als Redirect-only.
  • United-Domains-Web-Forwards sind in cockpit_ud_account nur 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)​

PhaseLieferungRisiko
1✅ Vercel: addProjectDomain mit redirect + redirectStatusCode (308); AgencyOS POST …/domain-redirects; MCP cockpit_add_domain_redirectMittel — falsches Projekt/Team
2Center-Metadaten: redirectDomains[] in DB/Config (Quelle, Ziel, Status) + Anzeige im Dashboard Domains-ReiterNiedrig
3UD: HEXONET/Web-Forward Set-Befehl (sofern API verfügbar) oder manueller Runbook-Schritt mit geplanten DNS-ZielenHoch — DNS-Fehler
4Orchestrierung wie Go-Live: DNS erst nach Vercel-Redirect bestätigtHoch

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)​

  1. Shadow-Center mit bekanntem Vercel-Projekt wählen.
  2. dryRun=true — geplante Vercel-Payload prüfen.
  3. dryRun=false — Domain in Vercel als Redirect anlegen, GET Domain-Config prüfen.
  4. 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.

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/developer-guide/domain-redirect-mcp-plan