2ГИС MCP: поиск организаций, адреса и маршруты в ИИ-агенте

Шесть сценариев с картами и справочником 2ГИС

Серверы ниже только читают данные 2ГИС. Они различаются набором API, способом установки и тем, сколько транспорта знают маршруты.

• Официальный 2GIS MCP дает шесть инструментов. search_poi ищет места рядом с точкой, calculate_route строит маршрут между адресами или координатами, geocode и reverse_geocode переводят адрес в координаты и обратно, calculate_isochrone считает зону доступности, а create_map_view возвращает статичную PNG-карту с маркерами.
• Маршруты на машине, пешком, на велосипеде, такси, самокате и общественном транспорте строит 2GIS MCP от theyahia. Из девяти его инструментов один показывает рейтинг и число отзывов о месте.
• Поиск мест, автодополнение адресов, категории бизнеса и регионы без маршрутов покрывает MCP-сервер поиска 2ГИС. Его можно запустить локально или в Docker Compose на порту 8101.
• Карточку организации в 2ГИС, Яндекс Геокодере и Google Places сравнивает MCP локального SEO. Сервер разворачивают на своем Cloudflare Workers, и он отдает сводку по отзывам из всех трех источников.
• Аудит карточки бизнеса сразу на трех площадках ведет скилл локального SEO. Он сверяет название, адрес и телефон, рубрики, часы работы и дубли, а план правок собирает из скриншотов и описаний, которые вы передадите.
• Для пробы связки модели и карт подойдет прототип MapGL MCP Server. Автор показывает на нем сравнение районов Москвы по числу кафе и парков в пешей доступности.

Как получить ключ API 2ГИС

Ключи выдает кабинет Платформы 2ГИС на platform.2gis.ru. После регистрации там можно взять бесплатный демо-ключ на 30 дней с лимитами запросов или оформить подписку. В демо-ключ сразу включены все API, которые нужны официальному серверу.

Официальный сервер читает две переменные. MAPGL_API_KEY отвечает за карты и поиск, ROUTING_API_KEY за навигацию, и при демо-ключе в обе можно вписать один и тот же ключ. По платной подписке 2ГИС советует завести два ключа, чтобы отдельно следить за расходом поиска и маршрутов.

В npm официальный пакет не опубликован. Репозиторий github.com/2gis/2gis-mcp клонируют, собирают командами npm install и npm run build, а в конфигурацию клиента прописывают путь к dist/index.js и ключи. Сервер theyahia ставится одной командой npx skillfoxx add mcp/theyahia-2gis-mcp.

Ключ, привязанный к App ID мобильного SDK 2ГИС, этому серверу не подойдет. Координаты он принимает в порядке долгота, широта.

Официальный сервер или сторонний

Для поиска мест, геокодирования и маршрута на машине хватит официального сервера 2ГИС. Уровень доступа у него минимальный, VPN не требуется, инструменты описаны в документации 2ГИС. Если нужен общественный транспорт, самокат или такси, ставьте сервер theyahia. У него расширенный уровень, потому что он тратит квоту ключа и часть данных берет из недокументированного метода.

Сервер поиска 2ГИС и MCP локального SEO тоже только читают публичные данные, но их нужно развернуть самому. У скилла локального SEO расширенный уровень. С вашего подтверждения он может публиковать правки в карточки, загружать фото и отвечать на отзывы от имени бизнеса.

Сервер 2ГИС входит и в монорепозиторий WWmcp, где рядом лежат платежные и CRM-серверы. Широкий уровень доступа там относится ко всему набору, поэтому из него стоит ставить только пакет 2ГИС.

Квоты, подписка и данные

Ни один из серверов ничего не меняет в 2ГИС, но каждый запрос списывается с квоты ключа. Демо-ключ ограничен числом запросов. У сервера theyahia в карточке указан ориентир около тысячи запросов на сервис. Маршруты и общественный транспорт работают, только если они входят в вашу подписку, иначе API вернет ошибку 403.

Ключ к Search API 2ГИС иногда выдает только по заявке и вправе запросить описание сценария или ограничить регион и объем запросов. Тексты отзывов сервер theyahia получает через недокументированный метод. Такой источник может перестать отвечать без предупреждения.

В MCP локального SEO секрет коннектора записан прямо в пути URL. Ссылку на такой сервер храните как пароль и не публикуйте в общих конфигурациях.