1C:Enterprise über MCP mit Microsoft Copilot verbinden

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

1C:Enterprise + Microsoft Copilot

Lies deine 1C:Enterprise-8.3-Infobase (1С:Бухгалтерия, Управление торговлей, 1С:ERP, УНФ und andere Konfigurationen) über ihre Standard-OData-Schnittstelle: Kataloge, Belege mit ihren Tabellenteilen, Registerstände, Umsätze und Stichtagswerte, mit den Namen aus den Metadaten deiner Konfiguration. Nur lesend, Basic Auth, dein eigener Server.

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:

ONEC_BASE_URL, ONEC_USER, ONEC_PASSWORD

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 30 Minuten und braucht deinen 1C-Administrator. Du brauchst eine 1C:Enterprise-8.3-Infobase (Plattform 8.3.5 oder neuer), die mit eingeschalteter Standard-OData-Schnittstelle auf einem Webserver veröffentlicht ist, und einen eigenen 1C-Benutzer für den Connector.

1. Veröffentliche die Infobase auf einem Webserver (Apache oder IIS mit den Webserver-Erweiterungsmodulen der Plattform). Öffne im Designer Администрирование → Публикация на веб-сервере (Administration → Publish to web server), gib der Veröffentlichung einen Namen in lateinischen Buchstaben, setze den Haken bei Публиковать стандартный интерфейс OData (Publish standard OData interface) und veröffentliche. Läuft deine Infobase bei einem 1C-Hoster (1cFresh, Cloud-Miete), bitte den Anbieter, OData dafür einzuschalten.
2. Leg fest, was OData zeigen darf. Ab Werk gibt die Schnittstelle keine Objekte frei. In typischen Konfigurationen öffnest du Администрирование → Синхронизация данных → Настройки стандартного интерфейса OData (oder Все функции → Обработки → Настройка стандартного интерфейса OData) und fügst die Kataloge, Belege und Register hinzu, die die KI lesen darf. In anderen Konfigurationen ruft ein Entwickler УстановитьСоставСтандартногоИнтерфейсаOData() auf.
3. Leg einen eigenen 1C-Benutzer an mit nur lesenden Rollen für diese Objekte und dem Recht, die Standard-OData-Schnittstelle zu nutzen. Das Einstellungsformular aus Schritt 2 kann diesen Benutzer für dich anlegen.
4. Prüf es im Browser: Öffne deine Veröffentlichungsadresse mit /odata/standard.odata/?$format=json dahinter und melde dich mit diesem Benutzer an. Eine JSON-Liste mit Objekten heißt, OData funktioniert; eine leere Liste heißt, Schritt 2 fehlt noch.
5. Trag die Veröffentlichungsadresse in ONEC_BASE_URL ein: die Adresse, mit der du den Web-Client öffnest, ohne /odata und ohne Schrägstrich am Ende, zum Beispiel https://1c.example.com/trade. In ONEC_USER kommt der Benutzername genau wie in der Benutzerliste der Infobase (kyrillische Namen funktionieren), in ONEC_PASSWORD sein Passwort.
6. Installiere den Connector und führe onec_enterprise_describe_service aus: Er listet jedes für OData veröffentlichte Objekt mit seinen Schlüsseln. Eine leere Liste heißt, dass der OData-Zusammensetzung noch nichts hinzugefügt wurde.

Dein Server muss erreichbar sein: AnythingMCP Cloud erreicht nur Adressen im öffentlichen Internet, veröffentliche also per HTTPS auf einem öffentlichen Host; das Passwort geht per HTTP Basic Authentication mit. Steht der 1C-Server in deinem internen Netz, betreibst du AnythingMCP selbst dort (oder verbindest es per VPN) und trägst den Host in SSRF_ALLOWED_HOSTS ein.

Was er liest: Kataloge, Belege mit ihren Tabellenteilen, Informations-, Akkumulations- und Buchhaltungsregister, Kontenpläne, Konstanten und Belegjournale, unter den Namen aus den Metadaten deiner Konfiguration, meist auf Russisch: Catalog_Номенклатура, Document_РеализацияТоваровУслуг mit seinen Positionen in Document_РеализацияТоваровУслуг_Товары, AccumulationRegister_ТоварыНаСкладах, AccountingRegister_Хозрасчетный. Das klappt mit jeder Konfiguration der Plattform: 1С:Бухгалтерия предприятия, Управление торговлей, 1С:ERP, Комплексная автоматизация, УНФ, Розница, ЗУП und eigene Entwicklungen.

Bestände, Umsätze und Stichtagswerte: Bei Registern liest die KI die virtuellen Tabellen Balance, Turnovers, BalanceAndTurnovers, SliceLast und SliceFirst mit onec_enterprise_get. So filtert und verdichtet 1C auf dem Server, statt dass die KI tausende Belegzeilen addiert. Auf diese Weise beantwortet sie Fragen nach dem Lagerbestand zu einem Datum, den Verkäufen eines Zeitraums, dem letzten Wechselkurs oder dem Saldo des Kontos 62.01.

So arbeitet die KI: onec_enterprise_guide erklärt Namen, Filter und Register, ohne etwas zu kosten. onec_enterprise_describe_entity zeigt die Felder eines Objekts und ihre Typen, onec_enterprise_query liest Listen mit Filter, Sortierung, Feldauswahl und Seiten, und onec_enterprise_get_entity liest ein Objekt per Ref_Key samt seinen Tabellenteilen. Referenzfelder wie Контрагент_Key enthalten eine GUID; die KI holt den Namen dazu, statt dir GUIDs zu zeigen.

Saubere Summen: Die KI zählt nur gebuchte Belege (Posted eq true) und lässt zum Löschen markierte Objekte weg, außer du fragst ausdrücklich danach. Datumswerte haben keine Zeitzone: Sie sind die lokale Zeit der Infobase. Beträge sind in der Belegwährung, sofern das Feld nichts anderes sagt.

Nur lesend: Kein Tool schreibt. Der Connector legt nie etwas an, ändert, bucht oder löscht nichts, deshalb gibt es nichts zu bestätigen, und kein Tool ist bei der Installation ausgeschaltet. Die echte Grenze sind die Rechte des 1C-Benutzers: 1C prüft sie bei jedem Aufruf, und was der Benutzer nicht sehen darf, fehlt in der Antwort, was wie fehlende Daten aussehen kann.

Limits: Es gibt kein festes Aufruflimit, aber jede Abfrage läuft auf deinem 1C-Server. Die KI setzt bei großen Katalogen und Registern immer $top und $select und blättert lange Listen seitenweise durch.

Häufige Fehler: 401 heißt, 1C hat die Anmeldung abgelehnt: Prüf Benutzername, Passwort und das Recht auf die Standard-OData-Schnittstelle. 403 heißt, der Benutzer ist angemeldet, darf dieses Objekt aber nicht lesen: Gib seiner Rolle Leserechte. 404 heißt, das Objekt ist nicht in der OData-Zusammensetzung, sein Name ist falsch geschrieben, oder ONEC_BASE_URL stimmt nicht (es darf kein /odata enthalten). 400 mit "Ошибка при разборе опции запроса" weist auf einen falschen Filter oder Feldnamen hin. 500 bei einer Datei-Infobase bedeutet meist, dass das Konto des Webservers keine Schreibrechte auf den Ordner der Infobase hat.

Der Connector legt keine Belege an, bucht und löscht keine, und er sieht nur die Objekte, die dein Administrator der OData-Zusammensetzung hinzugefügt hat.

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 1C:Enterprise-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 hoch ist heute der Bestand jedes Artikels im Hauptlager, und welche Artikel liegen unter 10 Stück?“
• „Wie viel haben wir im September an Romashka LLC ausgeliefert, aufgeteilt nach gebuchten Verkaufsbelegen?“
• „Such den Geschäftspartner mit der INN 7707083893 und liste die Rechnungen auf, die wir ihm letzten Monat gestellt haben.“
• „Welcher US-Dollar-Kurs ist in 1C für heute hinterlegt?“
• „Wie hoch ist der Saldo des Kontos 62.01 zum Ende September, und welche Kunden stecken dahinter?“

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