Spaceship MCP Connector łączy Twojego asystenta AI (takiego jak Claude) z Twoim kontem Spaceship. Dzięki temu asystent może sprawdzać dostępność i ceny domen, zarządzać kontaktami domenowymi i serwerami nazw oraz odczytywać lub edytować rekordy DNS w Twoim imieniu — wystarczy, że zapytasz w prostym języku, a asystent wywoła odpowiednie narzędzia.
Spaceship MCP Connector nie kupuje domen. Asystent może sprawdzić, czy nazwa jest dostępna i ile kosztuje, ale sam zakup odbywa się na spaceship.com.
Potrzebujesz konta Spaceship. Spaceship MCP Connector jest dostępny pod adresem https://connector-mcp.spaceship.com/mcp.
Claude (web i desktop) — otwórz Ustawienia, wybierz Connectors, znajdź Spaceship w katalogu konektorów i dodaj go. Claude od Anthropic jest obecnie klientem, z którym potwierdziliśmy działanie Spaceship MCP Connector.
Inni klienci MCP — dodaj zdalny serwer MCP i wskaż go na https://connector-mcp.spaceship.com/mcp. Inni klienci mogą działać, ale jeszcze ich nie zweryfikowaliśmy.
Podczas łączenia zostaniesz poproszony o zalogowanie się do Spaceship i przyznanie asystentowi dostępu do Twojego konta. To, z których narzędzi asystent może korzystać, zależy od zatwierdzonego dostępu — jeśli narzędzie zostanie odrzucone, ponieważ dostęp nie został przyznany, połącz się ponownie i zatwierdź wymagany dostęp.
Narzędzie: contacts_save
Co robi: Zapisuje dane kontaktowe i zwraca identyfikator kontaktu
Narzędzie: contacts_get
Działanie: Odczyt zapisanego kontaktu na podstawie jego identyfikatora
Narzędzie: contacts_list
Działanie: Wyświetla wszystkie zapisane kontakty, aby znaleźć i ponownie użyć jednego z nich
Narzędzie: domains_list
Działanie: Wyświetla Twoje domeny lub wyszukuje jedną domenę
Narzędzie: domains_check_availability
Działanie: Sprawdza, czy domeny są dostępne do rejestracji, oraz ich cenę
Narzędzie: domain_set_contacts
Działanie: Przypisuje kontakty do domeny, którą posiadasz
Narzędzie: domain_set_nameservers
Działanie: Przełącza domenę na podstawowe lub niestandardowe serwery nazw
Narzędzie: dns_records_get
Działanie: Odczytuje rekordy DNS dla domeny
Narzędzie: dns_records_save
Co robi: Dodaje rekordy DNS lub aktualizuje ich TTL
Narzędzie: dns_records_delete
Co robi: Usuwa rekordy DNS
Narzędzie: async_operation_get
Co robi: Sprawdza status długotrwałej operacji
Żadne z tych narzędzi nie obciąża Twojego konta.
Wszędzie tam, gdzie wymagany jest kontakt (domain_set_contacts), każda rola przyjmuje contactId jako ciąg znaków — nigdy wbudowanych danych kontaktowych. Najpierw zapisz kontakt za pomocą contacts_save (co zwraca jego contactId), a następnie przekaż ten identyfikator tam, gdzie kontakt jest akceptowany. Nie ma wbudowanego automatycznego zapisu; rola nie może otrzymać pełnego obiektu kontaktu. Możesz też ponownie użyć contactId z wyniku contacts_list lub odczytanego z wyniku domains_list.
Pole contactId to ciąg 27–32 znaków alfanumerycznych. Po prostu przekaż go z powrotem tam, gdzie kontakt jest akceptowany.
Kilka narzędzi zaprojektowano do wspólnego użycia: dane wyjściowe jednego stają się danymi wejściowymi następnego.
domains_check_availability — sprawdź nazwę lub nazwy, które chcesz. Każda dostępna nazwa zawiera cenę rejestracji w USD w polu price (zarówno standardowa, jak i premium) albo priceUnavailableReason, gdy nie można jej ustalić, a także minRegisterPeriodInYears i maxRegisterPeriodInYears — okresy dozwolone przez TLD. Pamiętaj, że price obejmuje price.pricedYears lat, co jest najkrótszym okresem dozwolonym przez TLD i nie zawsze wynosi 1.
Kup ją na spaceship.com. Żadne narzędzie nie rejestruje domeny ani nie tworzy linku do płatności, więc asystent nie może sfinalizować zakupu ani powiedzieć, że domena została zarejestrowana w ramach tej rozmowy. Po zakończeniu zakupu domains_list pokaże nową domenę.
domain_set_contacts — przypisz kontakty do domeny za pomocą contactId (w razie potrzeby najpierw zapisz je przez contacts_save). Operacja kończy się natychmiast i zwraca verificationStatus: verification oznacza, że abonent musi potwierdzić swój adres e-mail, zanim zmiana zostanie w pełni zastosowana (zostanie do niego wysłany e-mail), success oznacza, że jest już potwierdzony, a null oznacza, że dla tej domeny potwierdzenie nie jest wymagane.
domains_list — znajdź domenę i zobacz jej bieżące nameservers ({ provider, hosts }).
domain_set_nameservers — przełącz ją na domyślne serwery nazw Spaceship za pomocą provider: "basic" (bez hosts) albo wskaż własne za pomocą provider: "custom" i listy 2–12 hosts. Zwraca wynikowe { provider, hosts }, a kolejne wywołanie domains_list odzwierciedla zmianę. Ponowne zastosowanie stanu, w którym domena już się znajduje, zwraca błąd walidacji zamiast braku operacji — traktuj to jako oczekiwane zachowanie, a nie niepowodzenie wymagające ponowienia próby.
domains_list — znajdź domenę, którą chcesz zarządzać (lub podaj jej nazwę bezpośrednio, jeśli ją znasz).
dns_records_get — odczytaj bieżące rekordy domeny.
dns_records_save lub dns_records_delete — dodawaj, aktualizuj lub usuwaj rekordy. Rekordy zwracane przez dns_records_get mają ten sam kształt, który akceptują narzędzia zapisu i usuwania (usuwanie po prostu pomija ttl), więc asystent może je odczytać, dostosować i zapisać z powrotem. Dopasowanie nie rozróżnia wielkości liter, z wyjątkiem rekordów TXT, które ją rozróżniają.
domains_list — przeglądaj stronicami wszystkie swoje domeny z sortowaniem albo pobierz pojedynczą domenę po nazwie. Każda domena zawiera datę wygaśnięcia, ustawienie automatycznego odnowienia, status, serwery nazw, ochronę prywatności i przypisane identyfikatory kontaktów.
contacts_list — przeglądaj stronicami wszystkie kontakty zapisane na Twoim koncie, aby znaleźć i ponownie użyć istniejącego (po jego identyfikatorze kontaktu) zamiast tworzyć duplikat.
contacts_get — sprawdź szczegóły powiązane z dowolnym identyfikatorem kontaktu, który widzisz przy domenie lub w wyniku contacts_list.
Każde narzędzie zwraca wynik jako uporządkowany JSON, a każde kończy działanie natychmiast.
Kontakty to osoby lub organizacje powiązane z rejestracją domeny (abonent, administrator, techniczny, rozliczeniowy). Do kontaktu wszędzie odwołuje się jego identyfikator kontaktu — nieprzezroczysty ciąg znaków.
contacts_save — Zapisz kontaktZapisuje dane kontaktowe i zwraca wygenerowany identyfikator kontaktu. Walidacja niektórych pól (takich jak stateProvince i postalCode) zależy od wybranego kraju.
Parametr: firstName
Wymagane: Tak
Typ i ograniczenia: Ciąg znaków, 1–64 znaki. Może zawierać myślniki i apostrofy.
Parametr: lastName
Wymagane: Tak
Typ i ograniczenia: Ciąg znaków, 1–64 znaki. Może zawierać myślniki i apostrofy.
Parametr: email
Wymagane: Tak
Typ i ograniczenia: Prawidłowy adres e-mail, maks. 254 znaki.
Parametr: address1
Wymagane: Tak
Typ i ograniczenia: Wiersz adresu 1. Ciąg znaków, 1–128 znaków.
Parametr: city
Wymagane: Tak
Typ i ograniczenia: Ciąg znaków, 1–64 znaki.
Parametr: country
Wymagane: Tak
Typ i ograniczenia: Dwuliterowy kod kraju (ISO 3166-1 alpha-2), np. US.
Parametr: phone
Wymagane: Tak
Typ i ograniczenia: Format międzynarodowy +CountryCode.Number, np. +1.2025551234. Maks. 32 znaki.
Parametr: organization
Wymagane: Nie
Typ i ograniczenia: Nazwa organizacji/firmy. 1–128 znaków.
Parametr: address2
Wymagane: Nie
Typ i ograniczenia: Druga linia adresu. 1–128 znaków.
Parametr: stateProvince
Wymagane: Nie
Typ i ograniczenia: Nazwa stanu/prowincji, 1–64 znaki. Może być wymagana w zależności od kraju.
Parametr: postalCode
Wymagane: Nie
Typ i ograniczenia: 1–16 znaków. Może być wymagany w zależności od kraju.
Parametr: phoneExt
Wymagane: Nie
Typ i ograniczenia: Numer wewnętrzny telefonu, 1–16 znaków.
Parametr: fax
Wymagane: Nie
Typ i ograniczenia: Numer faksu, ten sam format +CountryCode.Number, maks. 32 znaki.
Parametr: faxExt
Wymagane: Nie
Typ i ograniczenia: Numer wewnętrzny faksu, 1–16 znaków.
Parametr: taxNumber
Wymagane: Nie
Typ i ograniczenia: Numer podatkowy, 1–32 znaki.
Zwraca
{ "contactId": "..." }
contactId (27–32 znaki alfanumeryczne) to wartość przekazywana do domain_set_contacts i contacts_get.
contacts_get — Pobierz kontaktOdczytuje szczegóły zapisanego kontaktu na podstawie jego identyfikatora kontaktu. Identyfikatory kontaktów pochodzą z contacts_save, contacts_list lub z pola contacts w wynikach domains_list.
Parametr: contactId
Wymagane: Tak
Typ i ograniczenia: Identyfikator kontaktu, 27–32 znaki alfanumeryczne.
Zwraca — { contact } z polami:
Pole: firstName, lastName, email, address1, city, country, phone, postalCode
Typ: String
Pole: organization, address2, stateProvince, phoneExt, fax, faxExt, taxNumber
Typ: String lub null
contacts_list — Lista kontaktówWyświetla wszystkie kontakty zapisane na Twoim koncie, dzięki czemu możesz znaleźć i ponownie użyć istniejącego kontaktu (na podstawie jego identyfikatora kontaktu) zamiast tworzyć duplikat lub przeszukiwać swoje domeny. Lista jest stronicowana i sortowalna, zgodnie z domains_list.
Parametr: take
Wymagane: Nie
Typ i ograniczenia: Liczba elementów na stronę, 1–100. Domyślnie 10.
Parametr: skip
Wymagane: Nie
Typ i ograniczenia: Liczba pomijanych elementów, 0 lub więcej. Domyślnie 0.
Parametr: orderBy
Wymagane: Nie
Typ i ograniczenia: Do 8 kluczy sortowania: name, email, organization; poprzedź - dla kolejności malejącej (np. -name).
Zwraca — { items, total }, gdzie total to liczba unikalnych kontaktów na koncie (bez duplikatów według identyfikatora kontaktu, a nie rozmiar strony), a każdy element zawiera wystarczająco dużo informacji, by odróżnić kontakty bez dodatkowego wywołania. Jeśli konto zawiera zduplikowane wpisy dla tego samego identyfikatora kontaktu, są one scalane do jednego, więc total liczy odrębne kontakty, a nie surowe wiersze po stronie serwera:
Pole: contactId
Typ: String (27–32 alfanumeryczne). Przekaż do contacts_get lub domain_set_contacts.
Pole: name
Typ: String — nazwa kontaktu.
Pole: email
Typ: String lub null, gdy kontakt nie ma zapisanego adresu e-mail.
Pole: organization
Typ: String lub null, gdy kontakt nie ma zapisanej organizacji.
{"items": [{ "contactId": "1anq5bsl9haBy21rOV9aeDWrARBsV", "name": "Ada Lovelace", "email": "ada@example.com", "organization": "Analytical Engines" }],"total": 1}
Dane wejściowe nazwy domeny (domain/domainName) akceptują Unicode (IDN) lub ASCII (A-label) — w obu przypadkach narzędzie automatycznie normalizuje nazwę do punycode przed użyciem. domains_check_availability dodatkowo wymaga TLD obsługiwanego przez Spaceship do rejestracji: domena, której TLD nie jest obsługiwane, jest zgłaszana jako niedostępna zamiast sprawdzana. Pozostałe narzędzia domenowe (domains_list, domain_set_contacts, domain_set_nameservers) oraz narzędzia DNS tylko normalizują nazwę i nigdy nie odrzucają jej z powodu obsługi TLD.
domains_list — Lista domenPobiera stronicowaną listę Twoich domen. Przekaż domain, aby zamiast tego pobrać pojedynczą domenę po nazwie (stronicowanie i sortowanie są wtedy ignorowane, a wynik zawiera note informującą o tym, jeśli zostały podane).
Parametr: domain
Wymagane: Nie
Typ i ograniczenia: W pełni kwalifikowana nazwa domeny do pobrania pojedynczej domeny. Akceptuje Unicode (IDN) lub ASCII (A-label) — automatycznie normalizowana do punycode.
Parametr: take
Wymagane: Nie
Typ i ograniczenia: Liczba elementów na stronę, 1–100. Domyślnie 10.
Parametr: skip
Wymagane: Nie
Typ i ograniczenia: Liczba pomijanych elementów, 0 lub więcej. Domyślnie 0.
Parametr: orderBy
Wymagane: Nie
Typ i ograniczenia: Do 8 kluczy sortowania: name, unicodeName, registrationDate, expirationDate; poprzedź - dla kolejności malejącej (np. -expirationDate).
Zwraca — { items, total }, gdzie każdy element opisuje domenę:
Pole: name / unicodeName
Znaczenie: Nazwa domeny w formie ASCII i Unicode.
Pole: isPremium
Znaczenie: Czy domena jest nazwą premium.
Pole: autoRenew
Znaczenie: Czy automatyczne odnawianie jest włączone.
Pole: registrationDate / expirationDate
Znaczenie: Znaczniki czasu rejestracji i wygaśnięcia.
Pole: lifecycleStatus
Znaczenie: creating, registered, grace1, grace2 lub redemption.
Pole: verificationStatus
Znaczenie: verification, success, failed lub null, gdy nie dotyczy.
Pole: eppStatuses
Znaczenie: Kody statusu rejestru (np. blokady transferu).
Pole: suspensions
Znaczenie: Aktywne zawieszenia, każde z polem reasonCode.
Pole: privacyProtection
Znaczenie: { level: "public" | "high", contactForm: boolean }.
Pole: nameservers
Znaczenie: { provider: "basic" | "custom", hosts: [...] }.
Pole: contacts
Znaczenie: Identyfikatory kontaktów: registrant oraz admin/tech/billing (mogą mieć wartość null) oraz attributes (lista identyfikatorów kontaktów rozszerzonych atrybutów lub null). Można je odczytać przez contacts_get.
Spaceship MCP wypełnia każde z powyższych pól — w tym contacts, eppStatuses, suspensions, verificationStatus, nameservers, rzeczywiste autoRenew oraz odrębne unicodeName, jeśli domena je posiada — zarówno dla listy wielu elementów, jak i pobrań pojedynczej domeny.
domains_check_availability — Sprawdź dostępność domenySprawdza, czy jedna lub więcej nazw domen jest dostępna do rejestracji. Dla jednej nazwy używa punktu końcowego dla pojedynczej domeny, a dla wielu — punktu końcowego zbiorczego. Domena, której TLD nie jest obsługiwane do rejestracji, w ogóle nie jest wysyłana do sprawdzenia dostępności — jest natychmiast zwracana jako tldNotSupported.
Parametr: domains
Wymagane: Tak
Typ i ograniczenia: 1–20 w pełni kwalifikowanych nazw domen. Każda akceptuje Unicode (IDN) lub ASCII (A-label) — automatycznie normalizowana do punycode.
Zwraca — { results }, po jednym wpisie dla każdej żądanej nazwy:
Pole: domain
Znaczenie: Sprawdzona nazwa.
Pole: result
Znaczenie: available, taken, invalidDomainName, tldNotSupported lub unexpectedError.
Pole: premiumPricing
Znaczenie: Dla nazw premium: lista { operation, price, currency }, gdzie operation to register, transfer, renew lub restore. Puste dla zwykłych nazw.
Pole: price
Znaczenie: Dla nazw available (standardowych i premium): cena w USD za rejestrację domeny na najkrótszy okres dozwolony przez TLD — { amount, currency: "USD", pricedYears?, pricePerYear?, icannFee?, isPremium }. amount to łączna kwota do zapłaty za cały ten okres; pricedYears określa, ile lat obejmuje. Nie jest podawana cena sprzed rabatu ani cena „było”. icannFee to opłata ICANN (USD) już uwzględniona w amount, zwracana osobno, aby można było wyjaśnić rozbicie ceny; pojawia się tylko wtedy, gdy TLD obejmuje opłatę.
Pole: pricePerYear
Znaczenie: Wewnątrz price: amount podzielone przez pricedYears, dzięki czemu zawsze dostępna jest wartość roczna do porównania. Gdy pricedYears wynosi 1, jest to rzeczywista cena za jeden rok; powyżej 1 jest to średnia roczna dla całego okresu, a nie okres, który można kupić.
Pole: minRegisterPeriodInYears / maxRegisterPeriodInYears
Znaczenie: Dla nazw available: najkrótszy i najdłuższy okres rejestracji faktycznie dozwolony przez dane TLD, jako dwie zwykłe liczby. Informują klienta, na jakie okresy może kupić domenę. Oba pola są pomijane, gdy nie udało się ustalić dozwolonego okresu.
Pole: priceUnavailableReason
Znaczenie: Obecne zamiast price, gdy nie udało się ustalić ceny dla dostępnej nazwy. Samo sprawdzenie nadal kończy się powodzeniem.
Wycena dotyczy tylko dostępnych nazw; wyniki taken/invalid nie zawierają ani price, ani priceUnavailableReason.
Większość TLD pozwala na jeden rok, ale niektóre nie..ai ma na przykład minimum dwa lata. W takich przypadkach price.amount to łączna kwota za minimalny okres — a nie cena za jeden rok, którą można faktycznie zastosować — a price.pricedYears to wskazuje:
{"domain": "example.ai","result": "available","premiumPricing": [],"price": { "amount": 159.96, "currency": "USD", "pricedYears": 2, "pricePerYear": 79.98, "isPremium": false },"minRegisterPeriodInYears": 2,"maxRegisterPeriodInYears": 10}
pricePerYear jest tutaj obecne — 159.96 podzielone przez dwa lata, które obejmuje, daje 79.98. To suma podzielona przez okres, a nie cena, którą można zapłacić za jeden rok (nie można kupić rocznej rejestracji .ai). Zawsze pokazuj amount razem z pricedYears („159,96 USD za 2 lata”), nigdy samego amount. Dla zwykłego TLD pricedYears wynosi 1, a pricePerYear jest równe amount.
domain_set_contacts — Ustaw kontakty domenyZmienia kontakty przypisane do domeny, którą posiadasz. Kończy się natychmiast (brak operacji do odpytywania).
Parametr: domainName
Wymagane: Tak
Typ i ograniczenia: W pełni kwalifikowana nazwa domeny. Akceptuje Unicode (IDN) lub ASCII (A-label) — automatycznie normalizowana do punycode.
Parametr: registrant
Wymagane: Tak
Typ i ograniczenia: contactId string (27–32 alfanumeryczne), z contacts_save.
Parametr: admin
Wymagane: Nie
Typ i ograniczenia: contactId string (27–32 alfanumeryczne) lub null.
Parametr: tech
Wymagane: Nie
Typ i ograniczenia: contactId string (27–32 alfanumeryczne) lub null.
Parametr: billing
Wymagane: Nie
Typ i ograniczenia: contactId string (27–32 alfanumeryczne) lub null.
Parametr: attributes
Wymagane: Nie
Typ i ograniczenia: Tablica identyfikatorów kontaktów rozszerzonych atrybutów (do 5); wymagana tylko dla niektórych TLD, w przeciwnym razie pomiń lub użyj null.
Zwraca
{ "verificationStatus": "verification" }
Zwrócone verificationStatus odzwierciedla weryfikację adresu e-mail ICANN RAA: verification — rejestrujący musi potwierdzić swój adres e-mail (wysyłana jest wiadomość potwierdzająca); success — już potwierdzono; null — weryfikacja RAA nie dotyczy tej domeny.
domain_set_nameservers — Ustaw serwery nazw domenyZmienia serwery nazw domeny na poziomie rejestratora. Kończy się natychmiast (brak operacji do odpytywania). Zmiana jest później widoczna w domains_list.
Parametr: domainName
Wymagane: Tak
Typ i ograniczenia: W pełni kwalifikowana nazwa domeny. Akceptuje Unicode (IDN) lub ASCII (A-label) — automatycznie normalizowana do punycode.
Parametr: provider
Wymagane: Tak
Typ i ograniczenia: basic (domyślne serwery nazw Spaceship) lub custom (Twoje własne hosty).
Parametr: hosts
Wymagane: Warunkowo
Typ i ograniczenia: Wymagane, gdy provider ma wartość custom: 2–12 nazw hostów serwerów nazw (każda poprawna nazwa FQDN, 4–255 znaków). Musi zostać pominięte, gdy provider ma wartość basic.
Zwraca
{ "provider": "custom", "hosts": ["ns1.example.com", "ns2.example.com"] }
Ponowne zastosowanie stanu, w którym domena już się znajduje (np. ustawienie basic, gdy jest już ustawione jako basic) zwraca błąd walidacji zamiast pomyślnego braku operacji — traktuj to jako oczekiwany wynik, a nie niepowodzenie wymagające ponowienia próby.
Pole domainName, które przyjmują te narzędzia, akceptuje Unicode (IDN) lub ASCII (A-label) i jest automatycznie normalizowane do punycode; obsługa TLD nie jest tutaj wymuszana.
dns_records_get — Pobierz rekordy DNSPobiera stronicowaną listę rekordów zasobów DNS dla domeny.
Parametr: domainName
Wymagane: Tak
Typ i ograniczenia: Domena, której rekordy mają zostać pobrane.
Parametr: take
Wymagane: Nie
Typ i ograniczenia: Liczba elementów na stronę, 1–500. Domyślnie 100.
Parametr: skip
Wymagane: Nie
Typ i ograniczenia: Elementy do pominięcia, 0 lub więcej. Domyślnie 0.
Parametr: orderBy
Wymagane: Nie
Typ i ograniczenia: Do 8 kluczy sortowania: type, -type, name, -name.
Zwraca — { items, total }. Każdy element jest rekordem opisanym w sekcji Kształty rekordów oraz może zawierać opcjonalne pole group wskazujące, skąd pochodzi rekord (custom — utworzony przez Ciebie, product — zarządzany przez produkt Spaceship, personalNs — osobiste serwery nazw).
dns_records_save — Zapisz rekordy DNSDodaje niestandardowe rekordy DNS lub aktualizuje TTL istniejących rekordów. Rekordy są dopasowywane bez rozróżniania wielkości liter, z wyjątkiem rekordów TXT (z rozróżnianiem wielkości liter).
Parametr: domainName
Wymagane: Tak
Typ i ograniczenia: Domena, której rekordy mają zostać zaktualizowane.
Parametr: records
Wymagane: Tak
Typ i ograniczenia: 1–500 rekordów — zobacz Kształty rekordów. Każdy może zawierać opcjonalne pole ttl.
Parametr: force
Wymagane: Nie
Typ i ograniczenia: Wartość logiczna. Pomija sprawdzanie rozwiązywania konfliktów i wymusza aktualizację strefy.
Zwraca — { "saved": <number> }, liczbę przesłanych rekordów. Pomyślna odpowiedź oznacza, że wszystkie rekordy zostały zaakceptowane; jeśli którykolwiek rekord zakończy się niepowodzeniem, całe wywołanie zwraca błąd.
dns_records_delete — Usuń rekordy DNSUsuwa niestandardowe rekordy DNS. Usunięcia nie można cofnąć. Rekordy są dopasowywane bez rozróżniania wielkości liter, z wyjątkiem rekordów TXT (z rozróżnianiem wielkości liter).
Parametr: domainName
Wymagane: Tak
Typ i ograniczenia: Domena, której rekordy mają zostać usunięte.
Parametr: records
Wymagane: Tak
Typ i ograniczenia: 1–500 rekordów identyfikujących istniejące rekordy — te same kształty co przy zapisie, ale bez ttl.
Zwraca — { "deleted": <number> }, liczbę przesłanych rekordów. Jeśli któregokolwiek rekordu nie da się dopasować, całe wywołanie kończy się niepowodzeniem i nic nie zostaje usunięte.
Każdy rekord ma:
type — jeden z 13 obsługiwanych typów poniżej.
name — nazwa rekordu bez domeny: użyj @ dla samej domeny (apex) oraz * dla symbolu wieloznacznego.
ttl (tylko zapis, opcjonalnie) — czas pamięci podręcznej w sekundach, 60–3600.
Pola specyficzne dla typu:
Typ: A
Pola: address — adres IPv4.
Typ: AAAA
Pola: address — adres IPv6.
Typ: CNAME
Pola: cname — kanoniczna nazwa domeny (maks. 253 znaki).
Typ: ALIAS
Pola: aliasName — kanoniczna nazwa domeny; zachowanie podobne do CNAME dla apexu, gdzie CNAME nie jest dozwolony.
Typ: NS
Pola: nameserver — nazwa serwera nazw.
Typ: PTR
Pola: pointer — nazwa domeny dla podanego adresu IP.
Typ: TXT
Pola: value — wartość tekstowa (dopasowywana z rozróżnianiem wielkości liter).
Typ: MX
Pola: exchange — serwer pocztowy; preference — priorytet (0–65535, preferowana niższa wartość).
Typ: CAA
Pola: flag — 0 lub 128 (bit krytyczny); tag — issue, issuewild lub iodef; value — identyfikator CA z opcjonalnymi parametrami.
Typ: SRV
Pola: service (np. _sip); protocol (np. _tcp); priority i weight (0–65535); port (1–65535); target — nazwa domeny serwera.
Typ: TLSA
Pola: usage, selector, matching (każde 0–255); port — * lub _<1–65535>; protocol (np. _tcp); associationData — skrót certyfikatu lub dane.
Typ: HTTPS
Pola: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN lub .; opcjonalnie port (* lub _<1–65535>), scheme (musi mieć wartość _https, gdy port jest ustawiony), svcParams.
Typ: SVCB
Pola: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN lub .; opcjonalnie port, scheme (np. _tcp), svcParams.
async_operation_get — Pobierz status operacji asynchronicznejSprawdza długotrwałą operację na Twoim koncie na podstawie jej operationId. Wywołuj je wielokrotnie, aż status będzie mieć wartość success lub failed.
Parametr: operationId
Wymagane: Tak
Typ i ograniczenia: Ciąg alfanumeryczny, maks. 36 znaków, zwracany przez narzędzie, które rozpoczęło operację.
Zwraca
Pole: operationId
Znaczenie: Odpytywana operacja.
Pole: status
Znaczenie: pending, success lub failed.
Pole: type
Znaczenie: Typ operacji lub null.
Pole: details
Znaczenie: Dodatkowe szczegóły operacji lub null.
Pole: createdAt / modifiedAt
Znaczenie: Kiedy operacja została utworzona / ostatnio zaktualizowana (modifiedAt może mieć wartość null).
Gdy wywołanie kończy się niepowodzeniem, narzędzie zwraca błąd z kodem i czytelnym dla człowieka polem detail wyjaśniającym, co poszło nie tak — na przykład nieprawidłowe dane wejściowe (błędnie sformatowana nazwa domeny lub identyfikator kontaktu), domena lub kontakt, który nie istnieje, albo konflikt z bieżącym stanem. Jeśli narzędzie zostanie odrzucone, ponieważ asystent nie otrzymał do niego dostępu, połącz ponownie Spaceship MCP i zatwierdź żądany dostęp.