Programadores → MCP

Servidor MCP para a sua IA

A NameOcean disponibiliza um servidor MCP remoto num único URL. Ligue o seu cliente de IA uma vez e ele poderá gerir o seu DNS, SSL, servidores de aplicações, email e webhooks com 64 ferramentas. Inicia sessão no navegador: sem chaves para colar, nada para instalar.

https://nameocean.net/mcp

Ligue o seu cliente

Claude Code

$ claude mcp add --transport http nameocean https://nameocean.net/mcp

Depois execute /mcp no Claude Code e escolha nameocean para iniciar sessão.

Claude Desktop e claude.ai

Definições → Conectores → Adicionar conector personalizado. Dê-lhe o nome NameOcean e use o URL https://nameocean.net/mcp. O Claude abre a página de início de sessão da NameOcean na primeira vez.

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "nameocean": {"url": "https://nameocean.net/mcp"}
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "nameocean": {"type": "http", "url": "https://nameocean.net/mcp"}
  }
}

OpenCode

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nameocean": {"type": "remote", "url": "https://nameocean.net/mcp", "enabled": true}
  }
}

Com a CLI

nameocean mcp install encontra o Claude Code, o Cursor e o OpenCode no seu computador e adiciona o servidor a cada um. Instalar a CLI.

Clientes sem início de sessão no navegador

Envie uma chave de API num cabeçalho: Authorization: Bearer no_live_…. As ferramentas passam a ter exatamente os âmbitos da chave, pelo que uma chave apenas com dns:read pode consultar, mas não alterar.

O que pedir

"Aponte blog.example.com para 203.0.113.10 e ative o SSL."
"Configura o email para example.com: uma caixa de correio para hello@, reencaminha sales@ para o meu Gmail e verifica o DNS."
"Implementa este projeto no meu servidor e mostra-me os logs se não arrancar."
"Muda todos os registos de example.com para o novo IP do servidor. Mostra-me primeiro o plano."
"Envia um webhook para https://example.com/hooks quando um domínio estiver prestes a expirar."

O que a sua IA pode e não pode fazer

Não pode registrar nem renovar um domínio, nem adicionar crédito. Verifica a disponibilidade e o preço e encaminha você para nameocean.net/domains para fazer a compra.
A criação de um servidor de aplicações é cobrada mensalmente, por isso são necessárias duas chamadas: a primeira retorna o preço para a IA mostrar a você, e a segunda só é executada com a sua confirmação. Uma chave de API com escopo também precisa de billing:write para isso.
As senhas das caixas de correio e os valores das variáveis de ambiente nunca chegam ao modelo; você os consulta no painel.
As ferramentas que excluem, interrompem ou sobrescrevem são marcadas como destrutivas, para que os clientes que pedem confirmação para esse tipo de ferramenta perguntem a você primeiro.
Tudo o que é alterado aparece em Painel → Atividade, junto com o aplicativo que fez a alteração. Desconecte um aplicativo a qualquer momento em Painel → Aplicativos conectados.
As conexões de aplicativos e as chaves de API exigem login em duas etapas na sua conta.

Ferramentas

As descrições são o que a sua IA lê, por isso estão em inglês. leitura apenas lê · escrita altera algo · destrutiva exclui, interrompe ou sobrescreve

Account and domains

`get_account` leitura	Your email, account credit (USD) and how many domains and DNS zones you have.
`check_domain` leitura	Is a domain available to register, and its register/renew price in USD. Registering is done by the user in the dashboard.
`list_activity` leitura	The account's activity log, newest first: changes made through the API, the CLI and MCP (by which key or app), refused calls, and API key and app changes. Use it to show the user what was done.
`list_domains` leitura	Domains registered in your account with expiry, auto-renew and nameservers.
`get_domain` leitura	One domain: nameservers, lock, auto-renew and SSL status.
`update_domain` escrita	Turn auto-renew or the transfer lock on or off.
`set_nameservers` destrutiva	Change a domain's nameservers. Pass 2-4 hostnames, or ["nameocean"] to go back to NameOcean DNS. Moving away from NameOcean DNS stops DNS records, server bindings and email from working.

DNS

`list_dns_zones` leitura	DNS zones hosted on NameOcean DNS.
`create_dns_zone` escrita	Host a domain's DNS on NameOcean (free).
`list_dns_records` leitura	All records of a DNS zone with their type and id.
`add_dns_record` escrita	Add a DNS record. Fields by type: A {hostname, ip}, CNAME {hostname, target}, MX {hostname, priority, target}, TXT {hostname, text}, SRV {hostname, priority, weight, port, target}, PTR {hostname, target}, REDIRECT {hostname, target URL, save_path}. Changes reach the nameservers within seconds.
`update_dns_record` escrita	Change fields of an existing record (find its type and id with list_dns_records).
`delete_dns_record` destrutiva	Delete a DNS record by type and id.
`export_dns_zone` leitura	The zone as a DNS-as-code file (JSON, records in {name, type, value, ttl} form), without ids. Start from this to change many records at once with plan_dns_zone / apply_dns_zone.
`plan_dns_zone` leitura	Compare a full list of records with the zone and show what apply_dns_zone would create, change and delete. Changes nothing. Show the plan to the user before applying it.
`apply_dns_zone` destrutiva	Make the zone match a full list of records, in one transaction (nothing changes when one record is refused). Run plan_dns_zone first, get the user's OK for its deletes, and pass its serial so a zone changed in between is refused.

SSL

`get_ssl` leitura	SSL certificate status of a zone and its download link.
`issue_ssl` escrita	Issue a free wildcard Let's Encrypt certificate for a zone on NameOcean DNS.

Servidores de aplicações

`list_servers` leitura	Your app servers with SSH command, git remote, open ports and bound domains.
`get_server` leitura	One app server in detail.
`open_port` escrita	Open a port on a server. 80 (behind HTTPS on 443) and SSH are open already; NameOcean assigns the external port.
`close_port` destrutiva	Close an open port by its id (see get_server).
`bind_domain` escrita	Serve a domain or subdomain from a server over HTTPS. The domain must use NameOcean DNS; DNS records and the certificate are set up automatically.
`unbind_domain` destrutiva	Stop serving a domain from a server, by binding id (see get_server).
`list_server_plans` leitura	App server plans you can create: CPU, memory, disk and monthly price (USD).
`create_server` escrita	Create an app server; it is billed monthly. First call without confirm to get the price, show it to the user, and call again with confirm: true only after they agree.
`start_server` escrita	Start a stopped server.
`stop_server` destrutiva	Stop a server (its sites go down; billing continues). Ask the user first.
`restart_server` destrutiva	Reboot a server (a short outage). Ask the user first.
`list_backups` leitura	A server's backups (free, nightly and manual; the last 7 days, at most 7).
`backup_server` escrita	Start a backup of a server now.
`restore_backup` destrutiva	Replace EVERYTHING on a server with one of its backups. Can't be undone: get the user's explicit OK for this backup first.
`list_apps` leitura	Supervisor programs on an app server and whether they run.
`restart_apps` escrita	Restart every app (supervisor) on a server and reload nginx, e.g. after changing config.
`read_logs` leitura	The last lines of an app's output (a supervisor program), or nginx / nginx-access.
`list_env` leitura	Names of a server's env variables (values are secrets and are not shown here).
`set_env` escrita	Set or remove env variables every app on the server gets, then restart the apps.
`add_ssh_key` escrita	Let a public SSH key log in to a server as root (needed for git push from a new machine).
`list_deploys` leitura	The commit a server runs now and its recent deploys.
`finish_deploy` escrita	After `git push` to the server's git remote: check the commit arrived, restart the apps, reload nginx and record the deploy. Returns each app's state and the output.
`get_deploy_guide` leitura	How to deploy code to a server: git remote, SSH, layout, ports and supervisor examples.

Email

`list_email_domains` leitura	Domains with paid NameOcean email hosting: plan, storage, mailbox count, expiry.
`get_email_domain` leitura	A mail domain's mailboxes, aliases, mailing lists and the IMAP/SMTP settings for mail apps.
`check_email_dns` leitura	Look up a mail domain's NS, MX, SPF, DKIM and DMARC now and say which differ from what NameOcean mail needs (with the expected values).
`create_mailbox` escrita	Create a mailbox (username@domain) on a mail domain. A password is generated; it is not returned here, the user reads it in the dashboard. quota_gb comes out of the plan's storage (default 1).
`update_mailbox` escrita	Change a mailbox's display name or quota (GB).
`reset_mailbox_password` escrita	Give a mailbox a new generated password. The old one stops working at once (mail apps must be updated); the new one is shown to the user in the dashboard, not returned here. Ask the user first.
`delete_mailbox` destrutiva	Delete a mailbox with ALL its mail and aliases. Can't be undone: confirm with the user first.
`add_email_alias` escrita	Deliver another address of the domain to a mailbox (e.g. sales@ to info@).
`remove_email_alias` destrutiva	Delete an alias of a mail domain.
`list_email_forwarding` leitura	Free email forwarding: every domain registered in the account, whether forwarding is on, and if it is off, why it can't be turned on.
`get_email_forwarding` leitura	A domain's forwarding aliases (and whether their targets confirmed) and mail webhooks.
`enable_email_forwarding` escrita	Turn free email forwarding on for a domain registered at NameOcean: writes its MX record. If the zone has other MX records (another mail provider) this fails unless replace_mx is true, which removes them - ask the user before that.
`disable_email_forwarding` destrutiva	Turn forwarding off for a domain (removes the MX record; aliases are kept).
`add_email_forward` escrita	Forward localpart@domain to another address. A new target address gets a confirmation mail; forwarding starts once its owner confirms.
`remove_email_forward` destrutiva	Stop forwarding localpart@domain.
`list_forwarded_mail` leitura	Mail a forwarding domain received in the last 30 days: from, subject, status (forwarded, spam, quota, bounced...). Never the body.
`send_email` escrita	Send an email from one of the user's mailboxes or aliases (a domain with NameOcean email hosting whose SPF and DKIM are set up). Before calling, show the user the from address, the recipients, the subject and the body, and send only after they say yes. Returns one id per recipient; delivery results come later in list_sent_email.
`list_sent_email` leitura	Mail sent with the API in the last 30 days and what happened to each recipient (queued, delivered, delayed, failed, suppressed), with the SMTP error. Never the body.

Webhooks

`list_webhooks` leitura	Webhook endpoints that receive this account's events (domain, DNS, SSL), with the event types they want.
`create_webhook` escrita	Send account events to an https URL. events: types such as dns.record.created, groups such as dns., or [""]; the event list is at https://nameocean.net/developers/webhooks/. Returns the signing secret.
`delete_webhook` destrutiva	Stop sending events to a webhook endpoint and delete it.
`send_test_event` escrita	Post a webhook.test event to an endpoint now and show what it answered.
`list_webhook_deliveries` leitura	Recent deliveries to a webhook endpoint: event, status, attempts, the receiver's answer.

Protocolo

Streamable HTTP, sem estado, versões do protocolo 2025-11-25, 2025-06-18 e 2025-03-26. O login é feito via OAuth 2.1 com PKCE e registro dinâmico de clientes; os metadados do servidor estão em /.well-known/oauth-protected-resource. As ferramentas chamam o mesmo código da REST API, portanto as verificações de propriedade, os escopos e os limites de taxa são os mesmos.