openrouteservice über MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → openrouteservice klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

openrouteservice + Microsoft Copilot

openrouteservice (HeiGIT) Routing auf OpenStreetMap: Geocoding und Reverse Geocoding, Routen mit Abbiegehinweisen für Auto, Lkw, Fahrrad, zu Fuß und Rollstuhl, Fahrzeitmatrizen, Isochronen (erreichbare Gebiete), Tourenoptimierung für mehrere Fahrzeuge und Points of Interest. Kostenloser API-Key.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

OPENROUTESERVICE_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein kostenloses HeiGIT-Konto und einen API-Key. Der kostenlose Tarif reicht für Tests und kleinen Produktivbetrieb.

1. Registriere dich kostenlos auf account.heigit.org und erstelle im Dashboard unter tokens einen API-Key.
2. Füge nur den Key in OPENROUTESERVICE_API_KEY ein, ohne das Wort Bearer, ohne Leerzeichen und Anführungszeichen. Der Connector schickt ihn im Header Authorization.
3. Installiere den Connector und führe openrouteservice_geocode mit einem Ortsnamen wie Berlin aus: Er liefert den Ort mit seinen Koordinaten, damit siehst du, dass der Key funktioniert.

Aktuelle Adresse: Der Connector spricht mit https://api.heigit.org, der aktuellen Adresse von openrouteservice. HeiGIT schaltet das alte api.openrouteservice.org im November 2026 ab; dort erstellte Keys funktionieren auch hier, du kannst einen vorhandenen Key also weiter nutzen.

Was er kann: Alles läuft auf OpenStreetMap-Daten. Er wandelt Adressen in Koordinaten um und zurück (Geocoding, Autovervollständigung beim Tippen, Reverse Geocoding); plant Routen mit Strecke, Dauer und Abbiegehinweisen für Auto, Lkw (driving-hgv), Fahrrad, zu Fuß und Rollstuhl, auf Wunsch ohne Autobahnen, Maut oder Fähren; berechnet Fahrzeitmatrizen zwischen vielen Punkten; zeichnet Isochronen, also das Gebiet, das du in einer bestimmten Zeit oder Strecke erreichst; löst Touren für mehrere Fahrzeuge (VROOM) mit Zeitfenstern, Kapazitäten und Fähigkeiten; und findet Points of Interest wie Geschäfte, Tankstellen, Apotheken oder Ladestationen rund um einen Punkt.

Längengrad zuerst: Jedes Routing-Tool erwartet Koordinaten als [Längengrad, Breitengrad], zum Beispiel [7.8421, 47.9990] für Freiburg. Vertauschte Werte sind die häufigste Ursache für einen nicht gefundenen Punkt oder eine Route, die im Meer endet. Deshalb geocodiert die KI Adressen zuerst und reicht die Koordinaten unverändert weiter.

Einheiten: Zeiten kommen in Sekunden, die KI rechnet sie für dich in Stunden und Minuten um. Strecken sind standardmäßig in Kilometern. Isochronen bekommen ihren Bereich in Sekunden, bei einem Streckenbereich in Metern.

Nur lesend: Der Connector rechnet nur. Einige Tools schicken ihre Anfrage als POST, aber keines ändert etwas in deinem HeiGIT-Konto. Es gibt also nichts zu bestätigen, und kein Tool ist bei der Installation ausgeschaltet.

Limits: Der kostenlose Tarif erlaubt etwa 2.000 Routenanfragen am Tag und 40 pro Minute, mit kleineren Tageskontingenten für Matrizen, Isochronen, Optimierung und Points of Interest. Jede Antwort enthält x-ratelimit-remaining, und die KI nimmt lieber eine Matrix als viele einzelne Routen.

Häufige Fehler: 401 heißt, es kam kein Key an: Prüfe OPENROUTESERVICE_API_KEY. 403 heißt, der Key wurde abgelehnt oder sein Tageskontingent ist aufgebraucht; prüfe beides auf account.heigit.org. 429 heißt, das Minutenlimit ist erreicht: Warte eine Minute. Fehler 2004 heißt, die Anfrage überschreitet ein Limit (zu viele Punkte oder eine zu lange Route); Fehler 2010 heißt, ein Punkt liegt nicht in der Nähe einer Straße, oft weil Längen- und Breitengrad vertauscht sind.

Der Connector rechnet nur auf OpenStreetMap-Daten: Er zeichnet keine Kartenbilder, bietet keine Routen mit öffentlichen Verkehrsmitteln und ändert nichts in deinem HeiGIT-Konto.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die openrouteservice-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Wie lange fahre ich mit dem Auto vom Freiburger Hauptbahnhof zum Europa-Park in Rust, und wie lautet die Wegbeschreibung?“
• „Welcher unserer Techniker in Stuttgart, Karlsruhe und Ulm ist mit dem Auto am schnellsten bei jeder dieser 12 Kundenadressen?“
• „Zeig mir das Gebiet, das man von unserem Laden in der Kaiser-Joseph-Straße 200 in Freiburg in 15 Minuten mit dem Auto erreicht.“
• „Plane die Lieferungen für morgen: 25 Stopps, 2 Transporter von 8 bis 17 Uhr und das Lieferfenster jedes Kunden. Welcher Wagen fährt welche Stopps in welcher Reihenfolge?“
• „Plane eine Lkw-Route vom Hamburger Hafen nach Mailand ohne Fähren und Mautstraßen, mit Strecke und Fahrzeit.“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden