Kehittäjät → MCP

MCP-palvelin tekoälyllenne

NameOcean ylläpitää etä-MCP-palvelinta yhdessä URL-osoitteessa. Yhdistäkää tekoälyasiakasohjelmanne kerran, niin se voi hallita DNS:ää, SSL:ää, sovelluspalvelimia, sähköpostia ja webhookeja 64 työkalulla. Kirjaudutte sisään selaimessa: ei liitettäviä avaimia, ei mitään asennettavaa.

https://nameocean.net/mcp

Yhdistä asiakasohjelma

Claude Code

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

Suorittakaa sitten /mcp Claude Codessa ja valitkaa nameocean kirjautuaksenne sisään.

Claude Desktop ja claude.ai

Asetukset → Liittimet → Lisää mukautettu liitin. Antakaa nimeksi NameOcean ja käyttäkää URL-osoitetta https://nameocean.net/mcp. Claude avaa NameOceanin kirjautumissivun ensimmäisellä kerralla.

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

CLI:n avulla

nameocean mcp install löytää tietokoneeltanne Claude Coden, Cursorin ja OpenCoden ja lisää palvelimen kuhunkin. Asenna CLI.

Asiakasohjelmat ilman selainkirjautumista

Lähettäkää API-avain otsakkeessa: Authorization: Bearer no_live_…. Työkaluilla on tällöin täsmälleen avaimen oikeudet, joten avain, jolla on vain dns:read, voi katsoa mutta ei muuttaa.

Mitä kysyä

  • "Ohjaa blog.example.com osoitteeseen 203.0.113.10 ja ota SSL käyttöön."
  • "Määritä sähköposti verkkotunnukselle example.com: postilaatikko osoitteelle hello@, ohjaa sales@ Gmailiini ja tarkista DNS."
  • "Julkaise tämä projekti palvelimelleni ja näytä lokit, jos se ei käynnisty."
  • "Siirrä kaikki example.comin tietueet uuteen palvelimen IP-osoitteeseen. Näytä suunnitelma ensin."
  • "Lähetä webhook osoitteeseen https://example.com/hooks, kun verkkotunnus on vanhenemassa."

Mitä tekoälynne voi tehdä ja mitä ei

  • Se ei voi rekisteröidä tai uusia verkkotunnusta eikä lisätä saldoa. Se tarkistaa saatavuuden ja hinnan ja ohjaa teidät ostamaan osoitteeseen nameocean.net/domains.
  • Sovelluspalvelimen luominen laskutetaan kuukausittain, joten se vaatii kaksi kutsua: ensimmäinen palauttaa hinnan, jonka tekoäly näyttää teille, ja toinen suoritetaan vain teidän hyväksynnällänne. Rajatulla API-avaimella tähän tarvitaan lisäksi oikeus billing:write.
  • Postilaatikoiden salasanat ja ympäristömuuttujien arvot eivät koskaan päädy mallille; näette ne hallintapaneelissa.
  • Poistavat, pysäyttävät tai ylikirjoittavat työkalut on merkitty tuhoaviksi, joten asiakasohjelmat, jotka vahvistavat tällaiset työkalut, kysyvät ensin teiltä.
  • Kaikki sen tekemät muutokset näkyvät kohdassa Hallintapaneeli → Toiminta yhdessä muutoksen tehneen sovelluksen kanssa. Voitte katkaista sovelluksen yhteyden milloin tahansa kohdassa Hallintapaneeli → Yhdistetyt sovellukset.
  • Sovellusyhteydet ja API-avaimet edellyttävät, että tilillänne on käytössä kaksivaiheinen kirjautuminen.

Työkalut

Tekoälynne lukee kuvaukset, joten ne ovat englanniksi. luku vain lukee · kirjoitus muuttaa jotakin · tuhoava poistaa, pysäyttää tai ylikirjoittaa

Account and domains

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

Sovelluspalvelimet

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

Sähköposti

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

Webhookit

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

Protokolla

Streamable HTTP, tilaton, protokollaversiot 2025-11-25, 2025-06-18 ja 2025-03-26. Kirjautuminen tapahtuu OAuth 2.1:llä, PKCE:llä ja dynaamisella asiakasrekisteröinnillä; palvelimen metatiedot ovat osoitteessa /.well-known/oauth-protected-resource. Työkalut kutsuvat samaa koodia kuin REST API, joten omistajuustarkistukset, käyttöoikeusalueet ja käyttörajoitukset ovat samat.