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

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

openrouteservice + Microsoft Copilot

Маршрутизация 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 — Добавьте коннектор в Microsoft Copilot

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

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты openrouteservice.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

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

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

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

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

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

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