Custom Domain API — MCP-сервер для Claude Code: установка
MCP-сервер управляет пользовательскими доменами SaaS: показывает DNS-записи, проверяет подключение и создаёт ссылки на настройку.
claude mcp add custom-domain -e CUSTOM_DOMAIN_API_URL=<CUSTOM_DOMAIN_API_URL> -e CUSTOM_DOMAIN_API_KEY=<CUSTOM_DOMAIN_API_KEY> -- uvx custom-domain-mcpЧто делает Custom Domain API
Custom Domain API даёт ИИ-инструменты для регистрации hostname клиента в workspace, просмотра статуса и DNS-записей, фильтрации доменов, повторной проверки и удаления. Отдельные инструменты формируют инструкции для клиента, создают или отзывают ссылку на страницу настройки, а также показывают подписки webhook без секретов.
Сервер запускается через uvx custom-domain-mcp и использует CUSTOM_DOMAIN_API_URL и CUSTOM_DOMAIN_API_KEY. URL должен работать по HTTPS, кроме локального localhost. Если развёртывание не задаёт PUBLIC_API=true и EDGE_HOSTNAME, создание ссылки настройки завершится ошибкой connect_page_unavailable. Для интеграции tenant нужно выбирать из проверенного X-Custom-Domain-Assertion, а не из Host.
Какие задачи решает
- зарегистрировать hostname клиента в workspace
- показать DNS-записи и статус домена
- повторить проверки после изменения DNS
- отозвать ссылку настройки или удалить hostname
Примеры запросов агенту
- Зарегистрируй hostname
app.example.comдля workspace и покажи DNS-записи. - Проверь статус домена и повтори DNS-проверку после исправления записей.
- Создай ссылку на страницу настройки для этого домена и верни её мне.
Как установить Custom Domain API
Командой платформы
claude mcp add custom-domain -e CUSTOM_DOMAIN_API_URL=<CUSTOM_DOMAIN_API_URL> -e CUSTOM_DOMAIN_API_KEY=<CUSTOM_DOMAIN_API_KEY> -- uvx custom-domain-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from custom-domain-mcp <команда>
Командой платформы
codex mcp add mcp-server --env CUSTOM_DOMAIN_API_URL=<CUSTOM_DOMAIN_API_URL> --env CUSTOM_DOMAIN_API_KEY=<CUSTOM_DOMAIN_API_KEY> -- uvx custom-domain-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from custom-domain-mcp <команда>
Файл настроек
{
"mcpServers": {
"mcp-server": {
"command": "uvx",
"args": [
"custom-domain-mcp"
],
"env": {
"CUSTOM_DOMAIN_API_URL": "<CUSTOM_DOMAIN_API_URL>",
"CUSTOM_DOMAIN_API_KEY": "<CUSTOM_DOMAIN_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from custom-domain-mcp <команда>
Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"custom-domain-mcp"
],
"env": {
"CUSTOM_DOMAIN_API_URL": "<CUSTOM_DOMAIN_API_URL>",
"CUSTOM_DOMAIN_API_KEY": "<CUSTOM_DOMAIN_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from custom-domain-mcp <команда>
Командой платформы
gemini mcp add -e CUSTOM_DOMAIN_API_URL=<CUSTOM_DOMAIN_API_URL> -e CUSTOM_DOMAIN_API_KEY=<CUSTOM_DOMAIN_API_KEY> mcp-server uvx custom-domain-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from custom-domain-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Custom Domain API
Как установить Custom Domain API в Claude Code?
Выполните `claude mcp add custom-domain -e CUSTOM_DOMAIN_API_URL=<CUSTOM_DOMAIN_API_URL> -e CUSTOM_DOMAIN_API_KEY=<CUSTOM_DOMAIN_API_KEY> -- uvx custom-domain-mcp`.
Что делает Custom Domain API?
Он регистрирует hostname клиентов, показывает DNS-записи и результаты проверок, создаёт ссылки на настройку, а также позволяет повторно проверить или удалить домен.
Что нужно для создания ссылки на страницу настройки?
Развёртывание должно задавать PUBLIC_API=true и EDGE_HOSTNAME. Иначе инструмент вернёт connect_page_unavailable.
