Dla programistów → MCP

Serwer MCP dla Twojej AI

NameOcean udostępnia zdalny serwer MCP pod jednym adresem URL. Połącz raz swojego klienta AI, a będzie mógł zarządzać Twoimi DNS, SSL, serwerami aplikacji, pocztą i webhookami za pomocą 64 narzędzi. Logujesz się w przeglądarce: bez wklejania klucza, bez instalacji.

https://nameocean.net/mcp

Połącz klienta

Claude Code

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

Następnie uruchom /mcp w Claude Code i wybierz nameocean, aby się zalogować.

Claude Desktop i claude.ai

Ustawienia → Konektory → Dodaj własny konektor. Nazwij go NameOcean i użyj adresu URL https://nameocean.net/mcp. Przy pierwszym użyciu Claude otworzy stronę logowania 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}
  }
}

Przez CLI

nameocean mcp install wyszukuje Claude Code, Cursor i OpenCode na Twoim komputerze i dodaje serwer do każdego z nich. Zainstaluj CLI.

Klienci bez logowania w przeglądarce

Przesyłaj klucz API w nagłówku: Authorization: Bearer no_live_…. Narzędzia mają wtedy dokładnie te zakresy co klucz, więc klucz z samym dns:read może przeglądać, ale nie zmieniać.

O co zapytać

"Skieruj blog.example.com na 203.0.113.10 i włącz SSL."
"Skonfiguruj pocztę dla example.com: skrzynka dla hello@, przekierowanie sales@ na mój Gmail i sprawdź DNS."
"Wdróż ten projekt na mój serwer i pokaż mi logi, jeśli się nie uruchomi."
"Przenieś wszystkie rekordy example.com na nowy adres IP serwera. Najpierw pokaż mi plan."
"Wyślij webhook na https://example.com/hooks, gdy domena będzie bliska wygaśnięcia."

Co Twoja AI może, a czego nie może robić

Nie może zarejestrować ani odnowić domeny ani doładować środków. Sprawdza dostępność i cenę, a następnie kieruje Państwa na nameocean.net/domains, aby dokonać zakupu.
Utworzenie serwera aplikacji jest rozliczane miesięcznie, dlatego wymaga dwóch wywołań: pierwsze zwraca cenę, którą AI Państwu pokazuje, a drugie wykonuje się dopiero po Państwa zgodzie. Klucz API z ograniczonym zakresem wymaga do tego również uprawnienia billing:write.
Hasła do skrzynek pocztowych i wartości zmiennych środowiskowych nigdy nie trafiają do modelu; można je odczytać w panelu.
Narzędzia, które usuwają, zatrzymują lub nadpisują, są oznaczone jako destrukcyjne, dzięki czemu klienci wymagający potwierdzenia takich narzędzi najpierw pytają Państwa o zgodę.
Wszystkie wprowadzone zmiany widać w Panel → Aktywność, wraz z aplikacją, która je wykonała. Aplikację można odłączyć w dowolnym momencie w Panel → Połączone aplikacje.
Połączenia aplikacji i klucze API wymagają włączenia logowania dwuetapowego na Państwa koncie.

Narzędzia

Opisy są czytane przez Państwa AI, dlatego są w języku angielskim. odczyt tylko odczytuje · zapis wprowadza zmiany · destrukcyjne usuwa, zatrzymuje lub nadpisuje

Account and domains

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

Serwery aplikacji

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

Email

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

Webhooki

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

Protokół

Streamable HTTP, bezstanowy, wersje protokołu 2025-11-25, 2025-06-18 i 2025-03-26. Logowanie odbywa się przez OAuth 2.1 z PKCE i dynamiczną rejestracją klientów; metadane serwera znajdują się pod adresem /.well-known/oauth-protected-resource. Narzędzia wywołują ten sam kod co REST API, więc weryfikacja własności, zakresy uprawnień i limity zapytań są takie same.