MCP-сервер
Домены
Добавление доменов, DNS-записи, которые им нужны, и их адреса.
Инструменты доменов
| Инструмент | Что делает |
|---|---|
| listDomains | Домены в этом рабочем пространстве, с тем, верифицирован ли каждый, может ли отправлять, включён ли у него catch-all и сколько у него адресов. Возвращаются постранично. |
| getDomain | Всё об одном домене, по id или имени, включая все DNS-записи для публикации и то, найдена ли каждая, отсутствует или ещё не проверялась. |
| addDomain | Добавить домен и получить DNS-записи, которые нужно опубликовать у его DNS-хостинга. |
| verifyDomain | Сейчас снова проверить DNS домена и сказать, каких записей всё ещё не хватает. |
| setDomainCatchAll | Включить или выключить catch-all, чтобы почту принимал либо любой адрес на домене, либо только его перечисленные адреса. |
| removeDomain | Удалить домен и отозвать записи, созданные у подключённого DNS-хостинга. Чат всегда сначала спрашивает. |
| listDomainAddresses | Адреса на одном домене, с их меткой, тем, принимает ли каждый почту, и когда он последний раз что-то получил. Возвращаются постранично. |
| addDomainAddress | Создать адрес на домене с необязательной меткой. |
| updateDomainAddress | Изменить метку адреса, принимает ли он почту, или и то и другое. |
| removeDomainAddress | Удалить адрес, чтобы он перестал принимать почту и любой вход под ним прекратился. Чат всегда сначала спрашивает. |
Для чтения требуется domains:read, для изменения domains:write. Домен охватывает все адреса на нём, поэтому клиент, ограниченный некоторыми адресами или доменами, не может добавить домен и меняет домен или его адреса, только если охватывает этот домен целиком.
Последний домен рабочего пространства нельзя удалить отсюда, потому что его удаление удаляет вместе с ним весь почтовый ящик. Это делается в приложении, где сначала запрашивается подтверждение.
Инструменты работают точно так же, как REST API, а страницы /domains справочника API описывают каждое поле и каждый отказ.
