DomXML

MCP для нейросетей

DomXML поддерживает Model Context Protocol: подключите шахматку к Claude, ChatGPT или AI-редактору кода — и управляйте квартирами, ценами и фидами обычным разговором. Обзор возможностей, все 76 инструментов и сценарии — на странице «API и MCP».

https://domxml.ru/mcp

Два способа авторизации: OAuth (веб-клиенты сами открывают окно подтверждения — вы выбираете ЖК, уровень доступа и срок) или API-ключ из панели (аватарка → API и MCP). Любое подключение видно в разделе «API и MCP» и отзывается одним кликом.

Claude (claude.ai)

Настройки → Connectors → Add custom connector → вставьте https://domxml.ru/mcp. Откроется окно DomXML: войдите, выберите ЖК и уровень доступа — готово.

ChatGPT

Включите Developer Mode (Settings → Connectors → Advanced), добавьте коннектор с адресом https://domxml.ru/mcp и пройдите авторизацию. На тарифах Plus/Pro инструменты работают в режиме чтения, полный доступ — на Business/Enterprise.

Claude Code

claude mcp add --transport http domxml https://domxml.ru/mcp

Клиент сам пройдёт OAuth в браузере. Либо с ключом — в .mcp.json проекта:

{
  "mcpServers": {
    "domxml": {
      "type": "http",
      "url": "https://domxml.ru/mcp",
      "headers": { "Authorization": "Bearer dxk_ВАШ_КЛЮЧ" }
    }
  }
}

Cursor

Файл .cursor/mcp.json:

{
  "mcpServers": {
    "domxml": {
      "url": "https://domxml.ru/mcp",
      "headers": { "Authorization": "Bearer dxk_ВАШ_КЛЮЧ" }
    }
  }
}

VS Code (Copilot)

Файл .vscode/mcp.json — обратите внимание: ключ верхнего уровня здесь servers, а не mcpServers:

{
  "servers": {
    "domxml": {
      "type": "http",
      "url": "https://domxml.ru/mcp"
    }
  }
}

Windsurf

Если прямое подключение не срабатывает, используйте прокладку mcp-remote в mcp_config.json:

{
  "mcpServers": {
    "domxml": {
      "command": "npx",
      "args": ["mcp-remote", "https://domxml.ru/mcp"]
    }
  }
}

OpenCode

Файл opencode.json (в проекте или в ~/.config/opencode/):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "domxml": {
      "type": "remote",
      "url": "https://domxml.ru/mcp",
      "enabled": true
    }
  }
}

Авторизация через OAuth: opencode mcp auth domxml — откроется окно DomXML. Либо с ключом — добавьте в блок domxml поле "headers": { "Authorization": "Bearer dxk_ВАШ_КЛЮЧ" }.

Срок подключения

Срок задаётся при подключении: от 1 до 30 дней или бессрочно. Пока он идёт, клиент по OAuth сам продлевает доступ — токен живёт час и обновляется без вашего участия. Когда срок кончился или подключение отозвано в «API и MCP», DomXML отвечает клиенту 401, инструменты перестают работать, а данные остаются как были. Чтобы продолжить, подключитесь заново: веб-клиенты (Claude, ChatGPT) и opencode mcp auth снова откроют окно подтверждения, где можно выбрать новый срок. С API-ключом так же: истёкший ключ не работает — создайте новый и замените его в конфиге.

Что умеет

CRM — это проект: отдел продаж со своими ЖК, командой, клиентами, витринами и виджетами. Владелец ключа должен быть в команде проекта; инструменты работают в пределах его прав (видимость «только свои», правка чужих, удаление, смена ответственного, задачи другим). Проекты перечисляет whoami (поле crm, идентификатор — crmId); у инструментов crm_* и channel_* есть аргумент crm_id, без него берётся первый проект — свой, иначе тот, куда пригласили. Прежнее имя аргумента owner_public_id тоже принимается. Ключ, ограниченный списком ЖК, видит только клиентов с интересом к этим ЖК и не создаст клиента без complex_id из списка.

Каналами и квизами подключение управляет, только если владелец включил это у ключа: разрешение «Управление витриной и виджетами», а публикация — отдельной подопцией «и публиковать»; кроме того, у владельца ключа должно быть право «Настройка витрины» (и «Публикация») в проекте CRM. Канал собирается только из ЖК своего проекта, заявки с него приходят в CRM этого проекта. Новый канал всегда создаётся выключенным: нейросеть показывает предпросмотр, а в интернет он попадает по явной команде человека. Экран согласия для нейросети такого выбора не предлагает, поэтому подключению по ссылке каналы и квизы недоступны — нужен ключ.

Правки ЖК и объектов попадают в журнал ЖК с пометкой «Нейросеть», изменения каналов и квизов — в их журналы. Удалять через MCP нельзя ничего: объекты, ЖК, фиды, каналы и квизы удаляются в панели (объекты, ЖК и фиды — ещё и по REST API ключом уровня «Полный»). Выдать доступы к ЖК можно только в панели. Фото через MCP не загружаются — в панели или по REST API.