2ГИС·2gis

2ГИС MCP — подключение и инструкция

2ГИС MCP для MapGL подключает агента к географическим инструментам проекта 2gis-mcp и поддерживаемым расчётам маршрутов.

Рабочие сервисыЛокальноAPI-ключ

Что умеет этот сервер

01

2ГИС MCP для MapGL подключает агента к географическим инструментам проекта 2gis-mcp и поддерживаемым расчётам маршрутов.

02

Репозиторий 2gis/2gis-mcp — локальная stdio-реализация MapGL.

03

Прочитай схемы доступных tools и рассчитай один небольшой маршрут/географический сценарий.

Задача для знакомства

Через 2ГИС MCP покажи доступные tools и параметры тестового маршрута. Массовые запросы и платные расчёты пока не запускай.

Уточнить результат

Сверь порядок координат, профиль транспорта и реальные параметры API. Успешный MCP handshake не доказывает доступность коммерческого routing key.

Как подключить

Выберите подходящий способ

Подключить 2ГИС MCP

Скачай 2gis/2gis-mcp, установи зависимости через npm install и собери npm run build. В клиенте укажи node с абсолютным dist/index.js. Настрой MAPGL_API_KEY и при необходимости ROUTING_API_KEY; demo не заменяет свои рабочие ключи.

Что понадобится

  • Node.js/npm, TypeScript build и ключи нужных 2ГИС API. Доступ и квоты конкретных сервисов оформляются отдельно.
  1. 01

    Подготовь окружение

    Node.js/npm, TypeScript build и ключи нужных 2ГИС API. Доступ и квоты конкретных сервисов оформляются отдельно.

  2. 02

    Установи и настрой

    Скачай 2gis/2gis-mcp, установи зависимости через npm install и собери npm run build. В клиенте укажи node с абсолютным dist/index.js. Настрой MAPGL_API_KEY и при необходимости ROUTING_API_KEY; demo не заменяет свои рабочие ключи.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Первый запрос — пример для чата агента

Через 2ГИС MCP покажи доступные tools и параметры тестового маршрута. Массовые запросы и платные расчёты пока не запускай.

Как проверить

Сверь порядок координат, профиль транспорта и реальные параметры API. Успешный MCP handshake не доказывает доступность коммерческого routing key.

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

README и установка автора

Что умеет 2ГИС

2ГИС MCP для MapGL подключает агента к географическим инструментам проекта 2gis-mcp и поддерживаемым расчётам маршрутов.

Репозиторий 2gis/2gis-mcp — локальная stdio-реализация MapGL. Не следует приписывать ей весь коммерческий API 2ГИС или облачный MCP, отмеченный на продуктовой странице как будущий вариант.

Что подготовить перед подключением

Node.js/npm, TypeScript build и ключи нужных 2ГИС API. Доступ и квоты конкретных сервисов оформляются отдельно.

Как установить и подключить

Скачай 2gis/2gis-mcp, установи зависимости через npm install и собери npm run build. В клиенте укажи node с абсолютным dist/index.js. Настрой MAPGL_API_KEY и при необходимости ROUTING_API_KEY; demo не заменяет свои рабочие ключи.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Прочитай схемы доступных tools и рассчитай один небольшой маршрут/географический сценарий. Явно задай координаты, транспорт и требуемый результат.

Как проверить результат и решить проблемы

Сверь порядок координат, профиль транспорта и реальные параметры API. Успешный MCP handshake не доказывает доступность коммерческого routing key.

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

Ограничения

Это конкретная реализация, а не гарантия всех геосервисов 2ГИС. Точность, охват и лимиты определяются подключённым API.

Исходники и документация

Репозиторий: 2gis/2gis-mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о 2ГИС

2ГИС MCP для MapGL подключает агента к географическим инструментам проекта 2gis-mcp и поддерживаемым расчётам маршрутов.
Вернуться в библиотеку