ARES MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → ARES Czech Company Register, installiere es ohne Schlüssel, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

ARES Czech Company Register + Microsoft Copilot

Tschechische Unternehmensdaten aus ARES, dem Register der wirtschaftlichen Subjekte des Finanzministeriums, kein API-Schlüssel: suche Unternehmen nach Name oder IČO, lese den Basisdatensatz, den Auszug aus dem Handelsregister mit Eigentümern und gesetzlichen Vertretern, das statistische Register, Gewerbelizenzen, Insolvenzunterlagen und Kodexlisten.

Voraussetzungen

Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

(keine: öffentliche Daten, kein API-Schlüssel)

Schritt 1 — Connector einrichten

Öffentliche Daten, kein Schlüssel: die Einrichtung dauert weniger als eine Minute. Der Connector liest ARES (Administrativní registr ekonomických subjektů), das öffentliche Informationssystem des tschechischen Finanzministeriums, das die Daten der tschechischen Quellregister vereint: das öffentliche (Handels-)Register, das Register des Statistischen Amtes, das Handelslizenzregister, das Grundregister der Personen, das Mehrwertsteuerregister, das zentrale Insolvenzregister und andere. Es ist kein Konto, API-Schlüssel oder Anmeldung erforderlich.

1. Wähle im Connector-Store ARES Czech Company Register aus und installiere es. Es gibt nichts einzufügen und keinen Schritt Mit Anbieter autorisieren.
2. Überprüfe es mit ares_get_subject und der IČO 27074358: es gibt den Namen des Unternehmens, den Sitz, die Rechtsform und die Register zurück, in denen es erscheint.

Cloud und self-hosted funktionieren gleich: es gibt nichts zu konfigurieren.

Identifikatoren: die IČO (Unternehmens-ID) hat 8 Ziffern; führe führende Nullen beizubehalten (00006947). Die tschechische Mehrwertsteuernummer (DIČ) ist normalerweise CZ plus die IČO, zum Beispiel CZ27074358. Die Aktenzeichen des Registergerichts (spisová značka) sind Gericht, Abteilung und Einlage, zum Beispiel C 209831 beim Stadtgericht Prag.

Wo anfangen: ares_search_subjects findet ein Unternehmen nach dem Firmennamen (eingeschränkt nach Gemeinde oder Rechtsform) oder nach einer Liste von IČO-Nummern. ares_get_subject gibt die Zusammenfassung und seznamRegistraci zurück, die angibt, in welchen Registern das Subjekt aktiv (AKTIVNI), historisch (HISTORICKY) oder nicht vorhanden (NEEXISTUJICI) ist. Gehe dann tiefer, wo es vorhanden ist: ares_get_commercial_register für Eigentümer, gesetzlichen Vertreter, Kapital und Geschichte (mehrere Unternehmen gleichzeitig mit ares_search_commercial_register), ares_get_statistical_register für Größe und Sektor, ares_get_trade_licences für Gewerbe, ares_get_basic_register für den Datenkasten und den rechtlichen Status, ares_get_bankruptcy_records und ares_get_other_register_record. ares_search_codelists decodiert Rechtsformen, Finanzämter und NACE-Codes.

Daten lesen: die Feldnamen sind tschechisch, und die KI übersetzt sie: obchodniJmeno Firmenname, sidlo Sitz, pravniForma Rechtsform (112 s.r.o., 121 a.s., 101 Einzelunternehmer), datumVzniku Gründungsdatum, datumZaniku Auflösungsdatum. Im Handelsregister listet statutarniOrgany die gesetzlichen Vertreter und deren Mitglieder (zum Beispiel jednatel, Geschäftsführer), spolecnici die Partner mit ihren Anteilen und zakladniKapital das eingetragene Kapital. Ein Eintrag mit einem Löschdatum (datumVymazu) ist Geschichte, nicht aktuell. Beträge wie "10;00" verwenden ein Semikolon als Dezimaltrennzeichen.

Personenbezogene Daten: Auszüge aus dem Handelsregister nennen natürliche Personen mit ihren Geburtsdaten. Verwende sie nur für legitime Geschäftszwecke.

Nur lesen: jedes Tool liest nur, daher gibt es nichts zu bestätigen und kein Tool wird bei der Installation deaktiviert.

Limits: ARES ist für jede Nutzung kostenlos, bittet jedoch um angemessene Volumina und kann eine Adresse blockieren, die es überflutet. Die Suchergebnisse sind begrenzt: die KI seiten mit start und count und schränkt die Filter ein. Für die Massenverarbeitung verwende die offenen ARES-Daten-Dumps anstelle der API. ARES bezieht seine Daten aus den Quellregistern; der rechtlich bindende Auszug ist der aus dem Register selbst, zum Beispiel das öffentliche Register auf or.justice.cz.

Häufige Fehler: NENALEZENO (HTTP 404) bedeutet, dass die IČO in diesem Register nicht gefunden wurde. CHYBA_VSTUPU (400) bedeutet ungültige oder leere Eingabe: eine Suche benötigt mindestens einen Filter. OBECNA_CHYBA ist ein allgemeiner Fehler auf der ARES-Seite.

Der Connector ändert nichts in den tschechischen Registern und gibt keine offiziellen Auszüge aus.

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 ARES Czech Company Register-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

Beispielaufforderungen

• "Suche nach IČO 27074358 und sag mir den Firmennamen, Sitz, Rechtsform und in welchen Registern es aktiv ist."
• "Wer sind die Geschäftsführer und Partner von 27074358 laut Handelsregister, und wie hoch ist das eingetragene Kapital?"
• "Hat dieser Anbieter Einträge im zentralen Insolvenzregister?"
• "Welche Gewerbelizenzen hält IČO 27074358, und welche sind noch gültig?"
• "Finde s.r.o.-Unternehmen namens Stavby in Brünn und gib mir ihre IČO-Nummern."

FAQ

Ist ein ARES-Datensatz ein rechtlich bindender Auszug? Nein. ARES vereint die Daten der Quellregister für Informationen. Der rechtlich bindende Auszug ist der aus dem Register selbst, zum Beispiel das öffentliche Register auf or.justice.cz.

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
• Verbinde mit Claude