Skip to main content
Glama

Subdomain oder Weiterleitung anlegen

add_domain

Legt für das Hostingpaket (hauptdomain = die Domain des Pakets) eine Subdomain oder eine Weiterleitung von einer Domain bei einem anderen Anbieter an. Drei Arten (art): "alias" = Weiterleitung einer Domain, die der Kunde bei einem ANDEREN Anbieter registriert hat (z. B. IONOS oder Strato): sie leitet dauerhaft (301) auf die Hauptdomain des Pakets weiter; das SSL-Zertifikat wird nach dem Anlegen ausgestellt, sobald alle autoritativen Nameserver der jeweiligen Domain den Namen liefern (bei einer Subdomain die der Hauptdomain, bei einem Alias die der Domain selbst, nicht die des Pakets). Meldet die Antwort zertifikat_folgt (oder nicht ausdrücklich, dass das Zertifikat ausgestellt ist), ist es noch nicht da: es wird automatisch nachgeholt (Wiederholung alle paar Minuten bis 48 Stunden nach dem Anlegen), und aktion "pruefen" auf den angelegten Namen stellt auch ein noch offenes Zertifikat aus (im Panel: Knopf "Zertifikat ausstellen"; das gilt auch für Subdomains). Die Weiterleitung wird erst aktiviert, wenn die A-/AAAA-Einträge für @ und www auf den Server des Pakets zeigen: bis dahin ist der Zustand "wartet_dns", und die Antwort nennt die Einträge, die der Kunde beim DNS-Anbieter setzen muss (und AAAA-Einträge, die er entfernen muss). Es gibt keinen Hintergrundjob für wartende Domains: Hat der Kunde das DNS geändert, muss mit aktion "pruefen" erneut aufgerufen werden, erst dann wird die Weiterleitung angelegt und das Zertifikat ausgestellt. Wartende Domains verfallen nach 30 Tagen (der Eintrag wird entfernt, die Domain lässt sich danach neu hinzufügen); "pruefen" verlängert die Frist nicht. Zeigt die neue Domain richtig, ein anderer Alias des Pakets aber nicht, nennt die Antwort diesen Alias: der Zustand bleibt "wartet_dns", bis der Kunde ihn in Ordnung bringt oder entfernt. "sub_website" = Subdomain mit eigener Website: ihre Dateien liegen im Ordner neben httpdocs (der Ordner heißt immer wie die Subdomain und lässt sich nicht frei wählen); bis zum Hochladen steht dort eine Platzhalterseite, der Zugriff läuft über FTP/SFTP/SSH des Hauptzugangs. Nur wenn die App einen eigenen Ordner ausliefert (z. B. public bei Laravel/Symfony oder dist bei Vite), gibt es den optionalen Parameter unterordner (relativ unter , z. B. public); aktion "pfad" ändert ihn später (der alte Ordner bleibt bestehen). Das Zertifikat der Subdomain folgt automatisch, sobald sie überall im DNS angekommen ist (meist innerhalb von 15 Minuten). "sub_weiterleitung" = Subdomain, die per 301 auf eine URL (ziel) weiterleitet. Domains, die dem Kunden bei turbopress gehören, legt dieses Werkzeug nicht an: für sie gibt es im Panel unter "Weiterleitungen" → "Weiterleitung anlegen" den Weg "Eine deiner turbopress-Domains" (im Chat: redirect_domain; Domains ohne eigenes Paket werden dabei dem Paket zugeordnet); die Hauptdomain eines anderen Pakets desselben Kunden wird mit dz_eigenes_paket abgelehnt; Domains anderer werden abgelehnt. Im Panel-Chat braucht jeder Aufruf den Bestätigungsklick des Kunden (dann wurde noch nichts ausgeführt). Höchstens 10 Hinzufügungen pro Tag. Die Antwort (Zustand, DNS-Einträge, Zugang) wörtlich weitergeben; nur dann Erfolg melden, wenn sie ihn meldet. Entfernen: remove_added_domain.

Input Schema

NameRequiredDescriptionDefault
artNoPflicht bei hinzufuegen: alias (Weiterleitung einer Domain von einem anderen Anbieter, 301 auf die Hauptdomain), sub_website (Subdomain mit eigener Website) oder sub_weiterleitung (Subdomain, 301 auf eine URL)
pfadNoVeraltet, nur noch Alt-Name für unterordner: gilt nur mit der Vorsilbe <fqdn>/ (z. B. shop.example.de/public wird zu unterordner public); jeden anderen Ordnerpfad gibt es nicht mehr. Besser unterordner verwenden
zielNoPflicht bei sub_weiterleitung: die URL, auf die per 301 weitergeleitet wird
labelNoBei Subdomains: nur der Teil vor der Hauptdomain, z. B. "shop" für shop.example.de
aktionNoStandard hinzufuegen. pruefen = DNS einer wartenden Alias-Domain erneut prüfen und/oder ein offenes Zertifikat einer angelegten Domain oder Subdomain nachholen (domain angeben, bei einer Subdomain der volle Name); pfad = Unterordner einer sub_website ändern (domain = vollständiger Name der Subdomain + unterordner, leer = der Ordner der Subdomain selbst)
domainNoBei alias und pruefen: die weiterzuleitende Domain bei einem anderen Anbieter, z. B. andere.de (bei pruefen auch der volle Name einer hinzugefügten Subdomain). Bei aktion pfad: der vollständige Name der Subdomain, z. B. shop.example.de
hauptdomainYesDie Domain des Hostingpakets, z. B. example.de
unterordnerNoOptional bei sub_website, nur wenn die App einen eigenen Ordner ausliefert: öffentlicher Unterordner relativ unter dem Ordner <fqdn> der Subdomain, z. B. public oder dist (leer = der Ordner <fqdn> selbst). Pflichtangabe bei aktion pfad (leer erlaubt)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • changedInput schema / properties / aktion / description
      Previous value: -"Standard hinzufuegen. pruefen = DNS einer wartenden Alias-Domain erneut prüfen und/oder ein offenes Zertifikat einer angelegten Domain oder Subdomain nachholen (domain angeben, bei einer Subdomain der volle Name); pfad = Dokumentstamm einer sub_website ändern (domain = vollständiger Name der Subdomain + pfad)"New value: +"Standard hinzufuegen. pruefen = DNS einer wartenden Alias-Domain erneut prüfen und/oder ein offenes Zertifikat einer angelegten Domain oder Subdomain nachholen (domain angeben, bei einer Subdomain der volle Name); pfad = Unterordner einer sub_website ändern (domain = vollständiger Name der Subdomain + unterordner, leer = der Ordner der Subdomain selbst)"
    • changedInput schema / properties / art / description
      Previous value: -"Pflicht bei hinzufuegen: alias (301 auf die Hauptdomain), sub_website (Subdomain mit eigenem Ordner) oder sub_weiterleitung (Subdomain, 301 auf eine URL)"New value: +"Pflicht bei hinzufuegen: alias (Weiterleitung einer Domain von einem anderen Anbieter, 301 auf die Hauptdomain), sub_website (Subdomain mit eigener Website) oder sub_weiterleitung (Subdomain, 301 auf eine URL)"
    • changedInput schema / properties / domain / description
      Previous value: -"Bei alias und pruefen: die Alias-Domain, z. B. andere.de (bei pruefen auch der volle Name einer hinzugefügten Subdomain). Bei aktion pfad: der vollständige Name der Subdomain, z. B. shop.example.de"New value: +"Bei alias und pruefen: die weiterzuleitende Domain bei einem anderen Anbieter, z. B. andere.de (bei pruefen auch der volle Name einer hinzugefügten Subdomain). Bei aktion pfad: der vollständige Name der Subdomain, z. B. shop.example.de"
    • changedInput schema / properties / pfad / description
      Previous value: -"Dokumentstamm der sub_website, relativ zum Paket und ohne führenden Schrägstrich, z. B. shop.example.de/public (Standard <fqdn>); Pflicht bei aktion pfad"New value: +"Veraltet, nur noch Alt-Name für unterordner: gilt nur mit der Vorsilbe <fqdn>/ (z. B. shop.example.de/public wird zu unterordner public); jeden anderen Ordnerpfad gibt es nicht mehr. Besser unterordner verwenden"
    • addedInput schema / properties / unterordner
      Added value: +{
      +  "description": "Optional bei sub_website, nur wenn die App einen eigenen Ordner ausliefert: öffentlicher Unterordner relativ unter dem Ordner <fqdn> der Subdomain, z. B. public oder dist (leer = der Ordner <fqdn> selbst). Pflichtangabe bei aktion pfad (leer erlaubt)",
      +  "type": "string"
      +}
  2. Changed2 schema fields changed
    • changedInput schema / properties / aktion / description
      Previous value: -"Standard hinzufuegen. pruefen = DNS einer wartenden Alias-Domain erneut prüfen (domain angeben); pfad = Dokumentstamm einer sub_website ändern (domain = vollständiger Name der Subdomain + pfad)"New value: +"Standard hinzufuegen. pruefen = DNS einer wartenden Alias-Domain erneut prüfen und/oder ein offenes Zertifikat einer angelegten Domain oder Subdomain nachholen (domain angeben, bei einer Subdomain der volle Name); pfad = Dokumentstamm einer sub_website ändern (domain = vollständiger Name der Subdomain + pfad)"
    • changedInput schema / properties / domain / description
      Previous value: -"Bei alias und pruefen: die Alias-Domain, z. B. andere.de. Bei aktion pfad: der vollständige Name der Subdomain, z. B. shop.example.de"New value: +"Bei alias und pruefen: die Alias-Domain, z. B. andere.de (bei pruefen auch der volle Name einer hinzugefügten Subdomain). Bei aktion pfad: der vollständige Name der Subdomain, z. B. shop.example.de"
  3. Added

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=false, destructiveHint=false, openWorldHint=true and idempotentHint=false, but the description adds substantial behavioural context: a mandatory confirmation click in the panel chat, a 10-additions-per-day limit, no background job for waiting domains, a 30-day expiry, and the exact DNS/SSL waiting semantics. It also tells the agent to pass the response verbatim and only report success when the response does.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded in the first sentence, and the length is justified by the tool's state machine and DNS/SSL edge cases. The body is a dense single block rather than structured sections, and some certificate/DNS points are repeated, so it is not maximally concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, and the description compensates by explaining expected response states (wartet_dns, zertifikat_folgt), DNS entries to set or remove, what aktion 'pruefen' does, and how the agent should handle the returned response. For an 8-parameter, multi-mode mutation tool, this covers what an agent needs in order to call and interpret it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all eight parameters. The description still adds useful semantics: it explains the meaning of the three art values in operational terms, clarifies that pfad is deprecated in favour of unterordner, and describes when aktion 'pruefen' or 'pfad' applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence names a specific verb and resource (legt ... eine Subdomain oder eine Weiterleitung ... an) and immediately scopes it to the hosting package. It distinguishes the three creation modes and explicitly names sibling alternatives (redirect_domain, remove_added_domain), so an agent can separate it from neighbouring tools without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It states when to use the tool and clear exclusions: turbopress-owned domains go to redirect_domain, another package's main domain is rejected with dz_eigenes_paket, and foreign domains are rejected. It also gives the when-to-use condition for aktion 'pruefen' and the removal path via remove_added_domain.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources