Spaceship MCP Connector — referenční příručka nástrojů

Spaceship MCP Connector propojuje vašeho AI asistenta (například Claude) s vaším účtem Spaceship. Díky tomu může asistent kontrolovat dostupnost a ceny domén, spravovat kontakty a nameservery domén a číst nebo upravovat DNS záznamy vaším jménem — stačí se zeptat běžným jazykem a asistent zavolá správné nástroje.

Spaceship MCP Connector nekupuje domény. Asistent může zkontrolovat, zda je název dostupný a kolik stojí, ale samotný nákup probíhá na spaceship.com.

Začínáme

Potřebujete účet Spaceship. Spaceship MCP Connector je k dispozici na adrese https://connector-mcp.spaceship.com/mcp.

  • Claude (web a desktop) — otevřete Nastavení, zvolte Connectors, najděte Spaceship v adresáři konektorů a přidejte jej. Claude od společnosti Anthropic je v současnosti klient, u kterého jsme ověřili, že s ním Spaceship MCP Connector funguje.

  • Další MCP klienti — přidejte vzdálený MCP server a namiřte jej na https://connector-mcp.spaceship.com/mcp. Ostatní klienti mohou fungovat, ale zatím jsme je neověřili.

Při připojení budete vyzváni k přihlášení do Spaceship a k udělení přístupu asistenta k vašemu účtu. To, které nástroje může asistent používat, závisí na přístupu, který schválíte — pokud je nástroj odmítnut, protože přístup nebyl udělen, znovu se připojte a schvalte přístup, který potřebuje.

Přehled nástrojů

  • Nástroj: contacts_save

    Co dělá: Uloží kontaktní údaje a získá ID kontaktu

  • Nástroj: contacts_get

    Co dělá: Načte uložený kontakt podle jeho ID

  • Nástroj: contacts_list

    Co dělá: Vypíše všechny uložené kontakty, abyste mohli jeden najít a znovu použít

  • Nástroj: domains_list

    Co dělá: Vypíše vaše domény nebo vyhledá jednu doménu

  • Nástroj: domains_check_availability

    Co dělá: Zkontroluje, zda jsou domény dostupné k registraci, a jejich cenu

  • Nástroj: domain_set_contacts

    Co dělá: Přiřadí kontakty k doméně, kterou vlastníte

  • Nástroj: domain_set_nameservers

    Co dělá: Přepne doménu na základní nebo vlastní nameservery

  • Nástroj: dns_records_get

    Co dělá: Načte DNS záznamy pro doménu

  • Nástroj: dns_records_save

    Co dělá: Přidá DNS záznamy nebo aktualizuje jejich TTL

  • Nástroj: dns_records_delete

    Co dělá: Smaže DNS záznamy

  • Nástroj: async_operation_get

    Co dělá: Zkontroluje stav dlouho běžící operace

Žádný z těchto nástrojů neúčtuje poplatky z vašeho účtu.

Kontakty: odkazované podle ID

Kdekoli je vyžadován kontakt (domain_set_contacts), každá role přijímá contactId řetězec — nikdy ne vložené kontaktní údaje. Nejprve kontakt uložte pomocí contacts_save (což vrátí jeho contactId), a pak toto ID předejte tam, kde je kontakt přijímán. Neexistuje žádné automatické inline uložení; role nemůže přijmout celý objekt kontaktu. Můžete také znovu použít contactId z výsledku contacts_list nebo takové, které přečtete z výsledku domains_list.

Hodnota contactId je řetězec o délce 27–32 alfanumerických znaků. Stačí ji předat zpět tam, kde je kontakt přijímán.

Běžné pracovní postupy

Několik nástrojů je navrženo tak, aby se používaly společně: výstup jednoho se stává vstupem dalšího.

Najděte doménu ke koupi

  1. domains_check_availability — zkontrolujte požadovaný název nebo názvy. Každý dostupný název obsahuje cenu v USD price za registraci (standardní i prémiové), nebo priceUnavailableReason, když ji nelze určit, plus minRegisterPeriodInYears a maxRegisterPeriodInYears — období, která TLD umožňuje. Všimněte si, že price pokrývá price.pricedYears let, což je nejkratší období povolené TLD a není vždy 1.

  2. Kupte ji na spaceship.com. Žádný nástroj neregistruje doménu ani nevytváří odkaz na pokladnu, takže asistent nemůže nákup dokončit ani tvrdit, že byla doména z konverzace zaregistrována. Jakmile je nákup dokončen, domains_list zobrazí novou doménu.

Aktualizujte kontakty u domény, kterou vlastníte

  1. domain_set_contacts — přiřaďte kontakty k doméně pomocí contactId (v případě potřeby je nejprve uložte pomocí contacts_save). To se dokončí okamžitě a vrátí verificationStatus: verification znamená, že držitel musí potvrdit svou e-mailovou adresu, než se změna plně projeví (je mu odeslán e-mail), success znamená, že je již potvrzena, a null znamená, že pro tuto doménu není potvrzení vyžadováno.

Změňte nameservery domény

  1. domains_list — najděte doménu a podívejte se na její aktuální nameservers ({ provider, hosts }).

  2. domain_set_nameservers — přepněte ji na výchozí nameservery Spaceship pomocí provider: "basic" (bez hosts), nebo ji namiřte na vlastní pomocí provider: "custom" a seznamu 2–12 hosts. Vrátí výsledné { provider, hosts } a následné domains_list změnu zobrazí. Opětovné použití stavu, ve kterém už doména je, vrátí chybu validace namísto nečinné operace — považujte to za očekávané, ne za selhání vyžadující opakování.

Správa DNS záznamů

  1. domains_list — najděte doménu, kterou chcete spravovat (nebo zadejte její název přímo, pokud ho znáte).

  2. dns_records_get — přečtěte aktuální záznamy domény.

  3. dns_records_save nebo dns_records_delete — přidejte, aktualizujte nebo odeberte záznamy. Záznamy vrácené nástrojem dns_records_get mají stejný tvar, jaký přijímají nástroje pro uložení a smazání (u smazání se jen vynechá ttl), takže asistent může číst, upravovat a znovu zapisovat. Porovnávání nerozlišuje velikost písmen kromě TXT záznamů, které ji rozlišují.

Zkontrolujte své portfolio

  • domains_list — procházejte stránkami všechny své domény s řazením nebo načtěte jednu doménu podle názvu. Každá doména obsahuje datum vypršení platnosti, nastavení automatického obnovení, stav, nameservery, ochranu soukromí a přiřazená ID kontaktů.

  • contacts_list — procházejte stránkami všechny kontakty uložené ve vašem účtu, abyste našli a znovu použili existující kontakt (podle jeho ID kontaktu) místo vytváření duplicitního.

  • contacts_get — vyhledejte podrobnosti za jakýmkoli ID kontaktu, které vidíte u domény nebo ve výsledku contacts_list.

Referenční příručka nástrojů

Každý nástroj vrací svůj výsledek jako strukturovaný JSON a každý nástroj se dokončí okamžitě.

Kontakty

Kontakty jsou osoby nebo organizace připojené k registraci domény (držitel, admin, tech, billing). Na kontakt se všude odkazuje pomocí jeho ID kontaktu — neprůhledného řetězce.

contacts_save — Uložit kontakt

Uloží kontaktní údaje a vrátí vygenerované ID kontaktu. Validace některých polí (například stateProvince a postalCode) závisí na zvolené zemi.

  • Parametr: firstName

    Povinné: Ano

    Typ a omezení: Řetězec, 1–64 znaků. Může obsahovat spojovníky a apostrofy.

  • Parametr: lastName

    Povinné: Ano

    Typ a omezení: Řetězec, 1–64 znaků. Může obsahovat spojovníky a apostrofy.

  • Parametr: email

    Povinné: Ano

    Typ a omezení: Platná e-mailová adresa, max. 254 znaků.

  • Parametr: address1

    Povinné: Ano

    Typ a omezení: Řádek adresy 1. Řetězec, 1–128 znaků.

  • Parametr: city

    Povinné: Ano

    Typ a omezení: Řetězec, 1–64 znaků.

  • Parametr: country

    Povinné: Ano

    Typ a omezení: Dvoupísmenný kód země (ISO 3166-1 alpha-2), např. US.

  • Parametr: phone

    Povinné: Ano

    Typ a omezení: Mezinárodní formát +CountryCode.Number, např. +1.2025551234. Max. 32 znaků.

  • Parametr: organization

    Povinné: Ne

    Typ a omezení: Název organizace/společnosti. 1–128 znaků.

  • Parametr: address2

    Povinné: Ne

    Typ a omezení: Řádek adresy 2. 1–128 znaků.

  • Parametr: stateProvince

    Povinné: Ne

    Typ a omezení: Název státu/provincie, 1–64 znaků. Může být vyžadován v závislosti na zemi.

  • Parametr: postalCode

    Povinné: Ne

    Typ a omezení: 1–16 znaků. Může být vyžadováno v závislosti na zemi.

  • Parametr: phoneExt

    Povinné: Ne

    Typ a omezení: Telefonní předvolba, 1–16 znaků.

  • Parametr: fax

    Povinné: Ne

    Typ a omezení: Faxové číslo, stejný formát +CountryCode.Number, max. 32 znaků.

  • Parametr: faxExt

    Povinné: Ne

    Typ a omezení: Faxová předvolba, 1–16 znaků.

  • Parametr: taxNumber

    Povinné: Ne

    Typ & omezení: Daňové číslo, 1–32 znaků.

Vrací

{ "contactId": "..." }

contactId (27–32 alfanumerických znaků) je to, co předáváte do domain_set_contacts a contacts_get.

contacts_get — Získat kontakt

Načte podrobnosti uloženého kontaktu podle jeho ID kontaktu. ID kontaktu pocházejí z contacts_save, contacts_list nebo z pole contacts ve výsledcích domains_list.

  • Parametr: contactId

    Povinné: Ano

    Typ & omezení: ID kontaktu, 27–32 alfanumerických znaků.

Vrací — { contact } s:

  • Pole: firstName, lastName, email, address1, city, country, phone, postalCode

    Typ: Řetězec

  • Pole: organization, address2, stateProvince, phoneExt, fax, faxExt, taxNumber

    Typ: Řetězec nebo null

contacts_list — Seznam kontaktů

Vypíše všechny kontakty uložené pod vaším účtem, takže můžete najít a znovu použít existující kontakt (podle jeho ID kontaktu) místo vytváření duplikátu nebo procházení vašich domén. Seznam je stránkovaný a řaditelný, v souladu s domains_list.

  • Parametr: take

    Povinné: Ne

    Typ & omezení: Položek na stránku, 1–100. Výchozí 10.

  • Parametr: skip

    Povinné: Ne

    Typ & omezení: Položky k přeskočení, 0 nebo více. Výchozí 0.

  • Parametr: orderBy

    Povinné: Ne

    Typ & omezení: Až 8 klíčů řazení: name, email, organization; předpona - pro sestupné řazení (např. -name).

Vrací — { items, total } kde total je počet jedinečných kontaktů na účtu (deduplikovaných podle ID kontaktu, nikoli podle velikosti stránky) a každá položka obsahuje dostatek informací k rozlišení kontaktů bez následného volání. Pokud má účet duplicitní záznamy pro stejné ID kontaktu, jsou sloučeny do jednoho, takže total počítá odlišné kontakty, nikoli nezpracované řádky na straně serveru:

  • Pole: contactId

    Typ: Řetězec (27–32 alfanumerických znaků). Předejte do contacts_get nebo domain_set_contacts.

  • Pole: name

    Typ: Řetězec — jméno kontaktu.

  • Pole: email

    Typ: Řetězec nebo null, když kontakt nemá evidovaný e-mail.

  • Pole: organization

    Typ: Řetězec nebo null, když kontakt nemá evidovanou organizaci.

{
"items": [
{ "contactId": "1anq5bsl9haBy21rOV9aeDWrARBsV", "name": "Ada Lovelace", "email": "ada@example.com", "organization": "Analytical Engines" }
],
"total": 1
}

Domény

Vstupy názvů domén (domain/domainName) přijímají Unicode (IDN) nebo ASCII (A-label) — v obou případech nástroj před použitím automaticky normalizuje název na punycode. domains_check_availability navíc vyžaduje TLD, které Spaceship podporuje pro registraci: doména, jejíž TLD není podporováno, je nahlášena jako nedostupná místo toho, aby byla zkontrolována. Ostatní nástroje pro domény (domains_list, domain_set_contacts, domain_set_nameservers) a nástroje DNS pouze normalizují název a nikdy jej neodmítnou kvůli podpoře TLD.

domains_list — Seznam domén

Načte stránkovaný seznam vašich domén. Předejte domain, chcete-li místo toho načíst jednu doménu podle názvu (stránkování a řazení se pak ignorují a výsledek obsahuje note, která to uvádí, pokud byly zadány).

  • Parametr: domain

    Povinné: Ne

    Typ & omezení: Plně kvalifikovaný název domény pro načtení jedné domény. Přijímá Unicode (IDN) nebo ASCII (A-label) — automaticky normalizováno na punycode.

  • Parametr: take

    Povinné: Ne

    Typ & omezení: Položek na stránku, 1–100. Výchozí 10.

  • Parametr: skip

    Povinné: Ne

    Typ & omezení: Položky k přeskočení, 0 nebo více. Výchozí 0.

  • Parametr: orderBy

    Povinné: Ne

    Typ & omezení: Až 8 klíčů řazení: name, unicodeName, registrationDate, expirationDate; předpona - pro sestupné řazení (např. -expirationDate).

Vrací — { items, total } kde každá položka popisuje doménu:

  • Pole: name / unicodeName

    Význam: Název domény ve formátu ASCII a Unicode.

  • Pole: isPremium

    Význam: Zda je doména prémiový název.

  • Pole: autoRenew

    Význam: Zda je povoleno automatické obnovení.

  • Pole: registrationDate / expirationDate

    Význam: Časová razítka registrace a expirace.

  • Pole: lifecycleStatus

    Význam: creating, registered, grace1, grace2 nebo redemption.

  • Pole: verificationStatus

    Význam: verification, success, failed nebo null, pokud se nepoužije.

  • Pole: eppStatuses

    Význam: Kódy stavu registru (např. zámky převodu).

  • Pole: suspensions

    Význam: Aktivní pozastavení, každé s reasonCode.

  • Pole: privacyProtection

    Význam: { level: "public" | "high", contactForm: boolean }.

  • Pole: nameservers

    Význam: { provider: "basic" | "custom", hosts: [...] }.

  • Pole: contacts

    Význam: ID kontaktů: registrant, plus admin/tech/billing (může být null) a attributes (seznam ID kontaktů rozšířených atributů nebo null). Čitelné přes contacts_get.

Spaceship MCP vyplňuje každé výše uvedené pole — včetně contacts, eppStatuses, suspensions, verificationStatus, nameservers, skutečného autoRenew a odlišného unicodeName, pokud jej doména má — jak pro seznam s více položkami, tak pro načtení jedné domény.

domains_check_availability — Kontrola dostupnosti domény

Kontroluje, zda je možné zaregistrovat jeden nebo více názvů domén. Pro jeden název používá endpoint pro jednu doménu a pro více názvů hromadný endpoint. Doména, jejíž TLD není podporováno pro registraci, se do kontroly dostupnosti vůbec neposílá — je okamžitě vrácena jako tldNotSupported.

  • Parametr: domains

    Povinné: Ano

    Typ & omezení: 1–20 plně kvalifikovaných názvů domén. Každý přijímá Unicode (IDN) nebo ASCII (A-label) — automaticky normalizováno na punycode.

Vrací — { results }, jednu položku pro každý požadovaný název:

  • Pole: domain

    Význam: Kontrolovaný název.

  • Pole: result

    Význam: available, taken, invalidDomainName, tldNotSupported nebo unexpectedError.

  • Pole: premiumPricing

    Význam: Pro prémiové názvy: seznam { operation, price, currency }, kde operation je register, transfer, renew nebo restore. Pro běžné názvy je prázdný.

  • Pole: price

    Význam: Pro dostupné názvy (standardní i prémiové): cena v USD za registraci domény na nejkratší období, které TLD umožňuje — { amount, currency: "USD", pricedYears?, pricePerYear?, icannFee?, isPremium }. amount je celková splatná částka za celé toto období; pricedYears uvádí, kolik let pokrývá. Není uváděna žádná cena před slevou ani cena „původně“. icannFee je poplatek ICANN (USD) již zahrnutý v amount, vrácený samostatně, aby bylo možné vysvětlit rozpis; objevuje se pouze tehdy, když TLD nese poplatek.

  • Pole: pricePerYear

    Význam: Uvnitř price: amount děleno pricedYears, takže je pro porovnání vždy k dispozici roční údaj. Když je pricedYears 1, jde o skutečnou cenu za jeden rok; při vyšší hodnotě jde o průměr za rok v rámci daného období, nikoli o období, které by bylo možné koupit.

  • Pole: minRegisterPeriodInYears / maxRegisterPeriodInYears

    Význam: Pro dostupné názvy: nejkratší a nejdelší registrační období, které dané TLD skutečně povoluje, jako dvě prostá čísla. Zákazníkovi říkají, na jaká období si může doménu koupit. Obojí je vynecháno, pokud nebylo možné povolené období určit.

  • Pole: priceUnavailableReason

    Význam: Přítomno místo price, pokud nebylo možné určit cenu pro dostupný název. Samotná kontrola je přesto úspěšná.

Cenu mají pouze dostupné názvy; výsledky taken/invalid neobsahují ani price, ani priceUnavailableReason.

Většina TLD umožňuje jeden rok, ale některé ne..ai má například minimálně dva roky. U takových TLD je price.amount celková částka za minimální období — nikoli cena za jeden rok, kterou by bylo možné využít — a price.pricedYears to uvádí:

{
"domain": "example.ai",
"result": "available",
"premiumPricing": [],
"price": { "amount": 159.96, "currency": "USD", "pricedYears": 2, "pricePerYear": 79.98, "isPremium": false },
"minRegisterPeriodInYears": 2,
"maxRegisterPeriodInYears": 10
}

pricePerYear je zde přítomno — 159.96 děleno dvěma roky, které pokrývá, dává 79.98. Jde o celkovou částku dělenou obdobím, nikoli o cenu, kterou by bylo možné zaplatit za jeden rok (jednoletou registraci .ai nelze koupit). Vždy zobrazujte amount společně s pricedYears („159.96 USD za 2 roky“), nikdy ne samotné amount. U běžného TLD je pricedYears1 a pricePerYear se rovná amount.

domain_set_contacts — Nastavit kontakty domény

Změní kontakty přiřazené k doméně, kterou vlastníte. Dokončí se okamžitě (žádná operace ke zjišťování stavu).

  • Parametr: domainName

    Povinné: Ano

    Typ & omezení: Plně kvalifikovaný název domény. Přijímá Unicode (IDN) nebo ASCII (A-label) — automaticky normalizováno na punycode.

  • Parametr: registrant

    Povinné: Ano

    Typ & omezení: contactId řetězec (27–32 alfanumerických znaků), z contacts_save.

  • Parametr: admin

    Povinné: Ne

    Typ & omezení: contactId řetězec (27–32 alfanumerických znaků) nebo null.

  • Parametr: tech

    Povinné: Ne

    Typ & omezení: contactId řetězec (27–32 alfanumerických znaků) nebo null.

  • Parametr: billing

    Povinné: Ne

    Typ & omezení: contactId řetězec (27–32 alfanumerických znaků) nebo null.

  • Parametr: attributes

    Povinné: Ne

    Typ & omezení: Pole ID kontaktů rozšířených atributů (až 5); vyžadováno pouze pro některé TLD, jinak vynechte nebo použijte null.

Vrací

{ "verificationStatus": "verification" }

Vrácený verificationStatus odráží ověření e-mailu ICANN RAA: verification — držitel registrace musí potvrdit svou e-mailovou adresu (je odeslán potvrzovací e-mail); success — již potvrzeno; null — ověření RAA se na tuto doménu nevztahuje.

domain_set_nameservers — Nastavit nameservery domény

Změní nameservery domény na úrovni registrátora. Dokončí se okamžitě (žádná operace ke zjišťování stavu). Změna se následně projeví v domains_list.

  • Parametr: domainName

    Povinné: Ano

    Typ & omezení: Plně kvalifikovaný název domény. Přijímá Unicode (IDN) nebo ASCII (A-label) — automaticky normalizováno na punycode.

  • Parametr: provider

    Povinné: Ano

    Typ & omezení: basic (výchozí nameservery Spaceship) nebo custom (vaši vlastní hostitelé).

  • Parametr: hosts

    Povinné: Podmíněně

    Typ a omezení: Povinné, když provider je custom: 2–12 hostname nameserverů (každý platný FQDN, 4–255 znaků). Musí být vynecháno, když provider je basic.

Vrací

{ "provider": "custom", "hosts": ["ns1.example.com", "ns2.example.com"] }

Opětovné použití stavu, ve kterém už doména je (např. nastavení basic, když už je basic), vrátí chybu validace namísto úspěchu bez provedení akce — považujte to za očekávaný výsledek, ne za selhání vyžadující opakování.

DNS záznamy

Hodnota domainName, kterou tyto nástroje přijímají, podporuje Unicode (IDN) nebo ASCII (A-label) a automaticky se normalizuje na punycode; podpora TLD zde není vynucována.

dns_records_get — Získat DNS záznamy

Načte stránkovaný seznam DNS resource záznamů pro doménu.

  • Parametr: domainName

    Povinné: Ano

    Typ a omezení: Doména, jejíž záznamy se mají načíst.

  • Parametr: take

    Povinné: Ne

    Typ a omezení: Počet položek na stránku, 1–500. Výchozí hodnota 100.

  • Parametr: skip

    Povinné: Ne

    Typ a omezení: Počet položek k přeskočení, 0 nebo více. Výchozí hodnota 0.

  • Parametr: orderBy

    Povinné: Ne

    Typ a omezení: Až 8 klíčů řazení: type, -type, name, -name.

Vrací — { items, total }. Každá položka je záznam, jak je popsáno v části Tvary záznamů, plus volitelné pole group označující, odkud záznam pochází (custom — vytvořeno vámi, product — spravováno produktem Spaceship, personalNs — osobní nameservery).

dns_records_save — Uložit DNS záznamy

Přidá vlastní DNS záznamy nebo aktualizuje TTL existujících. Záznamy se porovnávají bez ohledu na velikost písmen, kromě TXT záznamů (rozlišují velikost písmen).

  • Parametr: domainName

    Povinné: Ano

    Typ a omezení: Doména, jejíž záznamy se mají aktualizovat.

  • Parametr: records

    Povinné: Ano

    Typ a omezení: 1–500 záznamů — viz Tvary záznamů. Každý může obsahovat volitelné ttl.

  • Parametr: force

    Povinné: Ne

    Typ a omezení: Boolean. Přeskočí kontrolu řešení konfliktů a vynutí aktualizaci zóny.

Vrací — { "saved": <number> }, počet odeslaných záznamů. Úspěšná odpověď znamená, že byly přijaty všechny záznamy; pokud některý záznam selže, celé volání místo toho vrátí chybu.

dns_records_delete — Smazat DNS záznamy

Maže vlastní DNS záznamy. Smazání nelze vrátit zpět. Záznamy se porovnávají bez ohledu na velikost písmen, kromě TXT záznamů (rozlišují velikost písmen).

  • Parametr: domainName

    Povinné: Ano

    Typ a omezení: Doména, jejíž záznamy se mají smazat.

  • Parametr: records

    Povinné: Ano

    Typ a omezení: 1–500 záznamů identifikujících existující záznamy — stejné tvary jako pro uložení, ale bez ttl.

Vrací — { "deleted": <number> }, počet odeslaných záznamů. Pokud nelze některý záznam spárovat, celé volání selže a nic se nesmaže.

Tvary záznamů

Každý záznam má:

  • type — jeden z 13 podporovaných typů níže.

  • name — název záznamu bez domény: použijte @ pro samotnou doménu (apex) a * pro zástupný znak.

  • ttl (pouze při uložení, volitelné) — doba cache v sekundách, 60–3600.

Pole specifická pro typ:

  • Typ: A

    Pole: address — IPv4 adresa.

  • Typ: AAAA

    Pole: address — IPv6 adresa.

  • Typ: CNAME

    Pole: cname — kanonický název domény (max. 253 znaků).

  • Typ: ALIAS

    Pole: aliasName — kanonický název domény; chování podobné CNAME pro apex, kde CNAME není povoleno.

  • Typ: NS

    Pole: nameserver — název nameserveru.

  • Typ: PTR

    Pole: pointer — název domény pro danou IP adresu.

  • Typ: TXT

    Pole: value — textová hodnota (porovnává se s rozlišením velikosti písmen).

  • Typ: MX

    Pole: exchange — poštovní server; preference — priorita (0–65535, nižší je preferována).

  • Typ: CAA

    Pole: flag — 0 nebo 128 (kritický bit); tag — issue, issuewild nebo iodef; value — identifikátor CA s volitelnými parametry.

  • Typ: SRV

    Pole: service (např. _sip); protocol (např. _tcp); priority a weight (0–65535); port (1–65535); target — název domény serveru.

  • Typ: TLSA

    Pole: usage, selector, matching (každé 0–255); port — * nebo _<1–65535>; protocol (např. _tcp); associationData — hash certifikátu nebo data.

  • Typ: HTTPS

    Pole: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN nebo .; volitelné port (* nebo _<1–65535>), scheme (musí být _https, když je nastaveno port), svcParams.

  • Typ: SVCB

    Pole: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN nebo .; volitelné port, scheme (např. _tcp), svcParams.

Asynchronní operace

async_operation_get — Získat stav asynchronní operace

Kontroluje dlouho běžící operaci na vašem účtu podle jejího operationId. Volejte opakovaně, dokud status nebude success nebo failed.

  • Parametr: operationId

    Povinné: Ano

    Typ a omezení: Alfanumerický řetězec, max. 36 znaků, vrácený nástrojem, který operaci spustil.

Vrací

  • Pole: operationId

    Význam: Dotazovaná operace.

  • Pole: status

    Význam: pending, success nebo failed.

  • Pole: type

    Význam: Typ operace nebo null.

  • Pole: details

    Význam: Další podrobnosti o operaci nebo null.

  • Pole: createdAt / modifiedAt

    Význam: Kdy byla operace vytvořena / naposledy aktualizována (modifiedAt může být null).

Chyby

Když volání selže, nástroj vrátí chybu s kódem a lidsky čitelným polem detail vysvětlujícím, co se pokazilo — například neplatný vstup (chybně vytvořený název domény nebo ID kontaktu), doména nebo kontakt, který neexistuje, nebo konflikt s aktuálním stavem. Pokud je nástroj odmítnut, protože asistent k němu nedostal přístup, znovu připojte Spaceship MCP a schvalte přístup, o který žádá.

Je vyžadována platná e-mailová adresa