Referência de ferramentas do Spaceship MCP Connector

O Spaceship MCP Connector liga o teu assistente de IA (como o Claude) à tua conta Spaceship. Através dele, o assistente pode verificar a disponibilidade e os preços de domínios, gerir contactos e nameservers de domínios e ler ou editar registos DNS em teu nome — basta pedires em linguagem simples, e o assistente chama as ferramentas certas.

O Spaceship MCP Connector não compra domínios. O assistente pode verificar se um nome está disponível e quanto custa, mas a compra em si acontece em spaceship.com.

Primeiros passos

Precisas de uma conta Spaceship. O Spaceship MCP Connector está disponível em https://connector-mcp.spaceship.com/mcp.

  • Claude (web e desktop) — abre as Definições, escolhe Connectors, encontra o Spaceship no diretório de conectores e adiciona-o. O Claude da Anthropic é atualmente o cliente que verificámos funcionar com o Spaceship MCP Connector.

  • Outros clientes MCP — adiciona um servidor MCP remoto e aponta-o para https://connector-mcp.spaceship.com/mcp. Outros clientes podem funcionar, mas ainda não os verificámos.

Quando te ligares, ser-te-á pedido que inicies sessão na Spaceship e concedas ao assistente acesso à tua conta. As ferramentas que o assistente pode usar dependem do acesso que aprovares — se uma ferramenta for rejeitada porque o acesso não foi concedido, volta a ligar-te e aprova o acesso de que precisa.

Ferramentas em resumo

  • Ferramenta: contacts_save

    O que faz: Guarda os dados de contacto e obtém um ID de contacto

  • Ferramenta: contacts_get

    O que faz: Lê um contacto guardado através do respetivo ID

  • Ferramenta: contacts_list

    O que faz: Lista todos os contactos guardados para encontrares e reutilizares um

  • Ferramenta: domains_list

    O que faz: Lista os teus domínios ou procura um domínio

  • Ferramenta: domains_check_availability

    O que faz: Verifica se os domínios estão disponíveis para registo e o respetivo preço

  • Ferramenta: domain_set_contacts

    O que faz: Atribui contactos a um domínio que te pertence

  • Ferramenta: domain_set_nameservers

    O que faz: Muda um domínio para nameservers básicos ou personalizados

  • Ferramenta: dns_records_get

    O que faz: Lê registos DNS de um domínio

  • Ferramenta: dns_records_save

    O que faz: Adicionar registos DNS ou atualizar o TTL

  • Ferramenta: dns_records_delete

    O que faz: Eliminar registos DNS

  • Ferramenta: async_operation_get

    O que faz: Verificar o estado de uma operação de longa duração

Nenhuma destas ferramentas cobra na tua conta.

Contactos: referenciados por ID

Sempre que for necessário um contacto (domain_set_contacts), cada função recebe uma contactId string — nunca detalhes de contacto inline. Guarda primeiro o contacto com contacts_save (que devolve o respetivo contactId) e depois passa esse ID onde o contacto for aceite. Não existe gravação automática inline; uma função não pode receber um objeto de contacto completo. Também podes reutilizar um contactId de um resultado de contacts_list ou um que leias num resultado de domains_list.

Um contactId é uma cadeia de 27–32 caracteres alfanuméricos. Basta passá-lo de volta onde um contacto for aceite.

Fluxos de trabalho comuns

Várias ferramentas foram concebidas para serem usadas em conjunto: o resultado de uma torna-se a entrada da seguinte.

Encontrar um domínio para comprar

  1. domains_check_availability — verifica o(s) nome(s) que queres. Cada nome disponível inclui o price em USD para o registar (tanto standard como premium), ou priceUnavailableReason quando não pode ser determinado, além de minRegisterPeriodInYears e maxRegisterPeriodInYears — os prazos que o TLD permite. Tem em conta que o price cobre price.pricedYears anos, que é o prazo mínimo permitido pelo TLD e nem sempre é 1.

  2. Compra-o em spaceship.com. Nenhuma ferramenta regista um domínio nem produz uma ligação de checkout, por isso o assistente não pode concluir a compra nem dizer que um domínio foi registado a partir da conversa. Quando a compra estiver concluída, domains_list mostra o novo domínio.

Atualizar os contactos de um domínio que possuis

  1. domain_set_contacts — atribui contactos ao domínio por contactId (guarda-os primeiro com contacts_save, se necessário). Isto conclui-se imediatamente e devolve um verificationStatus: verification significa que o titular tem de confirmar o respetivo endereço de email antes de a alteração ser totalmente aplicada (é-lhe enviado um email), success significa que já está confirmado e null significa que não é necessária confirmação para esse domínio.

Alterar os servidores de nomes de um domínio

  1. domains_list — encontra o domínio e vê os respetivos nameservers atuais ({ provider, hosts }).

  2. domain_set_nameservers — muda-o para os servidores de nomes predefinidos da Spaceship com provider: "basic" (sem hosts), ou aponta-o para os teus com provider: "custom" e uma lista de 2–12 hosts. Devolve o resultado { provider, hosts }, e uma chamada posterior a domains_list reflete a alteração. Voltar a aplicar o estado em que um domínio já se encontra devolve um erro de validação em vez de uma operação sem efeito — trata isso como esperado, não como uma falha que deva ser repetida.

Gerir registos DNS

  1. domains_list — encontra o domínio que queres gerir (ou passa diretamente o respetivo nome, se o souberes).

  2. dns_records_get — lê os registos atuais do domínio.

  3. dns_records_save ou dns_records_delete — adiciona, atualiza ou remove registos. Os registos devolvidos por dns_records_get têm o mesmo formato que as ferramentas de guardar e eliminar aceitam (eliminar apenas omite ttl), por isso o assistente pode ler, ajustar e voltar a escrever. A correspondência não distingue maiúsculas de minúsculas, exceto nos registos TXT, que são sensíveis a maiúsculas e minúsculas.

Rever o teu portefólio

  • domains_list — percorre todos os teus domínios com ordenação, ou obtém um único domínio pelo nome. Cada domínio inclui a data de expiração, a definição de renovação automática, o estado, os servidores de nomes, a proteção de privacidade e os IDs de contacto atribuídos.

  • contacts_list — percorre todos os contactos guardados na tua conta para encontrar e reutilizar um existente (pelo respetivo ID de contacto) em vez de criar um duplicado.

  • contacts_get — consulta os detalhes por trás de qualquer ID de contacto que vejas num domínio ou num resultado de contacts_list.

Referência das ferramentas

Todas as ferramentas devolvem o respetivo resultado como JSON estruturado, e todas concluem imediatamente.

Contactos

Os contactos são as pessoas ou organizações associadas a um registo de domínio (titular, administrador, técnico, faturação). Um contacto é referenciado em todo o lado pelo respetivo ID de contacto — uma cadeia opaca.

contacts_save — Guardar contacto

Guarda os detalhes do contacto e devolve o ID de contacto gerado. A validação de alguns campos (como stateProvince e postalCode) depende do país selecionado.

  • Parâmetro: firstName

    Obrigatório: Sim

    Tipo e restrições: Cadeia, 1–64 caracteres. Pode incluir hífenes e apóstrofos.

  • Parâmetro: lastName

    Obrigatório: Sim

    Tipo e restrições: Cadeia, 1–64 caracteres. Pode incluir hífenes e apóstrofos.

  • Parâmetro: email

    Obrigatório: Sim

    Tipo e restrições: Endereço de email válido, máx. 254 caracteres.

  • Parâmetro: address1

    Obrigatório: Sim

    Tipo e restrições: Linha de endereço 1. Cadeia, 1–128 caracteres.

  • Parâmetro: city

    Obrigatório: Sim

    Tipo e restrições: Cadeia, 1–64 caracteres.

  • Parâmetro: country

    Obrigatório: Sim

    Tipo e restrições: Código de país de duas letras (ISO 3166-1 alpha-2), por exemplo US.

  • Parâmetro: phone

    Obrigatório: Sim

    Tipo e restrições: Formato internacional +CountryCode.Number, por exemplo +1.2025551234. Máx. 32 caracteres.

  • Parâmetro: organization

    Obrigatório: Não

    Tipo e restrições: Nome da organização/empresa. 1–128 caracteres.

  • Parâmetro: address2

    Obrigatório: Não

    Tipo e restrições: Linha de endereço 2. 1–128 caracteres.

  • Parâmetro: stateProvince

    Obrigatório: Não

    Tipo e restrições: Nome do estado/província, 1–64 caracteres. Pode ser obrigatório, dependendo do país.

  • Parâmetro: postalCode

    Obrigatório: Não

    Tipo e restrições: 1–16 caracteres. Pode ser obrigatório, dependendo do país.

  • Parâmetro: phoneExt

    Obrigatório: Não

    Tipo e restrições: Extensão telefónica, 1–16 caracteres.

  • Parâmetro: fax

    Obrigatório: Não

    Tipo e restrições: Número de fax, mesmo formato +CountryCode.Number, máx. 32 caracteres.

  • Parâmetro: faxExt

    Obrigatório: Não

    Tipo e restrições: Extensão de fax, 1–16 caracteres.

  • Parâmetro: taxNumber

    Obrigatório: Não

    Tipo e restrições: Número fiscal, 1–32 caracteres.

Devolve

{ "contactId": "..." }

contactId (27–32 caracteres alfanuméricos) é o que passas a domain_set_contacts e contacts_get.

contacts_get — Obter contacto

Lê os detalhes de um contacto guardado através do respetivo ID de contacto. Os IDs de contacto vêm de contacts_save, contacts_list ou do campo contacts dos resultados de domains_list.

  • Parâmetro: contactId

    Obrigatório: Sim

    Tipo e restrições: ID de contacto, 27–32 caracteres alfanuméricos.

Devolve — { contact } com:

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

    Tipo: String

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

    Tipo: String ou null

contacts_list — Listar contactos

Lista todos os contactos guardados na tua conta, para que possas encontrar e reutilizar um contacto existente (através do respetivo ID de contacto) em vez de criares um duplicado ou andares à procura nos teus domínios. A lista é paginada e ordenável, de forma consistente com domains_list.

  • Parâmetro: take

    Obrigatório: Não

    Tipo e restrições: Itens por página, 1–100. Predefinição 10.

  • Parâmetro: skip

    Obrigatório: Não

    Tipo e restrições: Itens a ignorar, 0 ou mais. Predefinição 0.

  • Parâmetro: orderBy

    Obrigatório: Não

    Tipo e restrições: Até 8 chaves de ordenação: name, email, organization; prefixa com - para ordem descendente (por exemplo, -name).

Devolve — { items, total } em que total é o número de contactos únicos na conta (sem duplicados por ID de contacto, não o tamanho da página), e cada item inclui informação suficiente para distinguir contactos sem uma chamada de seguimento. Se a conta tiver entradas duplicadas para o mesmo ID de contacto, estas são reduzidas a uma só, pelo que total conta contactos distintos em vez de linhas brutas do lado do servidor:

  • Campo: contactId

    Tipo: String (27–32 alfanumérico). Passa a contacts_get ou domain_set_contacts.

  • Campo: name

    Tipo: String — o nome do contacto.

  • Campo: email

    Tipo: String ou null quando o contacto não tem email registado.

  • Campo: organization

    Tipo: String ou null quando o contacto não tem organização registada.

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

Domínios

As entradas de nome de domínio (domain/domainName) aceitam Unicode (IDN) ou ASCII (A-label) — em qualquer dos casos, a ferramenta normaliza automaticamente o nome para punycode antes da utilização. domains_check_availability exige adicionalmente um TLD que a Spaceship suporte para registo: um domínio cujo TLD não seja suportado é indicado como indisponível em vez de ser verificado. As outras ferramentas de domínio (domains_list, domain_set_contacts, domain_set_nameservers) e as ferramentas DNS apenas normalizam o nome e nunca o rejeitam com base no suporte do TLD.

domains_list — Listar domínios

Obtém uma lista paginada dos teus domínios. Passa domain para obter antes um único domínio pelo nome (a paginação e a ordenação são então ignoradas, e o resultado inclui uma note a indicá-lo, se tiverem sido fornecidas).

  • Parâmetro: domain

    Obrigatório: Não

    Tipo e restrições: Nome de domínio totalmente qualificado para obter um único domínio. Aceita Unicode (IDN) ou ASCII (A-label) — normalizado automaticamente para punycode.

  • Parâmetro: take

    Obrigatório: Não

    Tipo e restrições: Itens por página, 1–100. Predefinição 10.

  • Parâmetro: skip

    Obrigatório: Não

    Tipo e restrições: Itens a ignorar, 0 ou mais. Predefinição 0.

  • Parâmetro: orderBy

    Obrigatório: Não

    Tipo e restrições: Até 8 chaves de ordenação: name, unicodeName, registrationDate, expirationDate; prefixa com - para ordem descendente (por exemplo, -expirationDate).

Devolve — { items, total } em que cada item descreve um domínio:

  • Campo: name / unicodeName

    Significado: Nome do domínio em formato ASCII e Unicode.

  • Campo: isPremium

    Significado: Indica se o domínio é um nome premium.

  • Campo: autoRenew

    Significado: Indica se a renovação automática está ativada.

  • Campo: registrationDate / expirationDate

    Significado: Carimbos temporais de registo e expiração.

  • Campo: lifecycleStatus

    Significado: creating, registered, grace1, grace2 ou redemption.

  • Campo: verificationStatus

    Significado: verification, success, failed ou null quando não aplicável.

  • Campo: eppStatuses

    Significado: Códigos de estado do registo (por exemplo, bloqueios de transferência).

  • Campo: suspensions

    Significado: Suspensões ativas, cada uma com um reasonCode.

  • Campo: privacyProtection

    Significado: { level: "public" | "high", contactForm: boolean }.

  • Campo: nameservers

    Significado: { provider: "basic" | "custom", hosts: [...] }.

  • Campo: contacts

    Significado: IDs de contacto: registrant, mais admin/tech/billing (pode ser null) e attributes (uma lista de IDs de contacto de atributos alargados, ou null). Legível através de contacts_get.

O Spaceship MCP preenche todos os campos acima — incluindo contacts, eppStatuses, suspensions, verificationStatus, nameservers, um autoRenew real e um unicodeName distinto quando o domínio o tiver — tanto para a lista com vários itens como para as consultas de um único domínio.

domains_check_availability — Verificar disponibilidade do domínio

Verifica se um ou mais nomes de domínio estão disponíveis para registo. Usa o endpoint de domínio único para um nome e o endpoint em massa para vários. Um domínio cujo TLD não seja suportado para registo não é sequer enviado para a verificação de disponibilidade — é devolvido imediatamente como tldNotSupported.

  • Parâmetro: domains

    Obrigatório: Sim

    Tipo e restrições: 1–20 nomes de domínio totalmente qualificados. Cada um aceita Unicode (IDN) ou ASCII (A-label) — normalizado automaticamente para punycode.

Devolve — { results }, uma entrada por cada nome pedido:

  • Campo: domain

    Significado: O nome verificado.

  • Campo: result

    Significado: available, taken, invalidDomainName, tldNotSupported ou unexpectedError.

  • Campo: premiumPricing

    Significado: Para nomes premium: lista de { operation, price, currency } em que operation é register, transfer, renew ou restore. Vazio para nomes normais.

  • Campo: price

    Significado: Para nomes available (normais e premium): o preço em USD para registar o domínio pelo prazo mais curto que o TLD permite — { amount, currency: "USD", pricedYears?, pricePerYear?, icannFee?, isPremium }. amount é o total a pagar por todo esse prazo; pricedYears indica quantos anos cobre. Não é indicado qualquer preço anterior ao desconto nem preço "anterior". icannFee é a taxa ICANN (USD) já incluída em amount, devolvida separadamente para que a discriminação possa ser explicada; só aparece quando o TLD tem uma taxa.

  • Campo: pricePerYear

    Significado: Dentro de price: amount dividido por pricedYears, para que exista sempre um valor anual para comparação. Quando pricedYears é 1, é o preço real de um ano; acima disso, é uma média anual do prazo, não um prazo que possas comprar.

  • Campo: minRegisterPeriodInYears / maxRegisterPeriodInYears

    Significado: Para nomes available: o período de registo mais curto e mais longo que esse TLD realmente permite, como dois números simples. Indicam ao cliente por que prazos pode comprar o domínio. Ambos são omitidos quando não foi possível determinar o período permitido.

  • Campo: priceUnavailableReason

    Significado: Presente em vez de price quando não foi possível determinar o preço de um nome disponível. A verificação em si continua a ser bem-sucedida.

Só os nomes disponíveis têm preço; os resultados taken/inválidos não incluem price nem priceUnavailableReason.

A maioria dos TLDs permite um ano, mas alguns não..ai, por exemplo, tem um mínimo de dois anos. Nesses casos, price.amount é o total para o prazo mínimo — não um preço de um ano que possas efetivamente comprar — e price.pricedYears indica isso:

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

pricePerYear está presente aqui — 159.96 dividido pelos dois anos que cobre dá 79.98. Este é o total dividido pelo prazo, não um preço que possas pagar por um único ano (não é possível comprar um registo .ai de um ano). Mostra sempre amount juntamente com pricedYears ("159,96 $ por 2 anos"), nunca amount sozinho. Para um TLD normal, pricedYears é 1 e pricePerYear é igual a amount.

domain_set_contacts — Definir contactos do domínio

Altera os contactos atribuídos a um domínio que te pertence. Conclui imediatamente (sem operação para consultar).

  • Parâmetro: domainName

    Obrigatório: Sim

    Tipo e restrições: Nome de domínio totalmente qualificado. Aceita Unicode (IDN) ou ASCII (A-label) — normalizado automaticamente para punycode.

  • Parâmetro: registrant

    Obrigatório: Sim

    Tipo e restrições: contactId string (27–32 alfanumérico), de contacts_save.

  • Parâmetro: admin

    Obrigatório: Não

    Tipo e restrições: contactId string (27–32 alfanumérico) ou null.

  • Parâmetro: tech

    Obrigatório: Não

    Tipo e restrições: contactId string (27–32 alfanumérico) ou null.

  • Parâmetro: billing

    Obrigatório: Não

    Tipo e restrições: contactId string (27–32 alfanumérico) ou null.

  • Parâmetro: attributes

    Obrigatório: Não

    Tipo e restrições: Array de IDs de contacto de atributos alargados (até 5); exigido apenas para determinados TLDs, caso contrário omite ou usa null.

Devolve

{ "verificationStatus": "verification" }

O verificationStatus devolvido reflete a verificação de email ICANN RAA: verification — o titular do registo tem de confirmar o respetivo endereço de email (é enviado um email de confirmação); success — já confirmado; null — a verificação RAA não se aplica a este domínio.

domain_set_nameservers — Definir nameservers do domínio

Altera os nameservers de um domínio ao nível do registrador. Conclui imediatamente (sem operação para consultar). A alteração é refletida por domains_list depois disso.

  • Parâmetro: domainName

    Obrigatório: Sim

    Tipo e restrições: Nome de domínio totalmente qualificado. Aceita Unicode (IDN) ou ASCII (A-label) — normalizado automaticamente para punycode.

  • Parâmetro: provider

    Obrigatório: Sim

    Tipo e restrições: basic (os nameservers predefinidos da Spaceship) ou custom (os teus próprios hosts).

  • Parâmetro: hosts

    Obrigatório: Condicional

    Tipo e restrições: Obrigatório quando provider é custom: 2–12 nomes de anfitrião de servidores de nomes (cada um um FQDN válido, 4–255 caracteres). Deve ser omitido quando provider é basic.

Devolve

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

Voltar a aplicar o estado em que um domínio já se encontra (por exemplo, definir basic quando já está em basic) devolve um erro de validação em vez de um sucesso sem efeito — trata isso como um resultado esperado, não como uma falha que deva ser repetida.

Registos DNS

O domainName que estas ferramentas recebem aceita Unicode (IDN) ou ASCII (A-label) e é normalizado automaticamente para punycode; o suporte de TLD não é imposto aqui.

dns_records_get — Obter registos DNS

Obtém uma lista paginada de registos de recursos DNS de um domínio.

  • Parâmetro: domainName

    Obrigatório: Sim

    Tipo e restrições: O domínio cujos registos devem ser obtidos.

  • Parâmetro: take

    Obrigatório: Não

    Tipo e restrições: Itens por página, 1–500. Predefinição 100.

  • Parâmetro: skip

    Obrigatório: Não

    Tipo e restrições: Itens a ignorar, 0 ou mais. Predefinição 0.

  • Parâmetro: orderBy

    Obrigatório: Não

    Tipo e restrições: Até 8 chaves de ordenação: type, -type, name, -name.

Devolve — { items, total }. Cada item é um registo conforme descrito em Formatos de registo, mais um campo opcional group que indica de onde vem o registo (custom — criado por ti, product — gerido por um produto Spaceship, personalNs — servidores de nomes pessoais).

dns_records_save — Guardar registos DNS

Adiciona registos DNS personalizados ou atualiza o TTL dos existentes. Os registos são correspondidos sem distinção entre maiúsculas e minúsculas, exceto os registos TXT (sensíveis a maiúsculas e minúsculas).

  • Parâmetro: domainName

    Obrigatório: Sim

    Tipo e restrições: O domínio cujos registos devem ser atualizados.

  • Parâmetro: records

    Obrigatório: Sim

    Tipo e restrições: 1–500 registos — ver Formatos de registo. Cada um pode incluir um ttl opcional.

  • Parâmetro: force

    Obrigatório: Não

    Tipo e restrições: Booleano. Ignora a verificação de resolução de conflitos e força a atualização da zona.

Devolve — { "saved": <number> }, a contagem dos registos submetidos. Uma resposta bem-sucedida significa que todos os registos foram aceites; se algum registo falhar, toda a chamada devolve um erro.

dns_records_delete — Eliminar registos DNS

Elimina registos DNS personalizados. As eliminações não podem ser anuladas. Os registos são correspondidos sem distinção entre maiúsculas e minúsculas, exceto os registos TXT (sensíveis a maiúsculas e minúsculas).

  • Parâmetro: domainName

    Obrigatório: Sim

    Tipo e restrições: O domínio cujos registos devem ser eliminados.

  • Parâmetro: records

    Obrigatório: Sim

    Tipo e restrições: 1–500 registos que identificam registos existentes — os mesmos formatos que guardar, mas sem ttl.

Devolve — { "deleted": <number> }, a contagem dos registos submetidos. Se algum registo não puder ser correspondido, toda a chamada falha e nada é eliminado.

Formatos de registo

Todos os registos têm:

  • type — um dos 13 tipos suportados abaixo.

  • name — o nome do registo excluindo o domínio: usa @ para o próprio domínio (apex) e * para um wildcard.

  • ttl (apenas ao guardar, opcional) — tempo de cache em segundos, 60–3600.

Campos específicos do tipo:

  • Tipo: A

    Campos: address — endereço IPv4.

  • Tipo: AAAA

    Campos: address — endereço IPv6.

  • Tipo: CNAME

    Campos: cname — nome de domínio canónico (máx. 253 caracteres).

  • Tipo: ALIAS

    Campos: aliasName — nome de domínio canónico; comportamento semelhante a CNAME para o apex, onde CNAME não é permitido.

  • Tipo: NS

    Campos: nameserver — nome do servidor de nomes.

  • Tipo: PTR

    Campos: pointer — nome de domínio para o endereço IP indicado.

  • Tipo: TXT

    Campos: value — valor de texto (correspondido com distinção entre maiúsculas e minúsculas).

  • Tipo: MX

    Campos: exchange — servidor de correio; preference — prioridade (0–65535, menor é preferida).

  • Tipo: CAA

    Campos: flag — 0 ou 128 (bit crítico); tag — issue, issuewild, ou iodef; value — identificador da AC com parâmetros opcionais.

  • Tipo: SRV

    Campos: service (por exemplo _sip); protocol (por exemplo _tcp); priority e weight (0–65535); port (1–65535); target — nome de domínio do servidor.

  • Tipo: TLSA

    Campos: usage, selector, matching (cada um 0–255); port — * ou _<1–65535>; protocol (por exemplo _tcp); associationData — hash ou dados do certificado.

  • Tipo: HTTPS

    Campos: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN ou .; port opcional (* ou _<1–65535>), scheme (tem de ser _https quando port está definido), svcParams.

  • Tipo: SVCB

    Campos: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN ou .; port, scheme (por exemplo _tcp), svcParams opcionais.

Operações assíncronas

async_operation_get — Obter estado da operação assíncrona

Verifica uma operação de longa duração na tua conta através do respetivo operationId. Chama-a repetidamente até que status seja success ou failed.

  • Parâmetro: operationId

    Obrigatório: Sim

    Tipo e restrições: Cadeia alfanumérica, máx. 36 caracteres, devolvida pela ferramenta que iniciou a operação.

Devolve

  • Campo: operationId

    Significado: A operação consultada.

  • Campo: status

    Significado: pending, success, ou failed.

  • Campo: type

    Significado: Tipo de operação, ou null.

  • Campo: details

    Significado: Detalhes extra sobre a operação, ou null.

  • Campo: createdAt / modifiedAt

    Significado: Quando a operação foi criada / atualizada pela última vez (modifiedAt pode ser null).

Erros

Quando uma chamada falha, a ferramenta devolve um erro com um código e um detail legível por humanos a explicar o que correu mal — por exemplo, entrada inválida (um nome de domínio ou ID de contacto malformado), um domínio ou contacto que não existe, ou um conflito com o estado atual. Se uma ferramenta for rejeitada porque o assistente não recebeu acesso à mesma, volta a ligar o Spaceship MCP e aprova o acesso que ele pedir.

É necessário um email válido