Как подключить openrouteservice к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → openrouteservice, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

openrouteservice + Gemini

Маршрутизация openrouteservice (HeiGIT) на данных OpenStreetMap: геокодирование и обратное геокодирование, маршруты с пошаговыми подсказками для автомобиля, грузовика, велосипеда, пешехода и инвалидной коляски, матрицы времени в пути, изохроны (зоны доступности), оптимизация маршрутов для нескольких машин и точки интереса. Бесплатный API-ключ.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

OPENROUTESERVICE_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужны бесплатный аккаунт HeiGIT и API-ключ. Бесплатного тарифа хватает для тестов и небольшой рабочей нагрузки.

1. Бесплатно зарегистрируйтесь на account.heigit.org и создайте API-ключ в панели управления, в разделе tokens.
2. Вставьте только ключ в OPENROUTESERVICE_API_KEY, без слова Bearer, пробелов и кавычек. Коннектор передаёт его в заголовке Authorization.
3. Установите коннектор и запустите openrouteservice_geocode с названием места, например Berlin: он вернёт место с координатами, и станет ясно, что ключ работает.

Актуальный адрес: коннектор обращается к https://api.heigit.org, текущему адресу openrouteservice. HeiGIT отключает старый адрес api.openrouteservice.org в ноябре 2026 года; созданные там ключи работают и здесь, так что можно оставить имеющийся ключ.

Что он умеет: всё работает на данных OpenStreetMap. Он переводит адреса в координаты и обратно (геокодирование, автодополнение при вводе, обратное геокодирование); строит маршруты с расстоянием, временем и пошаговыми подсказками для автомобиля, грузовика (driving-hgv), велосипеда, пешехода и инвалидной коляски, при желании в объезд автомагистралей, платных дорог и паромов; считает матрицы времени в пути между многими точками; строит изохроны, то есть зону, куда можно добраться за заданное время или расстояние; решает задачу развозки для нескольких машин (VROOM) с временными окнами, вместимостью и навыками; и находит точки интереса вокруг точки: магазины, АЗС, аптеки, зарядные станции.

Сначала долгота: все инструменты маршрутизации принимают координаты в виде [долгота, широта], например [7.8421, 47.9990] для Фрайбурга. Перепутанный порядок обычно приводит к тому, что точка не находится или маршрут заканчивается в море. Поэтому ИИ сначала геокодирует адреса и передаёт координаты без изменений.

Единицы: время приходит в секундах, ИИ переводит его в часы и минуты. Расстояния по умолчанию в километрах. Для изохрон диапазон задаётся в секундах или, если это расстояние, в метрах.

Только чтение: коннектор только считает. Некоторые инструменты отправляют запрос методом POST, но ни один ничего не меняет в вашем аккаунте HeiGIT, поэтому подтверждать нечего и при установке ничего не отключено.

Ограничения: бесплатный тариф допускает около 2 000 запросов маршрута в день и 40 в минуту, а для матриц, изохрон, оптимизации и точек интереса дневные квоты меньше. Каждый ответ содержит x-ratelimit-remaining, и ИИ предпочитает одну матрицу множеству отдельных маршрутов.

Частые ошибки: 401 означает, что ключ не дошёл: проверьте OPENROUTESERVICE_API_KEY. 403 означает, что ключ отклонён или его дневная квота исчерпана; проверьте и то и другое на account.heigit.org. 429 означает, что достигнут поминутный лимит: подождите минуту. Ошибка 2004 означает, что запрос превышает лимит (слишком много точек или слишком длинный маршрут); ошибка 2010 означает, что точка не находится рядом с дорогой, часто потому, что перепутаны долгота и широта.

Коннектор только считает на данных OpenStreetMap: он не рисует изображения карт, не строит маршруты на общественном транспорте и ничего не меняет в вашем аккаунте HeiGIT.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты openrouteservice.

Доступные инструменты

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

• «Сколько ехать на машине от Курского вокзала до аэропорта Домодедово, и какой будет пошаговый маршрут?»
• «Кто из наших мастеров в Химках, Мытищах и Подольске быстрее всех доедет на машине до каждого из этих 12 адресов клиентов?»
• «Покажите зону, куда можно доехать на машине за 15 минут от нашего магазина на Невском проспекте, 28, в Санкт-Петербурге.»
• «Спланируйте завтрашнюю развозку: 25 точек, 2 фургона с 8:00 до 17:00 и окно доставки каждого клиента. Какой фургон объезжает какие точки и в каком порядке?»
• «Найдите аптеки и зарядные станции для электромобилей в радиусе 500 метров от Красной площади.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT