XOVI über MCP mit Microsoft Copilot verbinden

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

XOVI + Microsoft Copilot

SEO-Daten der XOVI Suite, nur lesend: API-Guthaben, Verlauf des Sichtbarkeitsindex (OVI), Ranking-Keywords, Ranking-Wert und Keyword-Verlauf jeder Domain sowie das tägliche Keyword-Monitoring deiner Projekte.

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:

XOVI_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Die XOVI API setzt ein XOVI-Konto im Tarif Pro, Business oder Enterprise voraus.

1. Öffne in der XOVI Suite Account > API Dashboard und erstelle deinen persönlichen API-Schlüssel.
2. Füge ihn in XOVI_API_KEY ein. Der Connector schickt ihn bei jedem Aufruf von https://suite.xovi.net/api als Parameter key.
3. Installiere den Connector und rufe xovi_get_credit_state auf, das keine Credits kostet, um den Schlüssel zu prüfen.

Was er liest: das API-Guthaben und die Nutzungslimits deines Kontos; die wöchentliche Domainanalyse beliebiger Domains: den Sichtbarkeitsindex (OVI) im Zeitverlauf, die Keywords, für die eine Domain oder URL rankt, mit Position, Suchvolumen, CPC und Wettbewerb, ihren Ranking-Wert, den Verlauf ihrer Rankings, den Ranking-Verlauf eines einzelnen Keywords und die Suchergebnisseite eines Keywords; und das tägliche Keyword-Monitoring deiner Projekte: Projekte mit ihren Wettbewerbern, Labels, überwachte Domains, überwachte Keywords mit ihrer aktuellen Position, den täglichen Verlauf eines Keywords, die Top 100 eines überwachten Keywords an einem Tag und den Monitoring-OVI einer Projektdomain.

Credits: Die meisten Aufrufe werden aus dem API-Credit-Budget deines Kontos bezahlt, pro Aufruf oder pro Block von Zeilen (siehe die jeweilige Funktion in der XOVI-Referenz); Aufrufe, die nur deine eigenen Kontodaten lesen, sind kostenlos. Vor großen Exporten prüft die KI das Guthaben mit xovi_get_credit_state und xovi_get_limits, hält limit klein und geht nicht ohne dein Okay viele Domains in einer Schleife durch. Keyword-Plätze im Monitoring werden getrennt gezählt: xovi_get_monitoring_keyword_limits.

Wöchentliche Domainanalyse: Die KI wählt mit xovi_list_search_engines den Suchmaschinen-Host (wöchentlich, z. B. google.de) und nutzt dann xovi_get_ovi_trend für die Sichtbarkeit im Zeitverlauf, xovi_list_ranking_keywords für das, wofür eine Domain rankt, xovi_get_ranking_value, xovi_get_ranking_trend, xovi_get_keyword_trend für ein Keyword und xovi_get_keyword_serp für die Ergebnisseite eines Keywords. urlpattern nimmt einen Host (www.example.com), alle Subdomains (example.com/*) oder ein Verzeichnis (www.example.com/blog/*). Die Daten einer Woche erscheinen am Sonntag, und date ist dieser Sonntag.

Tägliches Monitoring: xovi_list_projects liefert den Projekt-Hash, xovi_list_labels die Labels und xovi_list_search_engines mit Intervall daily die numerische sengineid; danach nutzt die KI xovi_list_monitoring_domains, xovi_list_monitoring_keywords, xovi_get_monitoring_keyword_trend, xovi_get_monitoring_serp und xovi_get_monitoring_ovi_trend.

Nur lesend: Alle 17 Tools lesen nur. In deinen XOVI-Projekten ändert sich nichts, deshalb gibt es nichts zu bestätigen, und kein Tool ist bei der Installation ausgeschaltet.

Seitenweise: limit ist höchstens 1000 Zeilen; skip zählt Seiten von limit Zeilen, skip 1 mit limit 100 liefert also die Zeilen 101 bis 200. Ergebnisse enthalten resultCount mit der ungefilterten Gesamtzahl.

Häufige Fehler: XOVI antwortet mit HTTP 200 und apiErrorCode und apiErrorMessage, und der Connector macht daraus Fehler. param invalid bei key heißt, dass der API-Schlüssel falsch ist oder gelöscht wurde; no permission heißt, dass Schlüssel oder Tarif diese Funktion nicht nutzen dürfen; cost error heißt, dass das Credit-Budget bis zur nächsten Aufladung verbraucht ist; param missing oder param invalid bei einem anderen Feld nennt das Feld, das du korrigieren musst. result empty ist ein erfolgreicher Aufruf ohne Daten, etwa bei einer Domain ohne Rankings.

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 XOVI-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 hat sich der Sichtbarkeitsindex von example.de auf google.de in den letzten 12 Monaten entwickelt?“
• „Für welche Keywords rankt www.example.de/blog/ auf Seite eins, mit Suchvolumen und CPC?“*
• „Vergleich den Ranking-Wert von example.de und wettbewerber.de für die letzte Woche.“
• „Welche überwachten Keywords unseres Projekts haben seit gestern mehr als 3 Positionen verloren?“
• „Wie viele API-Credits haben wir noch, und wann war die letzte Aufladung?“

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