Разработчици → MCP

MCP сървър за Вашия AI

NameOcean поддържа отдалечен MCP сървър на един URL адрес. Свържете своя AI клиент веднъж и той ще може да управлява Вашите DNS, SSL, сървъри за приложения, имейл и webhooks с 64 инструмента. Влизате през браузъра: без ключ за поставяне, без нищо за инсталиране.

https://nameocean.net/mcp

Свържете своя клиент

Claude Code

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

След това изпълнете /mcp в Claude Code и изберете nameocean, за да влезете.

Claude Desktop и claude.ai

Settings → Connectors → Add custom connector. Наименувайте го NameOcean и използвайте URL адреса https://nameocean.net/mcp. При първото свързване Claude отваря страницата за вход на 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}
  }
}

С CLI

nameocean mcp install открива Claude Code, Cursor и OpenCode на Вашия компютър и добавя сървъра към всеки от тях. Инсталирайте CLI.

Клиенти без вход през браузър

Изпратете API ключ в хедър: Authorization: Bearer no_live_…. Тогава инструментите имат точно обхватите на ключа, така че ключ само с dns:read може да преглежда, но не и да променя.

Какво да поискате

"Насочете blog.example.com към 203.0.113.10 и включете SSL."
„Настрой имейл за example.com: пощенска кутия за hello@, пренасочване на sales@ към моя Gmail и провери DNS.“
„Внедри този проект на моя сървър и ми покажи логовете, ако не стартира.“
„Премести всички записи на example.com към новия IP адрес на сървъра. Първо ми покажи плана.“
„Изпращай webhook до https://example.com/hooks, когато даден домейн е на път да изтече.“

Какво може и какво не може да прави Вашият AI

Не може да регистрира или подновява домейн, нито да добавя кредит. Проверява наличността и цената и Ви насочва към nameocean.net/domains за покупка.
Създаването на сървър за приложения се таксува месечно, затова са нужни две извиквания: първото връща цената, която AI да Ви покаже, а второто се изпълнява само с Вашето съгласие. За целта API ключ с ограничен обхват се нуждае и от billing:write.
Паролите на пощенските кутии и стойностите на променливите на средата никога не достигат до модела; виждате ги в таблото за управление.
Инструментите, които изтриват, спират или презаписват, са маркирани като деструктивни, така че клиентите, които изискват потвърждение за такива инструменти, първо ще Ви попитат.
Всичко, което променя, се вижда в Табло → Активност, заедно с приложението, което го е направило. Можете да прекъснете връзката с приложение по всяко време от Табло → Свързани приложения.
Свързването на приложения и API ключовете изискват вход в две стъпки за Вашия акаунт.

Инструменти

Описанията са това, което чете Вашият AI, затова са на английски. четене само чете · запис променя нещо · деструктивен изтрива, спира или презаписва

Account and domains

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

Сървъри за приложения

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

Имейл

`list_email_domains` четене	Domains with paid NameOcean email hosting: plan, storage, mailbox count, expiry.
`get_email_domain` четене	A mail domain's mailboxes, aliases, mailing lists and the IMAP/SMTP settings for mail apps.
`check_email_dns` четене	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` запис	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` запис	Change a mailbox's display name or quota (GB).
`reset_mailbox_password` запис	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` деструктивен	Delete a mailbox with ALL its mail and aliases. Can't be undone: confirm with the user first.
`add_email_alias` запис	Deliver another address of the domain to a mailbox (e.g. sales@ to info@).
`remove_email_alias` деструктивен	Delete an alias of a mail domain.
`list_email_forwarding` четене	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` четене	A domain's forwarding aliases (and whether their targets confirmed) and mail webhooks.
`enable_email_forwarding` запис	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` деструктивен	Turn forwarding off for a domain (removes the MX record; aliases are kept).
`add_email_forward` запис	Forward localpart@domain to another address. A new target address gets a confirmation mail; forwarding starts once its owner confirms.
`remove_email_forward` деструктивен	Stop forwarding localpart@domain.
`list_forwarded_mail` четене	Mail a forwarding domain received in the last 30 days: from, subject, status (forwarded, spam, quota, bounced...). Never the body.
`send_email` запис	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` четене	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` четене	Webhook endpoints that receive this account's events (domain, DNS, SSL), with the event types they want.
`create_webhook` запис	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` деструктивен	Stop sending events to a webhook endpoint and delete it.
`send_test_event` запис	Post a webhook.test event to an endpoint now and show what it answered.
`list_webhook_deliveries` четене	Recent deliveries to a webhook endpoint: event, status, attempts, the receiver's answer.

Протокол

Streamable HTTP, без състояние, версии на протокола 2025-11-25, 2025-06-18 и 2025-03-26. Влизането е чрез OAuth 2.1 с PKCE и динамична регистрация на клиенти; метаданните на сървъра са на /.well-known/oauth-protected-resource. Инструментите извикват същия код като REST API, така че проверките за собственост, обхватите и ограниченията на заявките са същите.