Spaceship MCP Connector verbindet Ihren KI-Assistenten (z. B. Claude) mit Ihrem Spaceship-Konto. Darüber kann der Assistent die Domain-Verfügbarkeit und Preise prüfen, Domain-Kontakte und Nameserver verwalten sowie DNS-Einträge in Ihrem Namen lesen oder bearbeiten — Sie fragen einfach in natürlicher Sprache, und der Assistent ruft die richtigen Tools auf.
Spaceship MCP Connector kauft keine Domains. Der Assistent kann prüfen, ob ein Name verfügbar ist und was er kostet, aber der Kauf selbst erfolgt auf spaceship.com.
Sie benötigen ein Spaceship-Konto. Spaceship MCP Connector ist unter https://connector-mcp.spaceship.com/mcp verfügbar.
Claude (Web und Desktop) — öffnen Sie die Einstellungen, wählen Sie Connectors, suchen Sie Spaceship im Connector-Verzeichnis und fügen Sie es hinzu. Claude von Anthropic ist derzeit der Client, mit dem wir die Funktion des Spaceship MCP Connector verifiziert haben.
Andere MCP-Clients — fügen Sie einen Remote-MCP-Server hinzu und verweisen Sie ihn auf https://connector-mcp.spaceship.com/mcp. Andere Clients funktionieren möglicherweise, aber wir haben sie noch nicht verifiziert.
Wenn Sie eine Verbindung herstellen, werden Sie aufgefordert, sich bei Spaceship anzumelden und dem Assistenten Zugriff auf Ihr Konto zu gewähren. Welche Tools der Assistent verwenden kann, hängt von dem Zugriff ab, den Sie genehmigen — wenn ein Tool abgelehnt wird, weil kein Zugriff gewährt wurde, stellen Sie die Verbindung erneut her und genehmigen Sie den benötigten Zugriff.
Tool: contacts_save
Funktion: Kontaktdaten speichern und eine Kontakt-ID erhalten
Tool: contacts_get
Funktion: Einen gespeicherten Kontakt anhand seiner ID lesen
Tool: contacts_list
Funktion: Alle gespeicherten Kontakte auflisten, um einen zu finden und wiederzuverwenden
Tool: domains_list
Funktion: Ihre Domains auflisten oder eine einzelne Domain nachschlagen
Tool: domains_check_availability
Funktion: Prüfen, ob Domains zur Registrierung verfügbar sind, und ihren Preis
Tool: domain_set_contacts
Funktion: Kontakte einer Domain zuweisen, die Ihnen gehört
Tool: domain_set_nameservers
Funktion: Eine Domain auf grundlegende oder benutzerdefinierte Nameserver umstellen
Tool: dns_records_get
Funktion: DNS-Einträge für eine Domain lesen
Tool: dns_records_save
Funktion: DNS-Einträge hinzufügen oder ihre TTL aktualisieren
Tool: dns_records_delete
Funktion: DNS-Einträge löschen
Tool: async_operation_get
Funktion: Den Status eines lang laufenden Vorgangs prüfen
Keines dieser Tools belastet Ihr Konto.
Wo immer ein Kontakt erforderlich ist (domain_set_contacts), nimmt jede Rolle eine contactId-Zeichenfolge entgegen — niemals Inline-Kontaktdaten. Speichern Sie den Kontakt zuerst mit contacts_save (das seine contactId zurückgibt) und übergeben Sie dann diese ID dort, wo der Kontakt akzeptiert wird. Es gibt kein automatisches Inline-Speichern; eine Rolle kann kein vollständiges Kontaktobjekt erhalten. Sie können auch eine contactId aus einem contacts_list-Ergebnis oder eine verwenden, die Sie aus einem domains_list-Ergebnis entnehmen.
Eine contactId ist eine Zeichenfolge aus 27–32 alphanumerischen Zeichen. Geben Sie sie einfach dort zurück, wo ein Kontakt akzeptiert wird.
Mehrere Tools sind dafür ausgelegt, zusammen verwendet zu werden: Die Ausgabe des einen wird zur Eingabe des nächsten.
domains_check_availability — prüfen Sie die gewünschten Namen. Jeder verfügbare Name enthält den USD-price zum Registrieren (sowohl Standard als auch Premium) oder priceUnavailableReason, wenn er nicht bestimmt werden kann, sowie minRegisterPeriodInYears und maxRegisterPeriodInYears — die Laufzeiten, die die TLD erlaubt. Beachten Sie, dass priceprice.pricedYears Jahre abdeckt, was die kürzeste von der TLD erlaubte Laufzeit ist und nicht immer 1 beträgt.
Kaufen Sie sie auf spaceship.com. Kein Tool registriert eine Domain oder erzeugt einen Checkout-Link, daher kann der Assistent den Kauf nicht abschließen oder sagen, dass eine Domain aus dem Gespräch heraus registriert wurde. Sobald der Kauf abgeschlossen ist, zeigt domains_list die neue Domain an.
domain_set_contacts — weisen Sie der Domain Kontakte per contactId zu (speichern Sie sie bei Bedarf zuerst mit contacts_save). Dies wird sofort abgeschlossen und gibt einen verificationStatus zurück: verification bedeutet, dass der Registrant seine E-Mail-Adresse bestätigen muss, bevor die Änderung vollständig wirksam wird (eine E-Mail wird an ihn gesendet), success bedeutet, dass sie bereits bestätigt ist, und null bedeutet, dass für diese Domain keine Bestätigung erforderlich ist.
domains_list — suchen Sie die Domain und sehen Sie ihre aktuellen nameservers ({ provider, hosts }).
domain_set_nameservers — wechseln Sie zu den Standard-Nameservern von Spaceship mit provider: "basic" (ohne hosts) oder verweisen Sie mit provider: "custom" und einer Liste von 2–12 hosts auf Ihre eigenen. Es gibt die resultierenden { provider, hosts } zurück, und ein nachfolgendes domains_list zeigt die Änderung an. Das erneute Anwenden eines Zustands, in dem sich eine Domain bereits befindet, gibt einen Validierungsfehler statt eines No-Op zurück — behandeln Sie das als erwartet, nicht als Fehlschlag, der erneut versucht werden muss.
domains_list — suchen Sie die Domain, die Sie verwalten möchten (oder übergeben Sie ihren Namen direkt, wenn Sie ihn kennen).
dns_records_get — lesen Sie die aktuellen Einträge für die Domain.
dns_records_save oder dns_records_delete — Einträge hinzufügen, aktualisieren oder entfernen. Von dns_records_get zurückgegebene Einträge haben dieselbe Form, die die Tools zum Speichern und Löschen akzeptieren (beim Löschen wird ttl einfach weggelassen), sodass der Assistent sie lesen, anpassen und zurückschreiben kann. Der Abgleich erfolgt ohne Beachtung der Groß-/Kleinschreibung, außer bei TXT-Einträgen, bei denen die Groß-/Kleinschreibung beachtet wird.
domains_list — blättern Sie mit Sortierung durch alle Ihre Domains oder rufen Sie eine einzelne Domain nach Namen ab. Jede Domain enthält ihr Ablaufdatum, die Einstellung für automatische Verlängerung, den Status, Nameserver, Datenschutz und zugewiesene Kontakt-IDs.
contacts_list — blättern Sie durch alle in Ihrem Konto gespeicherten Kontakte, um einen vorhandenen zu finden und wiederzuverwenden (über seine Kontakt-ID), anstatt ein Duplikat zu erstellen.
contacts_get — schlagen Sie die Details hinter jeder Kontakt-ID nach, die Sie bei einer Domain oder in einem contacts_list-Ergebnis sehen.
Jedes Tool gibt sein Ergebnis als strukturiertes JSON zurück, und jedes Tool wird sofort abgeschlossen.
Kontakte sind die Personen oder Organisationen, die mit einer Domainregistrierung verknüpft sind (Registrant, Admin, Technik, Abrechnung). Ein Kontakt wird überall über seine Kontakt-ID referenziert — eine undurchsichtige Zeichenfolge.
contacts_save — Kontakt speichernSpeichert Kontaktdaten und gibt die generierte Kontakt-ID zurück. Die Validierung einiger Felder (wie stateProvince und postalCode) hängt vom ausgewählten Land ab.
Parameter: firstName
Erforderlich: Ja
Typ & Einschränkungen: Zeichenfolge, 1–64 Zeichen. Darf Bindestriche und Apostrophe enthalten.
Parameter: lastName
Erforderlich: Ja
Typ & Einschränkungen: Zeichenfolge, 1–64 Zeichen. Darf Bindestriche und Apostrophe enthalten.
Parameter: email
Erforderlich: Ja
Typ & Einschränkungen: Gültige E-Mail-Adresse, max. 254 Zeichen.
Parameter: address1
Erforderlich: Ja
Typ & Einschränkungen: Adresszeile 1. Zeichenfolge, 1–128 Zeichen.
Parameter: city
Erforderlich: Ja
Typ & Einschränkungen: Zeichenfolge, 1–64 Zeichen.
Parameter: country
Erforderlich: Ja
Typ & Einschränkungen: Ländercode mit zwei Buchstaben (ISO 3166-1 alpha-2), z. B. US.
Parameter: phone
Erforderlich: Ja
Typ & Einschränkungen: Internationales Format +CountryCode.Number, z. B. +1.2025551234. Max. 32 Zeichen.
Parameter: organization
Erforderlich: Nein
Typ & Einschränkungen: Name der Organisation/Firma. 1–128 Zeichen.
Parameter: address2
Erforderlich: Nein
Typ & Einschränkungen: Adresszeile 2. 1–128 Zeichen.
Parameter: stateProvince
Erforderlich: Nein
Typ & Einschränkungen: Name des Bundeslands/der Provinz, 1–64 Zeichen. Kann je nach Land erforderlich sein.
Parameter: postalCode
Erforderlich: Nein
Typ & Einschränkungen: 1–16 Zeichen. Kann je nach Land erforderlich sein.
Parameter: phoneExt
Erforderlich: Nein
Typ & Einschränkungen: Telefondurchwahl, 1–16 Zeichen.
Parameter: fax
Erforderlich: Nein
Typ & Einschränkungen: Faxnummer, gleiches +CountryCode.Number-Format, max. 32 Zeichen.
Parameter: faxExt
Erforderlich: Nein
Typ & Einschränkungen: Faxdurchwahl, 1–16 Zeichen.
Parameter: taxNumber
Erforderlich: Nein
Typ & Einschränkungen: Steuernummer, 1–32 Zeichen.
Rückgabe
{ "contactId": "..." }
contactId (27–32 alphanumerische Zeichen) wird an domain_set_contacts und contacts_get übergeben.
contacts_get — Kontakt abrufenLiest die Details eines gespeicherten Kontakts anhand seiner Kontakt-ID. Kontakt-IDs stammen aus contacts_save, contacts_list oder dem Feld contacts in den Ergebnissen von domains_list.
Parameter: contactId
Erforderlich: Ja
Typ & Einschränkungen: Kontakt-ID, 27–32 alphanumerische Zeichen.
Rückgabe — { contact } mit:
Feld: firstName, lastName, email, address1, city, country, phone, postalCode
Typ: String
Feld: organization, address2, stateProvince, phoneExt, fax, faxExt, taxNumber
Typ: String oder null
contacts_list — Kontakte auflistenListet alle unter Ihrem Konto gespeicherten Kontakte auf, damit Sie einen vorhandenen Kontakt (über seine Kontakt-ID) finden und wiederverwenden können, anstatt ein Duplikat zu erstellen oder Ihre Domains zu durchsuchen. Die Liste ist paginiert und sortierbar, konsistent mit domains_list.
Parameter: take
Erforderlich: Nein
Typ & Einschränkungen: Elemente pro Seite, 1–100. Standard 10.
Parameter: skip
Erforderlich: Nein
Typ & Einschränkungen: Zu überspringende Elemente, 0 oder mehr. Standard 0.
Parameter: orderBy
Erforderlich: Nein
Typ & Einschränkungen: Bis zu 8 Sortierschlüssel: name, email, organization; mit dem Präfix - für absteigend (z. B. -name).
Rückgabe — { items, total }, wobei total die Anzahl eindeutiger Kontakte im Konto ist (nach Kontakt-ID dedupliziert, nicht nach Seitengröße), und jedes Element genug Informationen enthält, um Kontakte ohne Folgeaufruf auseinanderzuhalten. Wenn das Konto doppelte Einträge für dieselbe Kontakt-ID hat, werden sie zu einem Eintrag zusammengefasst, sodass total unterschiedliche Kontakte statt roher serverseitiger Zeilen zählt:
Feld: contactId
Typ: String (27–32 alphanumerisch). An contacts_get oder domain_set_contacts übergeben.
Feld: name
Typ: String — der Name des Kontakts.
Feld: email
Typ: String oder null, wenn für den Kontakt keine E-Mail-Adresse hinterlegt ist.
Feld: organization
Typ: String oder null, wenn für den Kontakt keine Organisation hinterlegt ist.
{"items": [{ "contactId": "1anq5bsl9haBy21rOV9aeDWrARBsV", "name": "Ada Lovelace", "email": "ada@example.com", "organization": "Analytical Engines" }],"total": 1}
Eingaben für Domainnamen (domain/domainName) akzeptieren Unicode (IDN) oder ASCII (A-Label) — in beiden Fällen normalisiert das Tool den Namen vor der Verwendung automatisch zu Punycode. domains_check_availability erfordert zusätzlich eine von Spaceship für die Registrierung unterstützte TLD: Eine Domain, deren TLD nicht unterstützt wird, wird als nicht verfügbar gemeldet, anstatt geprüft zu werden. Die anderen Domain-Tools (domains_list, domain_set_contacts, domain_set_nameservers) sowie die DNS-Tools normalisieren nur den Namen und lehnen nie aufgrund der TLD-Unterstützung ab.
domains_list — Domains auflistenRuft eine paginierte Liste Ihrer Domains ab. Übergeben Sie domain, um stattdessen eine einzelne Domain nach Namen abzurufen (Paginierung und Sortierung werden dann ignoriert, und das Ergebnis enthält einen note-Hinweis, der dies angibt, falls sie mitgeliefert wurden).
Parameter: domain
Erforderlich: Nein
Typ & Einschränkungen: Vollqualifizierter Domainname zum Abrufen einer einzelnen Domain. Akzeptiert Unicode (IDN) oder ASCII (A-Label) — wird automatisch zu Punycode normalisiert.
Parameter: take
Erforderlich: Nein
Typ & Einschränkungen: Elemente pro Seite, 1–100. Standard 10.
Parameter: skip
Erforderlich: Nein
Typ & Einschränkungen: Zu überspringende Elemente, 0 oder mehr. Standard 0.
Parameter: orderBy
Erforderlich: Nein
Typ & Einschränkungen: Bis zu 8 Sortierschlüssel: name, unicodeName, registrationDate, expirationDate; mit dem Präfix - für absteigend (z. B. -expirationDate).
Rückgabe — { items, total }, wobei jedes Element eine Domain beschreibt:
Feld: name / unicodeName
Bedeutung: Domainname in ASCII- und Unicode-Form.
Feld: isPremium
Bedeutung: Ob die Domain ein Premium-Name ist.
Feld: autoRenew
Bedeutung: Ob die automatische Verlängerung aktiviert ist.
Feld: registrationDate / expirationDate
Bedeutung: Zeitstempel für Registrierung und Ablauf.
Feld: lifecycleStatus
Bedeutung: creating, registered, grace1, grace2 oder redemption.
Feld: verificationStatus
Bedeutung: verification, success, failed oder null, wenn nicht zutreffend.
Feld: eppStatuses
Bedeutung: Registry-Statuscodes (z. B. Transfer-Sperren).
Feld: suspensions
Bedeutung: Aktive Sperrungen, jeweils mit einem reasonCode.
Feld: privacyProtection
Bedeutung: { level: "public" | "high", contactForm: boolean }.
Feld: nameservers
Bedeutung: { provider: "basic" | "custom", hosts: [...] }.
Feld: contacts
Bedeutung: Kontakt-IDs: registrant sowie admin/tech/billing (kann null sein) und attributes (eine Liste von Kontakt-IDs für erweiterte Attribute oder null). Lesbar über contacts_get.
Spaceship MCP füllt jedes oben genannte Feld aus — einschließlich contacts, eppStatuses, suspensions, verificationStatus, nameservers, eines echten autoRenew und eines separaten unicodeName, wenn die Domain eines hat — sowohl für Listen mit mehreren Elementen als auch für Abrufe einzelner Domains.
domains_check_availability — Domain-Verfügbarkeit prüfenPrüft, ob ein oder mehrere Domainnamen zur Registrierung verfügbar sind. Verwendet den Endpunkt für einzelne Domains bei einem Namen und den Bulk-Endpunkt bei mehreren. Eine Domain, deren TLD für die Registrierung nicht unterstützt wird, wird überhaupt nicht an die Verfügbarkeitsprüfung gesendet — sie wird sofort als tldNotSupported zurückgegeben.
Parameter: domains
Erforderlich: Ja
Typ & Einschränkungen: 1–20 vollqualifizierte Domainnamen. Jeder akzeptiert Unicode (IDN) oder ASCII (A-Label) — wird automatisch zu Punycode normalisiert.
Rückgabe — { results }, ein Eintrag pro angefordertem Namen:
Feld: domain
Bedeutung: Der geprüfte Name.
Feld: result
Bedeutung: available, taken, invalidDomainName, tldNotSupported oder unexpectedError.
Feld: premiumPricing
Bedeutung: Für Premium-Namen: Liste von { operation, price, currency }, wobei operationregister, transfer, renew oder restore ist. Leer bei regulären Namen.
Feld: price
Bedeutung: Für verfügbare Namen (Standard und Premium): der USD-Preis für die Registrierung der Domain für die kürzeste Laufzeit, die die TLD erlaubt — { amount, currency: "USD", pricedYears?, pricePerYear?, icannFee?, isPremium }. amount ist der zu zahlende Gesamtbetrag für diese gesamte Laufzeit; pricedYears gibt an, wie viele Jahre sie abdeckt. Es wird kein Preis vor Rabatt oder „Vorher“-Preis gemeldet. icannFee ist die ICANN-Gebühr (USD), die bereits enthalten in amount ist und separat zurückgegeben wird, damit die Aufschlüsselung erklärt werden kann; sie erscheint nur, wenn für die TLD eine Gebühr anfällt.
Feld: pricePerYear
Bedeutung: Innerhalb von price: amount geteilt durch pricedYears, sodass immer ein Jahreswert zum Vergleich verfügbar ist. Wenn pricedYears 1 ist, ist es der tatsächliche Einjahrespreis; darüber ist es ein Jahresdurchschnitt der Laufzeit, nicht eine Laufzeit, die Sie kaufen könnten.
Feld: minRegisterPeriodInYears / maxRegisterPeriodInYears
Bedeutung: Für verfügbare Namen: die kürzeste und längste Registrierungsdauer, die diese TLD tatsächlich erlaubt, als zwei einfache Zahlen. Sie zeigen dem Kunden, für welche Laufzeiten er die Domain kaufen kann. Beide werden weggelassen, wenn die zulässige Dauer nicht bestimmt werden konnte.
Feld: priceUnavailableReason
Bedeutung: Vorhanden anstelle von price, wenn der Preis für einen verfügbaren Namen nicht bestimmt werden konnte. Die Prüfung selbst ist dennoch erfolgreich.
Nur verfügbare Namen werden bepreist; taken/ungültige Ergebnisse enthalten weder price noch priceUnavailableReason.
Die meisten TLDs erlauben ein Jahr, manche jedoch nicht..ai hat zum Beispiel eine Mindestlaufzeit von zwei Jahren. Bei diesen ist price.amount der Gesamtbetrag für die Mindestlaufzeit — nicht ein Einjahrespreis, auf dessen Basis Sie handeln könnten — und price.pricedYears weist darauf hin:
{"domain": "example.ai","result": "available","premiumPricing": [],"price": { "amount": 159.96, "currency": "USD", "pricedYears": 2, "pricePerYear": 79.98, "isPremium": false },"minRegisterPeriodInYears": 2,"maxRegisterPeriodInYears": 10}
pricePerYear ist hier vorhanden — 159.96 geteilt durch die zwei Jahre, die es abdeckt, ergibt 79.98. Dies ist der Gesamtbetrag geteilt durch die Laufzeit, nicht ein Preis, den Sie für ein einzelnes Jahr zahlen könnten (eine einjährige .ai-Registrierung kann nicht gekauft werden). Zeigen Sie immer amount zusammen mit pricedYears an („159,96 $ für 2 Jahre“), niemals amount allein. Bei einer gewöhnlichen TLD ist pricedYears1 und pricePerYear entspricht amount.
domain_set_contacts — Domain-Kontakte festlegenÄndert die Kontakte, die einer Domain zugewiesen sind, die Ihnen gehört. Wird sofort abgeschlossen (keine Operation zum Abfragen).
Parameter: domainName
Erforderlich: Ja
Typ & Einschränkungen: Vollqualifizierter Domainname. Akzeptiert Unicode (IDN) oder ASCII (A-Label) — wird automatisch zu Punycode normalisiert.
Parameter: registrant
Erforderlich: Ja
Typ & Einschränkungen: contactId-String (27–32 alphanumerisch), aus contacts_save.
Parameter: admin
Erforderlich: Nein
Typ & Einschränkungen: contactId-String (27–32 alphanumerisch) oder null.
Parameter: tech
Erforderlich: Nein
Typ & Einschränkungen: contactId-String (27–32 alphanumerisch) oder null.
Parameter: billing
Erforderlich: Nein
Typ & Einschränkungen: contactId-String (27–32 alphanumerisch) oder null.
Parameter: attributes
Erforderlich: Nein
Typ & Einschränkungen: Array von Kontakt-IDs für erweiterte Attribute (bis zu 5); nur für bestimmte TLDs erforderlich, andernfalls weglassen oder null.
Rückgabe
{ "verificationStatus": "verification" }
Der zurückgegebene Wert verificationStatus spiegelt die ICANN-RAA-E-Mail-Verifizierung wider: verification — der Registrant muss seine E-Mail-Adresse bestätigen (eine Bestätigungs-E-Mail wird gesendet); success — bereits bestätigt; null — die RAA-Verifizierung gilt für diese Domain nicht.
domain_set_nameservers — Domain-Nameserver festlegenÄndert die Nameserver einer Domain auf Registrar-Ebene. Wird sofort abgeschlossen (keine Operation zum Abfragen). Die Änderung wird anschließend von domains_list widergespiegelt.
Parameter: domainName
Erforderlich: Ja
Typ & Einschränkungen: Vollqualifizierter Domainname. Akzeptiert Unicode (IDN) oder ASCII (A-Label) — wird automatisch zu Punycode normalisiert.
Parameter: provider
Erforderlich: Ja
Typ & Einschränkungen: basic (Spaceships Standard-Nameserver) oder custom (Ihre eigenen Hosts).
Parameter: hosts
Erforderlich: Bedingt
Typ & Einschränkungen: Erforderlich, wenn providercustom ist: 2–12 Nameserver-Hostnamen (jeweils ein gültiger FQDN, 4–255 Zeichen). Muss weggelassen werden, wenn providerbasic ist.
Rückgabe
{ "provider": "custom", "hosts": ["ns1.example.com", "ns2.example.com"] }
Das erneute Anwenden eines Zustands, in dem sich eine Domain bereits befindet (z. B. das Setzen von basic, wenn sie bereits basic ist), gibt einen Validierungsfehler statt eines erfolgreichen No-Op zurück — behandeln Sie das als erwartetes Ergebnis, nicht als Fehlschlag, der erneut versucht werden muss.
Der domainName, den diese Tools annehmen, akzeptiert Unicode (IDN) oder ASCII (A-Label) und wird automatisch zu Punycode normalisiert; die TLD-Unterstützung wird hier nicht erzwungen.
dns_records_get — DNS-Einträge abrufenRuft eine paginierte Liste von DNS-Resource-Records für eine Domain ab.
Parameter: domainName
Erforderlich: Ja
Typ & Einschränkungen: Die Domain, deren Einträge abgerufen werden sollen.
Parameter: take
Erforderlich: Nein
Typ & Einschränkungen: Elemente pro Seite, 1–500. Standard 100.
Parameter: skip
Erforderlich: Nein
Typ & Einschränkungen: Zu überspringende Elemente, 0 oder mehr. Standard 0.
Parameter: orderBy
Erforderlich: Nein
Typ & Einschränkungen: Bis zu 8 Sortierschlüssel: type, -type, name, -name.
Rückgabe — { items, total }. Jedes Element ist ein Eintrag wie unter Record shapes beschrieben, plus ein optionales Feld group, das angibt, woher der Eintrag stammt (custom — von Ihnen erstellt, product — von einem Spaceship-Produkt verwaltet, personalNs — persönliche Nameserver).
dns_records_save — DNS-Einträge speichernFügt benutzerdefinierte DNS-Einträge hinzu oder aktualisiert die TTL vorhandener Einträge. Einträge werden ohne Beachtung der Groß-/Kleinschreibung abgeglichen, außer TXT-Einträge (Groß-/Kleinschreibung wird beachtet).
Parameter: domainName
Erforderlich: Ja
Typ & Einschränkungen: Die Domain, deren Einträge aktualisiert werden sollen.
Parameter: records
Erforderlich: Ja
Typ & Einschränkungen: 1–500 Einträge — siehe Record shapes. Jeder kann optional ttl enthalten.
Parameter: force
Erforderlich: Nein
Typ & Einschränkungen: Boolesch. Überspringt die Konfliktauflösungsprüfung und erzwingt die Zonenaktualisierung.
Rückgabe — { "saved": <number> }, die Anzahl der übermittelten Einträge. Eine erfolgreiche Antwort bedeutet, dass alle Einträge akzeptiert wurden; wenn ein Eintrag fehlschlägt, gibt der gesamte Aufruf stattdessen einen Fehler zurück.
dns_records_delete — DNS-Einträge löschenLöscht benutzerdefinierte DNS-Einträge. Löschungen können nicht rückgängig gemacht werden. Einträge werden ohne Beachtung der Groß-/Kleinschreibung abgeglichen, außer TXT-Einträge (Groß-/Kleinschreibung wird beachtet).
Parameter: domainName
Erforderlich: Ja
Typ & Einschränkungen: Die Domain, deren Einträge gelöscht werden sollen.
Parameter: records
Erforderlich: Ja
Typ & Einschränkungen: 1–500 Einträge zur Identifizierung vorhandener Einträge — gleiche Formen wie beim Speichern, aber ohne ttl.
Rückgabe — { "deleted": <number> }, die Anzahl der übermittelten Einträge. Wenn ein Eintrag nicht abgeglichen werden kann, schlägt der gesamte Aufruf fehl und nichts wird gelöscht.
Jeder Eintrag hat:
type — einer der 13 unten unterstützten Typen.
name — der Eintragsname ohne die Domain: Verwenden Sie @ für die Domain selbst (Apex) und * für ein Wildcard-Zeichen.
ttl (nur speichern, optional) — Cache-Zeit in Sekunden, 60–3600.
Typspezifische Felder:
Typ: A
Felder: address — IPv4-Adresse.
Typ: AAAA
Felder: address — IPv6-Adresse.
Typ: CNAME
Felder: cname — kanonischer Domainname (max. 253 Zeichen).
Typ: ALIAS
Felder: aliasName — kanonischer Domainname; CNAME-ähnliches Verhalten für den Apex, wo CNAME nicht zulässig ist.
Typ: NS
Felder: nameserver — Nameserver-Name.
Typ: PTR
Felder: pointer — Domainname für die angegebene IP-Adresse.
Typ: TXT
Felder: value — Textwert (Abgleich unter Beachtung der Groß-/Kleinschreibung).
Typ: MX
Felder: exchange — Mailserver; preference — Priorität (0–65535, niedriger wird bevorzugt).
Typ: CAA
Felder: flag — 0 oder 128 (kritisches Bit); tag — issue, issuewild oder iodef; value — CA-Kennung mit optionalen Parametern.
Typ: SRV
Felder: service (z. B. _sip); protocol (z. B. _tcp); priority und weight (0–65535); port (1–65535); target — Server-Domainname.
Typ: TLSA
Felder: usage, selector, matching (jeweils 0–255); port — * oder _<1–65535>; protocol (z. B. _tcp); associationData — Zertifikat-Hash oder -Daten.
Typ: HTTPS
Felder: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN oder .; optional port (* oder _<1–65535>), scheme (muss _https sein, wenn port gesetzt ist), svcParams.
Typ: SVCB
Felder: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN oder .; optional port, scheme (z. B. _tcp), svcParams.
async_operation_get — Status des asynchronen Vorgangs abrufenPrüft einen lang laufenden Vorgang in Ihrem Konto anhand seiner operationId. Rufen Sie es wiederholt auf, bis statussuccess oder failed ist.
Parameter: operationId
Erforderlich: Ja
Typ & Einschränkungen: Alphanumerische Zeichenfolge, max. 36 Zeichen, zurückgegeben von dem Tool, das den Vorgang gestartet hat.
Rückgabe
Feld: operationId
Bedeutung: Der abgefragte Vorgang.
Feld: status
Bedeutung: pending, success oder failed.
Feld: type
Bedeutung: Vorgangstyp oder null.
Feld: details
Bedeutung: Zusätzliche Details zum Vorgang oder null.
Feld: createdAt / modifiedAt
Bedeutung: Wann der Vorgang erstellt / zuletzt aktualisiert wurde (modifiedAt kann null sein).
Wenn ein Aufruf fehlschlägt, gibt das Tool einen Fehler mit einem Code und einem menschenlesbaren detail zurück, der erklärt, was schiefgelaufen ist — zum Beispiel ungültige Eingaben (ein fehlerhafter Domainname oder eine fehlerhafte Kontakt-ID), eine Domain oder ein Kontakt, die bzw. der nicht existiert, oder ein Konflikt mit dem aktuellen Zustand. Wenn ein Tool abgelehnt wird, weil dem Assistenten kein Zugriff darauf gewährt wurde, verbinden Sie Spaceship MCP erneut und genehmigen Sie den angeforderten Zugriff.