Spaceship MCP Connector, AI asistanınızı (örneğin Claude) Spaceship hesabınıza bağlar. Bu sayede asistan, alan adı uygunluğunu ve fiyatlarını kontrol edebilir, alan adı kişilerini ve ad sunucularını yönetebilir ve sizin adınıza DNS kayıtlarını okuyabilir veya düzenleyebilir — siz sadece sade bir dille istersiniz, asistan da doğru araçları çağırır.
Spaceship MCP Connector alan adı satın almaz. Asistan bir adın uygun olup olmadığını ve ne kadara mal olduğunu kontrol edebilir, ancak satın alma işleminin kendisi spaceship.com üzerinde gerçekleşir.
Bir Spaceship hesabına ihtiyacınız var. Spaceship MCP Connector şu adreste kullanılabilir: https://connector-mcp.spaceship.com/mcp.
Claude (web ve masaüstü) — Ayarlar'ı açın, Connectors'ı seçin, bağlayıcılar dizininde Spaceship'i bulun ve ekleyin. Anthropic'in Claude'u şu anda Spaceship MCP Connector ile çalıştığını doğruladığımız istemcidir.
Diğer MCP istemcileri — uzak bir MCP sunucusu ekleyin ve bunu https://connector-mcp.spaceship.com/mcp adresine yönlendirin. Diğer istemciler çalışabilir, ancak henüz doğrulamadık.
Bağlandığınızda, Spaceship'te oturum açmanız ve asistana hesabınıza erişim vermeniz istenir. Asistanın hangi araçları kullanabileceği, onayladığınız erişime bağlıdır — bir araç erişim verilmediği için reddedilirse yeniden bağlanın ve ihtiyaç duyduğu erişimi onaylayın.
Araç: contacts_save
Ne yapar: İletişim bilgilerini kaydeder ve bir iletişim kimliği alır
Araç: contacts_get
Ne yapar: Kayıtlı bir kişiyi kimliğine göre okur
Araç: contacts_list
Ne yapar: Birini bulup yeniden kullanmak için tüm kayıtlı kişileri listeler
Araç: domains_list
Ne yapar: Alan adlarınızı listeler veya tek bir alan adını arar
Araç: domains_check_availability
Ne yapar: Alan adlarının kayda uygun olup olmadığını ve fiyatlarını kontrol eder
Araç: domain_set_contacts
Ne yapar: Sahip olduğunuz bir alan adına kişi atar
Araç: domain_set_nameservers
Ne yapar: Bir alan adını temel veya özel ad sunucularına geçirir
Araç: dns_records_get
Ne yapar: Bir alan adının DNS kayıtlarını okur
Araç: dns_records_save
Ne yapar: DNS kayıtları ekler veya TTL'lerini günceller
Araç: dns_records_delete
Ne yapar: DNS kayıtlarını siler
Araç: async_operation_get
Ne yapar: Uzun süren bir işlemin durumunu kontrol eder
Bu araçların hiçbiri hesabınızdan ücret almaz.
Bir kişi gerektiğinde (domain_set_contacts), her rol bir contactId dizesi alır — kişi ayrıntılarını asla satır içi vermeyin. Önce kişiyi contacts_save ile kaydedin (bu işlem onun contactId değerini döndürür), ardından bu kimliği kişinin kabul edildiği yerde iletin. Satır içi otomatik kaydetme yoktur; bir rol tam bir kişi nesnesi alamaz. Ayrıca bir contactId değerini contacts_list sonucundan veya domains_list sonucunda gördüğünüz bir değerden yeniden kullanabilirsiniz.
Bir contactId, 27–32 alfasayısal karakterden oluşan bir dizedir. Bir kişinin kabul edildiği yerde bunu geri iletmeniz yeterlidir.
Birkaç araç birlikte kullanılmak üzere tasarlanmıştır: birinin çıktısı, sonrakinin girdisi olur.
domains_check_availability — istediğiniz ad(lar)ı kontrol edin. Kullanılabilir her ad, kaydetme için USD price değerini içerir (standart ve premium dahil) veya belirlenemediğinde priceUnavailableReason, ayrıca minRegisterPeriodInYears ve maxRegisterPeriodInYears — TLD'nin izin verdiği süreler. price değerinin price.pricedYears yılı kapsadığını unutmayın; bu, TLD'nin izin verdiği en kısa süredir ve her zaman 1 değildir.
Bunu spaceship.com üzerinden satın alın. Hiçbir araç bir alan adını kaydetmez veya ödeme bağlantısı üretmez; bu nedenle asistan satın alma işlemini tamamlayamaz ya da konuşmadan bir alan adının kaydedildiğini söyleyemez. Satın alma tamamlandıktan sonra, domains_list yeni alan adını gösterir.
domain_set_contacts — kişileri alan adına contactId ile atayın (gerekirse önce contacts_save ile kaydedin). Bu işlem hemen tamamlanır ve bir verificationStatus döndürür: verification, değişikliğin tam olarak uygulanabilmesi için kayıt sahibinin e-posta adresini onaylaması gerektiği anlamına gelir (kendisine bir e-posta gönderilir); success bunun zaten onaylandığı anlamına gelir ve null bu alan adı için onay gerekmediği anlamına gelir.
domains_list — alan adını bulun ve mevcut nameservers değerlerini görün ({ provider, hosts }).
domain_set_nameservers — bunu, Spaceship'in varsayılan nameserver'larına provider: "basic" ile geçirin (hosts yok) veya provider: "custom" ve 2–12 hosts listesi ile kendi nameserver'larınıza yönlendirin. Sonuçta oluşan { provider, hosts } değerini döndürür ve sonraki bir domains_list değişikliği yansıtır. Bir alan adının zaten içinde bulunduğu durumu yeniden uygulamak, etkisiz bir işlem yerine doğrulama hatası döndürür — bunu yeniden deneme gerektiren bir başarısızlık değil, beklenen bir durum olarak değerlendirin.
domains_list — yönetmek istediğiniz alan adını bulun (veya biliyorsanız adını doğrudan iletin).
dns_records_get — alan adının mevcut kayıtlarını okuyun.
dns_records_save veya dns_records_delete — kayıt ekleyin, güncelleyin veya kaldırın. dns_records_get tarafından döndürülen kayıtlar, kaydetme ve silme araçlarının kabul ettiğiyle aynı şekle sahiptir (silme yalnızca ttl değerini çıkarır), bu nedenle asistan okuyabilir, ayarlayabilir ve geri yazabilir. Eşleştirme, büyük/küçük harfe duyarlı olan TXT kayıtları dışında büyük/küçük harf duyarsızdır.
domains_list — sıralama ile tüm alan adlarınız arasında sayfalayın veya ada göre tek bir alan adını alın. Her alan adı, sona erme tarihi, otomatik yenileme ayarı, durum, nameserver'lar, gizlilik koruması ve atanmış kişi kimliklerini içerir.
contacts_list — hesabınıza kaydedilmiş tüm kişiler arasında sayfalayarak mevcut bir kişiyi bulup yeniden kullanın (kişi kimliğine göre), böylece yinelenen bir kayıt oluşturmazsınız.
contacts_get — bir alan adında veya contacts_list sonucunda gördüğünüz herhangi bir kişi kimliğinin arkasındaki ayrıntıları görüntüleyin.
Her araç sonucunu yapılandırılmış JSON olarak döndürür ve her araç hemen tamamlanır.
Kişiler, bir alan adı kaydına bağlı kişi veya kuruluşlardır (kayıt sahibi, yönetici, teknik, faturalama). Bir kişiye her yerde kişi kimliği ile referans verilir — opak bir dize.
contacts_save — Kişiyi KaydetKişi ayrıntılarını kaydeder ve oluşturulan kişi kimliğini döndürür. Bazı alanların doğrulanması (örneğin stateProvince ve postalCode) seçilen ülkeye bağlıdır.
Parametre: firstName
Gerekli: Evet
Tür ve kısıtlamalar: Dize, 1–64 karakter. Tire ve kesme işareti içerebilir.
Parametre: lastName
Gerekli: Evet
Tür ve kısıtlamalar: Dize, 1–64 karakter. Tire ve kesme işareti içerebilir.
Parametre: email
Gerekli: Evet
Tür ve kısıtlamalar: Geçerli e-posta adresi, en fazla 254 karakter.
Parametre: address1
Gerekli: Evet
Tür ve kısıtlamalar: Adres satırı 1. Dize, 1–128 karakter.
Parametre: city
Gerekli: Evet
Tür ve kısıtlamalar: Dize, 1–64 karakter.
Parametre: country
Gerekli: Evet
Tür ve kısıtlamalar: İki harfli ülke kodu (ISO 3166-1 alpha-2), ör. US.
Parametre: phone
Gerekli: Evet
Tür ve kısıtlamalar: Uluslararası format +CountryCode.Number, ör. +1.2025551234. En fazla 32 karakter.
Parametre: organization
Gerekli: Hayır
Tür ve kısıtlamalar: Kuruluş/şirket adı. 1–128 karakter.
Parametre: address2
Gerekli: Hayır
Tür ve kısıtlamalar: Adres satırı 2. 1–128 karakter.
Parametre: stateProvince
Gerekli: Hayır
Tür ve kısıtlamalar: Eyalet/il adı, 1–64 karakter. Ülkeye bağlı olarak gerekli olabilir.
Parametre: postalCode
Gerekli: Hayır
Tür ve kısıtlamalar: 1–16 karakter. Ülkeye bağlı olarak gerekli olabilir.
Parametre: phoneExt
Gerekli: Hayır
Tür ve kısıtlamalar: Telefon dahili numarası, 1–16 karakter.
Parametre: fax
Gerekli: Hayır
Tür ve kısıtlamalar: Faks numarası, aynı +CountryCode.Number formatında, en fazla 32 karakter.
Parametre: faxExt
Gerekli: Hayır
Tür ve kısıtlamalar: Faks dahili numarası, 1–16 karakter.
Parametre: taxNumber
Gerekli: Hayır
Tür ve kısıtlamalar: Vergi numarası, 1–32 karakter.
Döndürür
{ "contactId": "..." }
contactId (27–32 alfasayısal karakter), domain_set_contacts ve contacts_get için ilettiğiniz değerdir.
contacts_get — Kişiyi GetirKayıtlı bir kişinin ayrıntılarını kişi kimliğine göre okur. Kişi kimlikleri contacts_save, contacts_list veya contacts alanından, domains_list sonuçları içinden gelir.
Parametre: contactId
Gerekli: Evet
Tür ve kısıtlamalar: Kişi kimliği, 27–32 alfasayısal karakter.
Döndürür — { contact } şu alanlarla:
Alan: firstName, lastName, email, address1, city, country, phone, postalCode
Tür: Dize
Alan: organization, address2, stateProvince, phoneExt, fax, faxExt, taxNumber
Tür: Dize veya null
contacts_list — Kişileri ListeleHesabınız altında kayıtlı tüm kişileri listeler; böylece yinelenen bir kayıt oluşturmak veya alan adlarınız arasında aramak yerine mevcut bir kişiyi (kişi kimliğine göre) bulup yeniden kullanabilirsiniz. Liste sayfalandırılmıştır ve sıralanabilir; domains_list ile tutarlıdır.
Parametre: take
Gerekli: Hayır
Tür ve kısıtlamalar: Sayfa başına öğe, 1–100. Varsayılan 10.
Parametre: skip
Gerekli: Hayır
Tür ve kısıtlamalar: Atlanacak öğe sayısı, 0 veya daha fazla. Varsayılan 0.
Parametre: orderBy
Gerekli: Hayır
Tür ve kısıtlamalar: En fazla 8 sıralama anahtarı: name, email, organization; azalan sıralama için başına - ekleyin (ör. -name).
Döndürür — { items, total } burada total, hesaptaki benzersiz kişi sayısıdır (sayfa boyutu değil, kişi kimliğine göre tekilleştirilmiş) ve her öğe, ek bir çağrı yapmadan kişileri birbirinden ayırmaya yetecek kadar bilgi taşır. Hesapta aynı kişi kimliği için yinelenen girişler varsa bunlar tek bir girişe indirgenir; bu nedenle total ham sunucu tarafı satırları değil, farklı kişileri sayar:
Alan: contactId
Tür: Dize (27–32 alfasayısal). contacts_get veya domain_set_contacts için iletin.
Alan: name
Tür: Dize — kişinin adı.
Alan: email
Tür: Dize veya kişi için kayıtlı e-posta yoksa null.
Alan: organization
Tür: Dize veya kişi için kayıtlı kuruluş yoksa null.
{"items": [{ "contactId": "1anq5bsl9haBy21rOV9aeDWrARBsV", "name": "Ada Lovelace", "email": "ada@example.com", "organization": "Analytical Engines" }],"total": 1}
Alan adı girdileri (domain/domainName) Unicode (IDN) veya ASCII (A-label) kabul eder — her iki durumda da araç, kullanımdan önce adı otomatik olarak punycode'a dönüştürür. domains_check_availability ayrıca kayıt için Spaceship'in desteklediği bir TLD gerektirir: TLD'si desteklenmeyen bir alan adı kontrol edilmek yerine uygun değil olarak bildirilir. Diğer alan adı araçları (domains_list, domain_set_contacts, domain_set_nameservers) ve DNS araçları yalnızca adı dönüştürür ve TLD desteğine göre asla reddetmez.
domains_list — Alan Adlarını ListeleAlan adlarınızın sayfalandırılmış bir listesini getirir. Bunun yerine ada göre tek bir alan adı getirmek için domain iletin (bu durumda sayfalama ve sıralama yok sayılır; sağlanmışlarsa sonuçta bunu belirten bir note da yer alır).
Parametre: domain
Gerekli: Hayır
Tür ve kısıtlamalar: Tek bir alan adını getirmek için tam nitelikli alan adı. Unicode (IDN) veya ASCII (A-label) kabul eder — otomatik olarak punycode'a dönüştürülür.
Parametre: take
Gerekli: Hayır
Tür ve kısıtlamalar: Sayfa başına öğe, 1–100. Varsayılan 10.
Parametre: skip
Gerekli: Hayır
Tür ve kısıtlamalar: Atlanacak öğe sayısı, 0 veya daha fazla. Varsayılan 0.
Parametre: orderBy
Gerekli: Hayır
Tür ve kısıtlamalar: En fazla 8 sıralama anahtarı: name, unicodeName, registrationDate, expirationDate; azalan sıralama için başına - ekleyin (ör. -expirationDate).
Döndürür — { items, total } burada her öğe bir alan adını açıklar:
Alan: name / unicodeName
Anlamı: Alan adının ASCII ve Unicode biçimi.
Alan: isPremium
Anlamı: Alan adının premium bir ad olup olmadığı.
Alan: autoRenew
Anlamı: Otomatik yenilemenin etkin olup olmadığı.
Alan: registrationDate / expirationDate
Anlamı: Kayıt ve sona erme zaman damgaları.
Alan: lifecycleStatus
Anlamı: creating, registered, grace1, grace2 veya redemption.
Alan: verificationStatus
Anlamı: verification, success, failed veya uygulanmıyorsa null.
Alan: eppStatuses
Anlamı: Kayıt operatörü durum kodları (ör. transfer kilitleri).
Alan: suspensions
Anlamı: Etkin askıya almalar; her biri bir reasonCode içerir.
Alan: privacyProtection
Anlamı: { level: "public" | "high", contactForm: boolean }.
Alan: nameservers
Anlamı: { provider: "basic" | "custom", hosts: [...] }.
Alan: contacts
Anlamı: Kişi kimlikleri: registrant, ayrıca admin/tech/billing (null olabilir) ve attributes (genişletilmiş öznitelik kişi kimliklerinin listesi veya null). contacts_get ile okunabilir.
Spaceship MCP yukarıdaki her alanı doldurur — buna contacts, eppStatuses, suspensions, verificationStatus, nameservers, gerçek bir autoRenew ve alan adında varsa ayrı bir unicodeName da dahildir — hem çok öğeli liste hem de tek alan adı getirme işlemleri için.
domains_check_availability — Alan Adı Uygunluğunu Kontrol EtBir veya daha fazla alan adının kayda uygun olup olmadığını kontrol eder. Tek ad için tek alan adı uç noktasını, birden fazla ad için toplu uç noktayı kullanır. TLD'si kayıt için desteklenmeyen bir alan adı uygunluk kontrolüne hiç gönderilmez — doğrudan tldNotSupported olarak döndürülür.
Parametre: domains
Gerekli: Evet
Tür ve kısıtlamalar: 1–20 tam nitelikli alan adı. Her biri Unicode (IDN) veya ASCII (A-label) kabul eder — otomatik olarak punycode'a dönüştürülür.
Döndürür — { results }, istenen her ad için bir giriş:
Alan: domain
Anlamı: Kontrol edilen ad.
Alan: result
Anlamı: available, taken, invalidDomainName, tldNotSupported veya unexpectedError.
Alan: premiumPricing
Anlamı: Premium adlar için: { operation, price, currency } listesidir; burada operationregister, transfer, renew veya restore olur. Normal adlar için boştur.
Alan: price
Anlamı: available adlar için (standart ve premium): alan adını TLD'nin izin verdiği en kısa süre için kaydetmenin USD fiyatı — { amount, currency: "USD", pricedYears?, pricePerYear?, icannFee?, isPremium }. amount, bu sürenin tamamı için ödenecek toplam tutardır; pricedYears bunun kaç yılı kapsadığını belirtir. İndirim öncesi veya "eski" fiyat bildirilmez. icannFee, amount içine zaten dahil edilmiş ICANN ücretidir (USD); döküm açıklanabilsin diye ayrıca döndürülür ve yalnızca TLD bir ücret taşıdığında görünür.
Alan: pricePerYear
Anlamı: price içinde: amount değerinin pricedYears değerine bölünmüş hali; böylece karşılaştırma için her zaman yıllık bir değer bulunur. pricedYears 1 olduğunda bu gerçek bir yıllık fiyattır; daha yüksek olduğunda ise satın alabileceğiniz bir süre değil, sürenin yıllık ortalamasıdır.
Alan: minRegisterPeriodInYears / maxRegisterPeriodInYears
Anlamı: available adlar için: ilgili TLD'nin gerçekten izin verdiği en kısa ve en uzun kayıt süresi, iki düz sayı olarak. Bunlar müşteriye alan adını hangi sürelerle satın alabileceğini söyler. İzin verilen süre belirlenemediğinde her ikisi de atlanır.
Alan: priceUnavailableReason
Anlamı: Uygun bir ad için fiyat belirlenemediğinde price yerine bulunur. Kontrolün kendisi yine de başarılı olur.
Yalnızca uygun adlar fiyatlandırılır; taken/geçersiz sonuçlar ne price ne de priceUnavailableReason taşır.
Çoğu TLD bir yıla izin verir, ancak bazıları vermez..ai, örneğin, iki yıllık bir minimuma sahiptir. Bunlarda price.amount, işlem yapabileceğiniz bir yıllık fiyat değil, minimum süre için toplam tutardır — ve price.pricedYears bunu belirtir:
{"domain": "example.ai","result": "available","premiumPricing": [],"price": { "amount": 159.96, "currency": "USD", "pricedYears": 2, "pricePerYear": 79.98, "isPremium": false },"minRegisterPeriodInYears": 2,"maxRegisterPeriodInYears": 10}
pricePerYear burada bulunur — 159.96 değerinin kapsadığı iki yıla bölünmesi 79.98 verir. Bu, toplamın süreye bölünmüş halidir; tek bir yıl için ödeyebileceğiniz bir fiyat değildir (bir yıllık .ai kaydı satın alınamaz). Her zaman amount ile birlikte pricedYears gösterin ("2 yıl için $159.96"); asla yalnızca amount göstermeyin. Sıradan bir TLD için pricedYears1 olur ve pricePerYear, amount ile eşittir.
domain_set_contacts — Alan Adı Kişilerini AyarlaSahip olduğunuz bir alan adına atanmış kişileri değiştirir. Hemen tamamlanır (izlenecek bir işlem yoktur).
Parametre: domainName
Gerekli: Evet
Tür ve kısıtlamalar: Tam nitelikli alan adı. Unicode (IDN) veya ASCII (A-label) kabul eder — otomatik olarak punycode'a dönüştürülür.
Parametre: registrant
Gerekli: Evet
Tür ve kısıtlamalar: contactId dizesi (27–32 alfasayısal), contacts_save içinden.
Parametre: admin
Gerekli: Hayır
Tür ve kısıtlamalar: contactId dizesi (27–32 alfasayısal) veya null.
Parametre: tech
Gerekli: Hayır
Tür ve kısıtlamalar: contactId dizesi (27–32 alfasayısal) veya null.
Parametre: billing
Gerekli: Hayır
Tür ve kısıtlamalar: contactId dizesi (27–32 alfasayısal) veya null.
Parametre: attributes
Gerekli: Hayır
Tür ve kısıtlamalar: Genişletilmiş öznitelik kişi kimlikleri dizisi (en fazla 5); yalnızca belirli TLD'ler için gereklidir, aksi halde atlayın veya null kullanın.
Döndürür
{ "verificationStatus": "verification" }
Döndürülen verificationStatus, ICANN RAA e-posta doğrulamasını yansıtır: verification — kayıt sahibi e-posta adresini onaylamalıdır (bir onay e-postası gönderilir); success — zaten onaylanmış; null — RAA doğrulaması bu alan adı için geçerli değildir.
domain_set_nameservers — Alan Adı Ad Sunucularını AyarlaBir alan adının kayıt kuruluşu düzeyindeki ad sunucularını değiştirir. Hemen tamamlanır (izlenecek bir işlem yoktur). Değişiklik daha sonra domains_list tarafından yansıtılır.
Parametre: domainName
Gerekli: Evet
Tür ve kısıtlamalar: Tam nitelikli alan adı. Unicode (IDN) veya ASCII (A-label) kabul eder — otomatik olarak punycode'a dönüştürülür.
Parametre: provider
Gerekli: Evet
Tür ve kısıtlamalar: basic (Spaceship'in varsayılan ad sunucuları) veya custom (kendi ana makineleriniz).
Parametre: hosts
Gerekli: Koşullu
Tür ve kısıtlamalar: providercustom olduğunda gereklidir: 2–12 nameserver ana makine adı (her biri geçerli bir FQDN, 4–255 karakter). providerbasic olduğunda belirtilmemelidir.
Döndürür
{ "provider": "custom", "hosts": ["ns1.example.com", "ns2.example.com"] }
Bir alan adının zaten içinde bulunduğu durumu yeniden uygulamak (ör. zaten basic iken basic ayarlamak), etkisiz bir başarı yerine doğrulama hatası döndürür — bunu yeniden deneme gerektiren bir başarısızlık değil, beklenen bir sonuç olarak değerlendirin.
Bu araçların aldığı domainName Unicode (IDN) veya ASCII (A-label) kabul eder ve otomatik olarak punycode'a normalize edilir; TLD desteği burada zorunlu kılınmaz.
dns_records_get — DNS Kayıtlarını AlBir alan adı için DNS kaynak kayıtlarının sayfalandırılmış listesini alır.
Parametre: domainName
Gerekli: Evet
Tür ve kısıtlamalar: Kayıtları alınacak alan adı.
Parametre: take
Gerekli: Hayır
Tür ve kısıtlamalar: Sayfa başına öğe sayısı, 1–500. Varsayılan 100.
Parametre: skip
Gerekli: Hayır
Tür ve kısıtlamalar: Atlanacak öğeler, 0 veya daha fazla. Varsayılan 0.
Parametre: orderBy
Gerekli: Hayır
Tür ve kısıtlamalar: En fazla 8 sıralama anahtarı: type, -type, name, -name.
Döndürür — { items, total }. Her öğe, Kayıt şekilleri bölümünde açıklandığı gibi bir kayıttır; ayrıca kaydın nereden geldiğini gösteren isteğe bağlı bir group alanı da olabilir (custom — sizin tarafınızdan oluşturuldu, product — bir Spaceship ürünü tarafından yönetiliyor, personalNs — kişisel nameserver'lar).
dns_records_save — DNS Kayıtlarını KaydetÖzel DNS kayıtları ekler veya mevcut kayıtların TTL değerini günceller. Kayıtlar, TXT kayıtları hariç (büyük/küçük harfe duyarlı), büyük/küçük harf duyarsız olarak eşleştirilir.
Parametre: domainName
Gerekli: Evet
Tür ve kısıtlamalar: Kayıtları güncellenecek alan adı.
Parametre: records
Gerekli: Evet
Tür ve kısıtlamalar: 1–500 kayıt — Kayıt şekillerine bakın. Her biri isteğe bağlı bir ttl içerebilir.
Parametre: force
Gerekli: Hayır
Tür ve kısıtlamalar: Boolean. Çakışma çözümleme kontrolünü atlar ve bölge güncellemesini zorlar.
Döndürür — { "saved": <number> }, gönderilen kayıtların sayısı. Başarılı bir yanıt, tüm kayıtların kabul edildiği anlamına gelir; herhangi bir kayıt başarısız olursa, bunun yerine tüm çağrı hata döndürür.
dns_records_delete — DNS Kayıtlarını SilÖzel DNS kayıtlarını siler. Silme işlemleri geri alınamaz. Kayıtlar, TXT kayıtları hariç (büyük/küçük harfe duyarlı), büyük/küçük harf duyarsız olarak eşleştirilir.
Parametre: domainName
Gerekli: Evet
Tür ve kısıtlamalar: Kayıtları silinecek alan adı.
Parametre: records
Gerekli: Evet
Tür ve kısıtlamalar: Mevcut kayıtları tanımlayan 1–500 kayıt — kaydetme ile aynı şekiller, ancak ttl olmadan.
Döndürür — { "deleted": <number> }, gönderilen kayıtların sayısı. Herhangi bir kayıt eşleştirilemezse, tüm çağrı başarısız olur ve hiçbir şey silinmez.
Her kayıtta şunlar bulunur:
type — aşağıda desteklenen 13 türden biri.
name — alan adı hariç kayıt adı: alan adının kendisi (apex) için @ ve joker karakter için * kullanın.
ttl (yalnızca kaydetme, isteğe bağlı) — saniye cinsinden önbellek süresi, 60–3600.
Türe özgü alanlar:
Tür: A
Alanlar: address — IPv4 adresi.
Tür: AAAA
Alanlar: address — IPv6 adresi.
Tür: CNAME
Alanlar: cname — kanonik alan adı (en fazla 253 karakter).
Tür: ALIAS
Alanlar: aliasName — kanonik alan adı; CNAME'e izin verilmeyen apex için CNAME benzeri davranış.
Tür: NS
Alanlar: nameserver — nameserver adı.
Tür: PTR
Alanlar: pointer — verilen IP adresi için alan adı.
Tür: TXT
Alanlar: value — metin değeri (büyük/küçük harfe duyarlı olarak eşleştirilir).
Tür: MX
Alanlar: exchange — posta sunucusu; preference — öncelik (0–65535, düşük olan tercih edilir).
Tür: CAA
Alanlar: flag — 0 veya 128 (kritik bit); tag — issue, issuewild veya iodef; value — isteğe bağlı parametrelerle CA tanımlayıcısı.
Tür: SRV
Alanlar: service (ör. _sip); protocol (ör. _tcp); priority ve weight (0–65535); port (1–65535); target — sunucu alan adı.
Tür: TLSA
Alanlar: usage, selector, matching (her biri 0–255); port — * veya _<1–65535>; protocol (ör. _tcp); associationData — sertifika karması veya verisi.
Tür: HTTPS
Alanlar: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN veya .; isteğe bağlı port (* veya _<1–65535>), scheme (_https olmalıdır, port ayarlandığında), svcParams.
Tür: SVCB
Alanlar: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN veya .; isteğe bağlı port, scheme (ör. _tcp), svcParams.
async_operation_get — Eşzamansız İşlem Durumunu AlHesabınızdaki uzun süren bir işlemi operationId ile kontrol eder. statussuccess veya failed olana kadar bunu tekrar tekrar çağırın.
Parametre: operationId
Gerekli: Evet
Tür ve kısıtlamalar: Alfasayısal dize, en fazla 36 karakter; işlemi başlatan araç tarafından döndürülür.
Döndürür
Alan: operationId
Anlamı: Sorgulanan işlem.
Alan: status
Anlamı: pending, success veya failed.
Alan: type
Anlamı: İşlem türü veya null.
Alan: details
Anlamı: İşlemle ilgili ek ayrıntılar veya null.
Alan: createdAt / modifiedAt
Anlamı: İşlemin oluşturulduğu / son güncellendiği zaman (modifiedAt değeri null olabilir).
Bir çağrı başarısız olduğunda, araç neyin yanlış gittiğini açıklayan bir kod ve insan tarafından okunabilir bir detail ile hata döndürür — örneğin geçersiz girdi (hatalı biçimlendirilmiş bir alan adı veya kişi kimliği), mevcut olmayan bir alan adı ya da kişi veya mevcut durumla bir çakışma. Bir araç, asistana erişim verilmediği için reddedilirse, Spaceship MCP'ye yeniden bağlanın ve istediği erişimi onaylayın.