NTRIP Cloud
К документации

MCP-сервер

Возможности MCP-сервера NTRIP Cloud и подключение AI-агентов Koda, Codex и Claude Code.

MCP-сервер связывает ваш аккаунт NTRIP Cloud с AI-помощником. Вы задаёте вопрос обычным языком, а помощник получает данные через инструменты сервера: находит кастер, проверяет сессии, читает причины отказа в подключении или выполняет разрешённые изменения.

MCP — это Model Context Protocol, протокол подключения внешних инструментов к AI-агентам. Для работы с NTRIP Cloud не нужно писать код: достаточно подключить совместимый клиент и войти в свой аккаунт.

Адрес и требования

Адрес MCP-сервера:

https://api.ntripcloud.ru/mcp

Используйте транспорт Streamable HTTP. Нужен аккаунт NTRIP Cloud и MCP-клиент с поддержкой OAuth, автоматического обнаружения настроек авторизации и динамической регистрации клиента. Для управления инфраструктурой нужна роль владельца или администратора соответствующего аккаунта.

MCP работает через API NTRIP Cloud. Устанавливать MCP-сервер на машину с YCCaster не требуется. Этот URL предназначен для AI-клиента; в настройках базы и ровера используются адрес и NTRIP-порт вашего кастера.

Возможности сервера

Проверка инфраструктуры

Помощник может найти доступные вам аккаунты, кастеры, серверы и инстансы. Для инстанса доступны адреса, порты, версия YCCaster, состояние установки и последние сведения о работе сервиса. Можно также получить список доступных облачных регионов и размеров серверов.

Настройки базы и ровера

Сервер возвращает параметры, которые нужно ввести в оборудование: адрес, порт, mount point, логин, доступный пароль и версию NTRIP. Для ровера также можно проверить срок действия клиента, разрешение на подключение и состояние подписки.

Это параметры подключения. Список фактически подключённых баз и роверов нужно получать через инструменты сессий.

Сессии и диагностика

Помощник может посмотреть активные и сохранённые сессии баз и роверов, объём переданных данных, время последнего статуса и наблюдения трафика, время и причину завершения. Доступны фильтры по кастеру, инстансу, mount point и клиенту.

События кастера и результаты авторизации помогают разбирать ошибки подключения. Запись об отказе может содержать причину, но не пароль, отправленный оборудованием.

Статус активной сессии сам по себе не доказывает, что поправки поступают. Сопоставляйте его со свежестью статуса и трафика. Эти данные также не подтверждают RTK Fix или точность позиционирования. Подробнее — в разделе Сессии.

Управление

С правом записи и ролью владельца или администратора помощник может:

  • Создавать и удалять кастеры и облачные серверы.
  • Создавать, устанавливать и удалять инстансы кастера, применять их конфигурацию.
  • Создавать и удалять mount points, менять реквизиты базовой станции и права подключения.
  • Создавать, изменять, отзывать и удалять NTRIP-клиентов, задавать срок действия и назначать пользователя аккаунта.

Создание инстанса и его установка — отдельные операции. Облачный сервер создаётся в фоне; состояние можно проверить следующим запросом. Создание серверов может влиять на стоимость и ограничено подпиской.

Применение конфигурации перезапускает YCCaster. Удаление сервера, кастера или установленного инстанса может остановить подключения. Отзыв клиента удаляет его запись и запрещает новую авторизацию, но не является командой немедленного завершения уже открытой сессии.

Права mount point задаются для владельца, группы и остальных пользователей аккаунта. Это не отдельный список разрешений по ID NTRIP-клиентов. Изменение или удаление mount point, используемого в Relay, может быть заблокировано.

В текущем наборе MCP нет инструментов изменения оплаты, приглашения участников команды, настройки Relay или произвольного выполнения команд на сервере.

Авторизация и права

Подключение проходит через OAuth: агент открывает страницу входа NTRIP Cloud в браузере, после входа вы подтверждаете запрошенный доступ. Вставлять пароль от аккаунта в чат или создавать API-ключ вручную не нужно.

  • casters:read — чтение данных аккаунта.
  • casters:write вместе с casters:read — доступ к инструментам управления. При каждом изменении дополнительно проверяется роль владельца или администратора.

По умолчанию запрашиваются оба разрешения. Для подключения только на чтение клиент должен запросить casters:read до авторизации. Страница согласия показывает запрошенные права; она не заменяет настройку scopes в клиенте.

Даже чтение может раскрывать агенту логины и пароли баз и роверов, если они хранятся в доступном для чтения виде. Для зашифрованного пароля сервер возвращает отсутствие значения. Учитывайте, что ответы инструментов получает выбранный агент и используемый им провайдер модели.

Перед изменениями просите помощника показать аккаунт, ресурсы и план действий. Подтверждения в AI-клиенте и права OAuth — разные механизмы: разрешённый сервером вызов может выполнить реальное изменение.

Подключение Koda

Для русскоязычного рабочего процесса можно использовать Koda CLI. У Koda есть документация на русском и поддержка HTTP MCP с OAuth. Это вариант клиента для работы в России; доступ к конкретным моделям и условия использования проверяйте у провайдера. Совместимость описана по документации Koda; полный вход с NTRIP Cloud в рамках этой инструкции не тестировался.

Установите и настройте Koda по инструкции разработчика, затем добавьте сервер:

koda mcp add ntripcloud --transport http --scope user https://api.ntripcloud.ru/mcp
koda

В интерактивной сессии выполните:

/mcp auth ntripcloud

Завершите вход и подтверждение прав в браузере. Проверьте доступные инструменты командой /mcp. Если список не обновился, выполните /mcp refresh.

При ручной настройке HTTP-сервер задаётся через httpUrl в ~/.kodacli/settings.json:

{
  "mcpServers": {
    "ntripcloud": {
      "httpUrl": "https://api.ntripcloud.ru/mcp"
    }
  }
}

Добавьте запись к существующим настройкам, сохранив остальные серверы. Поле url в Koda означает SSE. Оставьте подтверждения инструментов включёнными: параметр trust: true разрешает вызовы без отдельных подтверждений.

Подключение Codex

В терминале с установленным Codex CLI:

codex mcp add ntripcloud --url https://api.ntripcloud.ru/mcp
codex mcp login ntripcloud
codex mcp list

Пройдите вход в браузере. Откройте новую сессию Codex и проверьте сервер через /mcp.

Для авторизации только на чтение завершите прежнюю MCP-авторизацию и запросите нужный scope:

codex mcp logout ntripcloud
codex mcp login ntripcloud --scopes casters:read

Альтернатива команде добавления — запись в ~/.codex/config.toml:

[mcp_servers.ntripcloud]
url = "https://api.ntripcloud.ru/mcp"

Локальные клиенты Codex используют общую конфигурацию MCP на одном хосте. Подробнее — в официальной документации Codex.

Подключение Claude Code

Добавьте сервер с настройкой для всех ваших проектов:

claude mcp add --transport http --scope user ntripcloud https://api.ntripcloud.ru/mcp
claude mcp list

Запустите Claude Code, введите /mcp, выберите ntripcloud и завершите авторизацию в браузере.

Для режима чтения в версии клиента с поддержкой oauth.scopes можно использовать запись в проектном .mcp.json, затем авторизоваться через /mcp:

{
  "mcpServers": {
    "ntripcloud": {
      "type": "http",
      "url": "https://api.ntripcloud.ru/mcp",
      "oauth": {
        "scopes": "casters:read"
      }
    }
  }
}

Выберите одно место настройки этого сервера. Подробнее — в официальной документации Claude Code.

Первые запросы

Начните с чтения. Если вам доступны несколько аккаунтов, сначала уточните нужный аккаунт. Имена ниже приведены для примера.

Покажи мои аккаунты и кастеры в аккаунте «Геодезия». Ничего не меняй.

Какие роверы сейчас подключены к BASE-01? Покажи время последнего статуса и наблюдения трафика. Отдельно отметь устаревшие данные.

Почему rover-07 не подключается? Проверь последние отказы авторизации, срок действия клиента и права mount point. Покажи найденные причины, ничего не исправляй автоматически.

Какие параметры нужно ввести в базовую станцию? Покажи адрес, порт, mount point и реквизиты источника. Если пароль недоступен, сообщи об этом.

Подготовь создание клиента для новой бригады. Покажи аккаунт, кастер, пользователя и срок действия. Дождись моего подтверждения перед созданием.

Справочник инструментов

Список соответствует текущей реализации сервера: 14 инструментов чтения и 16 инструментов управления. Фактически доступный набор проверяйте в своём клиенте после авторизации.

Чтение

  • accounts_list — доступные аккаунты и ваша роль.
  • casters_list, casters_get — кастеры и количество связанных ресурсов.
  • servers_list, cloud_regions_list — серверы аккаунта, доступные облачные регионы и размеры.
  • caster_instances_list, caster_instances_status — инстансы, адреса, порты и состояние.
  • mount_points_list, clients_list — mount points, клиенты, реквизиты и параметры доступа.
  • rover_connections_list, base_connections_list — настройки подключения оборудования.
  • sessions_list — сессии баз и роверов; по умолчанию только активные, для истории используется active_only: false.
  • caster_events_list, caster_auths_list — события и результаты авторизации.

Списки с параметрами page и limit возвращают has_more. По умолчанию страница содержит до 20 записей, максимум — 100. Для полного списка агент должен запросить следующие страницы. В sessions_list типы — base и rover, а в caster_auths_list — server и client.

Управление

  • casters_create, casters_delete — создать или удалить кастер.
  • servers_create, servers_delete — создать или удалить облачный сервер.
  • caster_instances_create, caster_instances_install — добавить и установить инстанс.
  • caster_instances_delete, caster_instances_apply_config — удалить инстанс или применить конфигурацию с перезапуском.
  • mount_points_create, mount_points_delete — создать или удалить mount point.
  • mount_points_credentials_update, mount_points_access_update — изменить реквизиты источника или права подключения.
  • clients_create, clients_update — создать клиента или изменить его реквизиты, срок действия и назначенного пользователя.
  • clients_revoke, clients_delete — удалить запись клиента и отозвать реквизиты.

Отключение агента

Откройте Подключения MCP, войдите в аккаунт и нажмите Отозвать доступ у нужного клиента. Это отзывает выданные ему токены доступа и обновления для вашего пользователя.

Удаление сервера из локальных настроек агента убирает подключение на этом устройстве. Для отзыва выданного доступа используйте страницу NTRIP Cloud.

Если подключение не работает

  • Требуется авторизация или ответ 401: заново запустите OAuth-вход в клиенте. Убедитесь, что у пользователя есть доступ к аккаунту NTRIP Cloud. Вход в админку не заменяет MCP-авторизацию.
  • Нет инструментов управления: проверьте scope casters:write. Даже с ним изменение требует роли владельца или администратора выбранного аккаунта.
  • Нет нужного ресурса: проверьте выбранный аккаунт, фильтры и следующие страницы списка. Сервер проверяет принадлежность ресурсов аккаунту.
  • Пароль отсутствует: сервер не восстанавливает пароль, который хранится в недоступном для чтения виде. Сброс реквизитов — отдельное изменение.
  • Установка или создание завершились тайм-аутом: сначала проверьте состояние сервера или инстанса. Не повторяйте создание вслепую: операция могла уже начаться.
  • Клиент не умеет пройти OAuth: одной поддержки MCP недостаточно. Используйте актуальную версию с HTTP, OAuth и динамической регистрацией; не подставляйте токен входа в админку.

Команды подключения сверены с документацией клиентов 3 октября 2026 года. При изменениях интерфейса ориентируйтесь на ссылки в соответствующих разделах.