MCP-сервер 2ГИС: как подключить ИИ-агента к адресам, маршрутам и картам

MCP-сервер 2ГИС — это готовый «переходник», через который ИИ-агент вызывает существующие API 2ГИС: ищет организации и адреса, переводит адрес в координаты, строит маршруты, считает время в пути и рисует карту с метками. Подключить его можно двумя способами: к облачному серверу 2ГИС по адресу из документации или к собственному серверу, собранному из открытого кода. Нужен ключ API 2ГИС: бесплатный демо-ключ действует 30 дней с лимитами запросов, дальше — платная подписка по тем же тарифам, что и прямые вызовы API. Для бизнеса главная польза — агент перестаёт придумывать адреса и расстояния и берёт их из геоданных.

Материал подготовлен AIrassvet по документации 2ГИС и публикациям, проверенным 12 октября 2026 года. Он адресован руководителям логистики, доставки, выездного сервиса и продаж, а также разработчикам, которые подключают ИИ-агентов к бизнес-процессам. Это практическое руководство: в нём есть выбор варианта сервера, шаги подключения, проверка, расчёт тарификации и чек-лист запуска. Мы не тестировали MCP-сервер 2ГИС на собственных задачах; все параметры взяты из документации разработчика. AIrassvet не аффилирован с 2ГИС; раздел в конце статьи описывает услуги издателя.

Содержание

Кратко: что нужно знать
Что такое MCP-сервер 2ГИС
Какие инструменты доступны агенту
Облачный или локальный сервер: как выбрать
Как подключить: пошаговая инструкция
Сколько стоит и как считаются запросы
Бизнес-сценарии: где геоданные нужны агенту
Как формулировать задачи агенту
Ограничения и риски
Чек-лист запуска
Частые вопросы
Первоисточники и метод проверки

Кратко: что нужно знать

Новых геоданных MCP-сервер не даёт: он открывает агенту те же Places, Geocoder, Routing и другие API 2ГИС через стандартный протокол.
Есть два варианта: облачный сервер 2ГИС (без установки, нужен клиент со Streamable HTTP) и локальный дистрибутив из открытого кода (разворачиваете у себя).
Нужен ключ API: демо-ключ на 30 дней включает все нужные API, но ограничен по числу запросов; для работы — подписка.
Тарифы те же, что у API: платите за успешные запросы и единицы тарификации — маршруты, комбинации точек в матрице расстояний, объём задачи для курьеров.
Агенту нужна правильная последовательность: сначала координаты по адресу, потом маршрут — иначе он может построить маршрут по выдуманным координатам.
Для массовой обработки MCP не нужен: пакетное геокодирование тысяч адресов дешевле и надёжнее делать прямыми вызовами API без языковой модели.

Что такое MCP-сервер 2ГИС

MCP (Model Context Protocol) — открытый протокол, по которому ИИ-агент получает доступ к внешним инструментам и данным в едином формате. MCP-сервер описывает, какие инструменты доступны, принимает вызовы агента и возвращает результат.

По документации 2ГИС, MCP-сервер API-платформы 2ГИС предоставляет агентам доступ к картам, адресам, маршрутам и данным об организациях. Схема работы такая:

Пользователь ставит агенту задачу, например найти все круглосуточные аптеки рядом с точкой.
Агент решает, какие геоданные нужны, и вызывает инструмент MCP-сервера.
Сервер обращается к нужному API 2ГИС — например, к Places API для поиска объектов.
Агент получает результат и формирует ответ.

О выпуске сервера 24 сентября 2026 года сообщил «Код.ру» со ссылкой на пресс-службу 2ГИС. Издание подчёркивает: речь не о новых геоданных и не об отдельном API для нейросетей, а о готовом интерфейсе к существующим сервисам. Код локального сервера опубликован в репозитории 2ГИС на GitHub.

Зачем это бизнесу. Языковая модель без доступа к геоданным уверенно пишет правдоподобные, но выдуманные адреса, расстояния и время в пути. MCP-сервер заменяет догадки модели ответами геосервиса, а агент берёт на себя то, что раньше требовало отдельной интеграции: понять запрос на естественном языке, выбрать нужный сервис и связать результат с задачей.

Какие инструменты доступны агенту

Набор инструментов у облачного и локального сервера различается, это важно учитывать при выборе.

Облачный сервер (документация):

Инструмент	Что делает	API 2ГИС
search_places	поиск мест, организаций и адресов	Places API
geocode_address	адрес → координаты	Geocoder API
build_route	маршрут на разных видах транспорта, время и расстояние	Routing API
calculate_distance_matrix	время и расстояние между парами точек	Distance Matrix API
render_static_map	статическая карта с маркерами в PNG	Static API
auth_probe	проверка ключа и доступности API	все перечисленные

Служебные инструменты server_info, list_resources и read_resource работают без ключа: они показывают состояние сервера и справку по параметрам API.

Локальный сервер (документация):

Инструмент	Что делает	API 2ГИС
search_poi	поиск мест и организаций по запросу и координатам	Places API, Geocoder API
calculate_route	маршрут, время и расстояние	Routing API
geocode	адрес → координаты	Geocoder API
reverse_geocode	координаты → адрес	Geocoder API
create_map_view	статическая карта с маркерами в PNG	Static API
calculate_isochrone	область, достижимая из точки за заданное время	Isochrone API

Что из этого следует: матрица расстояний есть в облачном варианте, а обратное геокодирование и изохроны — зоны доступности за заданное время — в локальном.

Облачный или локальный сервер: как выбрать

Критерий	Облачный сервер	Локальный сервер
Установка	не нужна, адрес сервера из документации	клонировать репозиторий, npm install, npm run build
Требования к клиенту	Streamable HTTP и статические заголовки; клиенты только с Plain SSE или stdio не подходят	любой MCP-клиент; по HTTP — через Supergateway
Сеть	исходящие HTTPS-соединения к серверу 2ГИС	запросы идут только к API 2ГИС
Инструменты	есть матрица расстояний и проверка ключа	есть обратное геокодирование и изохроны
Контроль	сервер и его обновления у 2ГИС	сервер, доступ и журналирование — у вас
Полностью локальная модель	зависит от клиента	документация описывает работу с LM Studio: модель на вашем компьютере, сервер обращается только к API 2ГИС

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

В обоих вариантах сами запросы к геоданным уходят в API 2ГИС. Если вопросы пользователей содержат персональные или коммерческие данные, проверьте, что агент передаёт в геосервис только адреса и координаты, а не весь контекст заказа. Подробнее о правилах передачи данных во внешние ИИ-сервисы — в статье о том, можно ли отправлять клиентские данные в ИИ.

Как подключить: пошаговая инструкция

Шаг 1. Получите ключ API

Зарегистрируйтесь в личном кабинете «Менеджер Платформы» 2ГИС и оформите демо-ключ (30 дней, лимиты запросов, все нужные API подключены автоматически) или купите подписку. Для локального сервера 2ГИС рекомендует два ключа: один для карт и поиска (Static, Geocoder, Places API), второй для навигации (Routing, Isochrone API). По документации, количество ключей не влияет на стоимость подписки, а раздельные ключи помогают контролировать расход.

Шаг 2а. Облачный сервер: добавьте адрес в клиент

Адрес облачного сервера: https://mcp-2gis.api.2gis.com/mcp. Ключ передаётся в заголовке. В примерах ниже значения в угловых скобках и переменную $DGIS_API_KEY замените своим ключом и путями. Для Claude Code документация приводит такую команду:

claude mcp add --transport http 2gis https://mcp-2gis.api.2gis.com/mcp \
  --header "Authorization: Bearer $DGIS_API_KEY"

Для платформ создания ИИ-ассистентов, включая ГигаЧат, документация предлагает универсальную конфигурацию с заголовком X-2GIS-API-Key — он нужен, если заголовок Authorization в платформе уже занят:

{
  "mcpServers": {
    "2gis": {
      "type": "streamable_http",
      "url": "https://mcp-2gis.api.2gis.com/mcp",
      "headers": { "X-2GIS-API-Key": "<КЛЮЧ_API>" }
    }
  }
}

Шаг 2б. Локальный сервер: соберите и подключите

Клонируйте репозиторий, выполните npm install и npm run build — появится файл dist/index.js. В конфигурации клиента укажите запуск через Node.js и два ключа в переменных окружения:

{
  "mcpServers": {
    "2gis": {
      "command": "node",
      "args": ["<ПУТЬ_К_РЕПОЗИТОРИЮ>/dist/index.js"],
      "env": {
        "MAPGL_API_KEY": "<КЛЮЧ_КАРТЫ_И_ПОИСК>",
        "ROUTING_API_KEY": "<КЛЮЧ_НАВИГАЦИЯ>"
      }
    }
  }
}

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

Шаг 3. Проверьте работу

Попросите агента проверить ключ и доступные инструменты. Для облачного сервера документация ожидает цепочку вызовов tools/list → server_info → auth_probe. Затем дайте конкретную задачу — например, найти три кофейни рядом с выбранной точкой и проложить пешеходный маршрут к ближайшей. Агент должен вызвать поиск мест, затем построение маршрута.

Типовые ошибки облачного сервера: MCP_API_KEY_REQUIRED — ключ не передан; MCP_API_KEY_INVALID — ключ недействителен или в нём не подключены нужные API; MCP_2GIS_API_UNAVAILABLE — сервис временно недоступен.

Сколько стоит и как считаются запросы

По правилам тарификации 2ГИС, MCP-сервер не меняет цены: действуют тарифы и лимиты обычной подписки на API. Доступ покупается пакетами единиц тарификации, а успешным считается запрос с HTTP-кодом 200 или 204.

Сервис	Что считается единицей	Пример из документации
Places, Geocoder, Static API	успешный запрос	—
Routing API	построенный маршрут для каждой пары «откуда — куда»	5 пар в одном запросе = 5 расчётов
Distance Matrix API	каждая комбинация точек отправления и прибытия	2 × 3 точки = 6 расчётов
TSP API (задача курьера)	число точек × число курьеров	5 точек × 2 курьера = 10 расчётов

Почему это важно для агента. Языковая модель не видит тарифов и может «для надёжности» запросить лишнее. Например, если агент диспетчера сравнивает 10 машин с 20 заказами через матрицу расстояний, это 10 × 20 = 200 единиц за один вопрос (наш расчёт по правилу из документации). Повторите его при каждом уточнении диспетчера — и пакет закончится быстрее, чем вы планировали.

Лимиты демо-ключа на дату проверки: по 1 000 запросов к Places, Geocoder, Routing и Distance Matrix API и 30 000 — к Static API за весь срок. Для подписки действуют поминутные ограничения, например 600 единиц в минуту для Places, Geocoder и Routing API и 3 000 — для Static API. Актуальные пакеты и цены смотрите в личном кабинете: в этой статье мы их не приводим, потому что они зависят от подписки.

Бизнес-сценарии: где геоданные нужны агенту

Проверка адресов в заказах. Агент, который принимает заказы из мессенджера или почты, переводит адрес в координаты, уточняет у клиента неоднозначные варианты («улица Ленина есть в двух районах») и записывает в CRM уже проверенную точку. Это может сократить число ошибочных выездов курьеров, но эффект нужно измерять на своих данных.

Диспетчеризация выездного сервиса. Агент подбирает ближайшего свободного инженера и называет время в пути, а диспетчер подтверждает назначение. Подробнее о задачах выездных служб — в статье об ИИ для сервисной службы и выездных инженеров.

Логистика и доставка. Агент отвечает на вопросы «успеем ли до 18:00», «какой склад ближе к клиенту», готовит карту с точками маршрута для водителя. Для перевозчиков полезно связать это с документооборотом — см. ИИ для транспортной компании.

Зоны обслуживания и аналитика. С изохронами (в локальном варианте) агент показывает, какие адреса попадают в 30-минутную зону доставки от склада или до каких районов можно добраться от нового офиса за заданное время.

Поиск партнёров и точек продаж. Агент находит организации заданной категории в районе — например, аптеки или СТО — для отдела продаж или для проверки конкурентного окружения перед открытием точки.

Где агент не нужен. Если задача — пакетно геокодировать базу из десятков тысяч адресов или ночью пересчитать маршруты, языковая модель только добавит стоимость и риск ошибки. Такие задачи решаются прямыми вызовами API и обычным кодом, а агент подключается там, где запрос приходит на естественном языке.

Как формулировать задачи агенту

Документация 2ГИС даёт пять рекомендаций, которые стоит включить в системный промпт агента:

Задавайте последовательность: «сначала получи координаты по адресу, затем проложи маршрут». Это защищает от частой ошибки — маршрута по выдуманным координатам.
Разбивайте большие задачи: вместо одной матрицы 25 × 25 точек — несколько меньших.
Указывайте тип транспорта и ограничения: «на автомобиле без платных дорог», «пешком».
Указывайте нужное число результатов: «три ближайшие», «пять с лучшим рейтингом».
Указывайте язык ответа явно.

К этому стоит добавить правила со стороны бизнеса: какие данные агент может передавать в геосервис, сколько вызовов допустимо на один вопрос и когда нужно подтверждение человека — например, перед назначением выезда или изменением адреса в заказе. Как описывать такие правила, мы разбирали в материале о техническом задании на ИИ-агента.

Ограничения и риски

Ключ — это деньги. Документация для некоторых клиентов показывает передачу ключа прямо в адресе сервера. Такой адрес легко попадает в журналы и скриншоты; используйте передачу в заголовке, где клиент это позволяет, и отдельный ключ с ограниченным лимитом для каждого агента.
Агент может вызывать инструменты лишний раз. Ограничьте лимиты на уровне ключей в личном кабинете и число вызовов на один запрос в настройках агента.
Ответ агента — не ответ геосервиса. Модель может неверно пересказать результат. Для решений, которые стоят денег, сохраняйте исходные данные вызова и показывайте их человеку.
Наборы инструментов различаются. Сценарий, построенный на изохронах, не перенесётся на облачный сервер без изменений, а сценарий на матрице расстояний — на локальный.
Код сервера опубликован недавно. Репозиторий на GitHub создан 24 августа 2026 года; перед продуктивным использованием проверьте условия лицензии и порядок обновлений.
Зависимость от внешнего сервиса. При недоступности API агент должен честно сообщать об ошибке, а не подставлять «примерные» данные.

Чек-лист запуска

Выбран один сценарий и критерий успеха, например доля заказов с проверенным адресом.
Выбран вариант сервера: облачный или локальный, с учётом нужных инструментов.
Оформлен ключ; для продуктивной работы — отдельные ключи для поиска и навигации, лимиты настроены.
Ключ передаётся в заголовке, а не в адресе, и хранится в секретах, а не в коде.
В системном промпте задана последовательность «адрес → координаты → маршрут» и лимит вызовов.
Определено, какие данные агент передаёт в геосервис, и согласовано со службой безопасности.
Действия, которые меняют заказ или назначение, требуют подтверждения человека.
Проверка цепочкой server_info → auth_probe пройдена, есть тест на 20–30 реальных запросах.
Посчитан ожидаемый расход единиц тарификации на один вопрос и на месяц.
Настроено журналирование вызовов для разбора ошибок.

Частые вопросы

Что такое MCP-сервер 2ГИС?

Это сервер по открытому протоколу Model Context Protocol, через который ИИ-агент вызывает API 2ГИС: поиск мест и организаций, геокодирование, маршруты, статические карты и, в зависимости от варианта, матрицу расстояний или изохроны. Новых данных он не добавляет — это интерфейс к существующим API.

Сколько стоит MCP-сервер 2ГИС?

Сам сервер отдельно не тарифицируется: действуют тарифы и лимиты подписки на API 2ГИС, как при прямых запросах. Для теста есть бесплатный демо-ключ на 30 дней с лимитом, например 1 000 запросов к Places API и 1 000 — к Routing API.

Можно ли развернуть MCP-сервер 2ГИС у себя?

Да. 2ГИС публикует код локального сервера на GitHub: репозиторий собирается командами npm install и npm run build. При этом запросы к геоданным всё равно идут в API 2ГИС, а локальным остаётся сам сервер и, при желании, языковая модель.

Какие ИИ-клиенты поддерживаются?

Документация облачного сервера описывает подключение ChatGPT, Claude Desktop и Claude Code, Cursor, VS Code, Windsurf, Cline, Gemini CLI, платформ создания ассистентов, включая ГигаЧат, и собственного клиента на Python. Для локального сервера описаны Claude Desktop, LM Studio и Cursor.

Чем облачный сервер отличается от локального?

Облачный не требует установки и умеет считать матрицу расстояний и проверять ключ. Локальный разворачивается у вас и умеет обратное геокодирование и изохроны. Для облачного нужен клиент с поддержкой Streamable HTTP.

Почему агент строит маршрут не туда?

Частая причина — агент строит маршрут по координатам, которые придумал сам, не вызвав геокодирование. Документация 2ГИС рекомендует прямо задавать последовательность: сначала получить координаты по адресу, затем строить маршрут.

Первоисточники и метод проверки

Мы прочитали документацию и публикации 12 октября 2026 года. Набор инструментов, способы подключения, рекомендации по промптам, ошибки и правила тарификации взяты из документации 2ГИС; дата выпуска и комментарии компании — из публикации «Код.ру»; дата создания репозитория — из GitHub. Бизнес-сценарии, чек-лист и пример расчёта единиц для диспетчерской задачи — редакционная методика AIrassvet, а не результат нашего тестирования.

2ГИС: обзор MCP-сервера — схема работы, варианты, рекомендации по промптам.
2ГИС: облачный MCP-сервер — адрес, инструменты, конфигурации клиентов, проверка, ошибки.
2ГИС: локальный MCP-сервер — инструменты, сборка, переменные окружения, ключи.
2ГИС: тарифы и правила тарификации — единицы тарификации, поминутные лимиты, лимиты демо-ключа.
«Код.ру», 24.09.2026: 2ГИС выпустил MCP-сервер для ИИ-агентов.
GitHub: репозиторий 2gis/2gis-mcp.

Ограничения: мы не проверяли качество ответов агента с MCP-сервером на реальных задачах; цены пакетов не приводим, так как они зависят от подписки; документация может меняться — сверяйте набор инструментов и лимиты перед запуском.

Как AIrassvet помогает подключить ИИ-агента к геоданным

Если вы хотите, чтобы агент проверял адреса в заказах, подбирал ближайшего исполнителя или отвечал диспетчеру о времени в пути, MCP-сервер — только одна деталь: агенту нужны ещё ваши заказы, CRM, правила и контроль действий. На сайте AIrassvet описаны направления, которые относятся к этой задаче напрямую:

ИИ-агенты, интегрированные с каналами связи и бизнес-системами компании, например CRM, через которые приходят заказы.
Агентная автоматизация процессов в интерфейсах учётных систем, например 1С.
Развёртывание языковых моделей на серверах компании, когда данные заказов нельзя передавать во внешний сервис.
Аудит процесса, тестирование на реальных запросах, запуск и сопровождение.

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

Обсудить задачу.

Итог: геоданные вместо догадок модели

MCP-сервер 2ГИС закрывает одну из самых неприятных слабостей ИИ-агентов в логистике, доставке и сервисе — выдуманные адреса и расстояния. Он не добавляет новых данных, но позволяет агенту по запросу на естественном языке вызвать геокодирование, поиск, маршруты и карты 2ГИС. Облачный сервер подходит для быстрого пилота, локальный — для работы в своём контуре и сценариев с изохронами.

Начните с одного сценария и демо-ключа: задайте агенту последовательность «адрес → координаты → маршрут», ограничьте число вызовов, посчитайте единицы тарификации на один вопрос и проверьте агента на 20–30 реальных запросах. Если ответы совпадают с тем, что дал бы диспетчер, подключайте CRM и переходите на подписку.