Sviluppatori → MCP

Server MCP per la Sua AI

NameOcean offre un server MCP remoto a un unico URL. Colleghi una sola volta il Suo client AI e potrà gestire DNS, SSL, server applicativi, email e webhook con 64 strumenti. Accede dal browser: nessuna chiave da incollare, niente da installare.

https://nameocean.net/mcp

Colleghi il Suo client

Claude Code

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

Poi esegua /mcp in Claude Code e scelga nameocean per accedere.

Claude Desktop e claude.ai

Impostazioni → Connettori → Aggiungi connettore personalizzato. Lo chiami NameOcean e usi l'URL https://nameocean.net/mcp. Al primo utilizzo Claude apre la pagina di accesso di NameOcean.

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}
  }
}

Con la CLI

nameocean mcp install trova Claude Code, Cursor e OpenCode sul Suo computer e aggiunge il server a ciascuno. Installi la CLI.

Client senza accesso dal browser

Invii una chiave API in un header: Authorization: Bearer no_live_…. Gli strumenti avranno esattamente gli scope della chiave, quindi una chiave con solo dns:read può leggere ma non modificare.

Cosa chiedere

"Punta blog.example.com a 203.0.113.10 e attiva SSL."
"Configura l'email per example.com: una casella per hello@, inoltra sales@ al mio Gmail e controlla il DNS."
"Distribuisci questo progetto sul mio server e mostrami i log se non si avvia."
"Sposta tutti i record di example.com sul nuovo IP del server. Mostrami prima il piano."
"Invia un webhook a https://example.com/hooks quando un dominio sta per scadere."

Cosa può e non può fare la Sua AI

Non può registrare o rinnovare un dominio né aggiungere credito. Verifica la disponibilità e il prezzo, e La indirizza a nameocean.net/domains per l'acquisto.
La creazione di un app server viene addebitata mensilmente, quindi richiede due chiamate: la prima restituisce il prezzo che l'AI Le mostrerà, la seconda viene eseguita solo con la Sua conferma. Una API key con ambiti limitati richiede inoltre billing:write.
Le password delle caselle di posta e i valori delle variabili d'ambiente non raggiungono mai il modello; può consultarli nella dashboard.
Gli strumenti che eliminano, arrestano o sovrascrivono sono contrassegnati come distruttivi, quindi i client che richiedono conferma per tali strumenti Le chiederanno prima il permesso.
Ogni modifica effettuata è riportata in Dashboard → Attività, insieme all'app che l'ha eseguita. Può scollegare un'app in qualsiasi momento da Dashboard → App collegate.
Le connessioni delle app e le API key richiedono l'accesso in due passaggi attivo sul Suo account.

Strumenti

Le descrizioni sono ciò che legge la Sua AI, per questo sono in inglese. lettura solo lettura · scrittura apporta modifiche · distruttivo elimina, arresta o sovrascrive

Account and domains

`get_account` lettura	Your email, account credit (USD) and how many domains and DNS zones you have.
`check_domain` lettura	Is a domain available to register, and its register/renew price in USD. Registering is done by the user in the dashboard.
`list_activity` lettura	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` lettura	Domains registered in your account with expiry, auto-renew and nameservers.
`get_domain` lettura	One domain: nameservers, lock, auto-renew and SSL status.
`update_domain` scrittura	Turn auto-renew or the transfer lock on or off.
`set_nameservers` distruttivo	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` lettura	DNS zones hosted on NameOcean DNS.
`create_dns_zone` scrittura	Host a domain's DNS on NameOcean (free).
`list_dns_records` lettura	All records of a DNS zone with their type and id.
`add_dns_record` scrittura	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` scrittura	Change fields of an existing record (find its type and id with list_dns_records).
`delete_dns_record` distruttivo	Delete a DNS record by type and id.
`export_dns_zone` lettura	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` lettura	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` distruttivo	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` lettura	SSL certificate status of a zone and its download link.
`issue_ssl` scrittura	Issue a free wildcard Let's Encrypt certificate for a zone on NameOcean DNS.

Server di app

`list_servers` lettura	Your app servers with SSH command, git remote, open ports and bound domains.
`get_server` lettura	One app server in detail.
`open_port` scrittura	Open a port on a server. 80 (behind HTTPS on 443) and SSH are open already; NameOcean assigns the external port.
`close_port` distruttivo	Close an open port by its id (see get_server).
`bind_domain` scrittura	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` distruttivo	Stop serving a domain from a server, by binding id (see get_server).
`list_server_plans` lettura	App server plans you can create: CPU, memory, disk and monthly price (USD).
`create_server` scrittura	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` scrittura	Start a stopped server.
`stop_server` distruttivo	Stop a server (its sites go down; billing continues). Ask the user first.
`restart_server` distruttivo	Reboot a server (a short outage). Ask the user first.
`list_backups` lettura	A server's backups (free, nightly and manual; the last 7 days, at most 7).
`backup_server` scrittura	Start a backup of a server now.
`restore_backup` distruttivo	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` lettura	Supervisor programs on an app server and whether they run.
`restart_apps` scrittura	Restart every app (supervisor) on a server and reload nginx, e.g. after changing config.
`read_logs` lettura	The last lines of an app's output (a supervisor program), or nginx / nginx-access.
`list_env` lettura	Names of a server's env variables (values are secrets and are not shown here).
`set_env` scrittura	Set or remove env variables every app on the server gets, then restart the apps.
`add_ssh_key` scrittura	Let a public SSH key log in to a server as root (needed for git push from a new machine).
`list_deploys` lettura	The commit a server runs now and its recent deploys.
`finish_deploy` scrittura	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` lettura	How to deploy code to a server: git remote, SSH, layout, ports and supervisor examples.

Email

`list_email_domains` lettura	Domains with paid NameOcean email hosting: plan, storage, mailbox count, expiry.
`get_email_domain` lettura	A mail domain's mailboxes, aliases, mailing lists and the IMAP/SMTP settings for mail apps.
`check_email_dns` lettura	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` scrittura	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` scrittura	Change a mailbox's display name or quota (GB).
`reset_mailbox_password` scrittura	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` distruttivo	Delete a mailbox with ALL its mail and aliases. Can't be undone: confirm with the user first.
`add_email_alias` scrittura	Deliver another address of the domain to a mailbox (e.g. sales@ to info@).
`remove_email_alias` distruttivo	Delete an alias of a mail domain.
`list_email_forwarding` lettura	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` lettura	A domain's forwarding aliases (and whether their targets confirmed) and mail webhooks.
`enable_email_forwarding` scrittura	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` distruttivo	Turn forwarding off for a domain (removes the MX record; aliases are kept).
`add_email_forward` scrittura	Forward localpart@domain to another address. A new target address gets a confirmation mail; forwarding starts once its owner confirms.
`remove_email_forward` distruttivo	Stop forwarding localpart@domain.
`list_forwarded_mail` lettura	Mail a forwarding domain received in the last 30 days: from, subject, status (forwarded, spam, quota, bounced...). Never the body.
`send_email` scrittura	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` lettura	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.

Webhook

`list_webhooks` lettura	Webhook endpoints that receive this account's events (domain, DNS, SSL), with the event types they want.
`create_webhook` scrittura	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` distruttivo	Stop sending events to a webhook endpoint and delete it.
`send_test_event` scrittura	Post a webhook.test event to an endpoint now and show what it answered.
`list_webhook_deliveries` lettura	Recent deliveries to a webhook endpoint: event, status, attempts, the receiver's answer.

Protocollo

Streamable HTTP, stateless, versioni del protocollo 2025-11-25, 2025-06-18 e 2025-03-26. L'accesso avviene tramite OAuth 2.1 con PKCE e registrazione dinamica dei client; i metadati del server si trovano in /.well-known/oauth-protected-resource. Gli strumenti richiamano lo stesso codice della REST API, quindi i controlli di proprietà, gli ambiti e i limiti di frequenza sono identici.