API und KI-Anbindung

Count-IT API und KI-Anbindung über MCP

Binden Sie Ihre eigene Software oder Website über die REST API an, oder geben Sie einem KI-Assistenten über den MCP-Server Zugriff auf Ihre Daten. Immer im Rahmen der Rechte, die Sie vergeben, und jederzeit widerrufbar.

Kurz gesagt

Count-IT bietet eine REST API mit OAuth2 für eigene Software und Websites sowie einen MCP-Server, über den ein KI-Assistent Ihre Daten lesen und, wenn Sie es erlauben, zum Beispiel Artikel und Webseiten bearbeiten kann. Eine API-App oder ein MCP-Token erhält nie mehr Rechte als der Benutzer, der sie freigibt oder erstellt.

  • REST API mit OAuth2: Zugriff je Unternehmen und Bereich, ansehen oder ändern
  • MCP-Token mit Zugriffsstufe: nur lesen (Standard), hinzufügen und bearbeiten oder auch löschen
  • Fehlen Ihnen Daten? Nach Ihrem Bedarf stellen wir (nahezu) alles über die API und MCP bereit

Was sind die Count-IT API und der MCP-Server?

Eine API (Application Programming Interface) ist ein fester Weg, auf dem Software mit anderer Software kommuniziert. Über die Count-IT API kann Ihre eigene Software, Ihre Website oder eine individuelle Anbindung Daten aus Count-IT abrufen und, soweit erlaubt, ändern. Es handelt sich um eine REST API mit OAuth2: Ihre Software bittet um Erlaubnis, Sie geben diese in Count-IT frei und legen fest, welche Daten die App verwenden darf. Fertige Anbindungen an Buchhaltung, Onlineshops und Versanddienstleister finden Sie unter Anbindungen; die API ist für alles gedacht, was Sie selbst entwickeln möchten.

MCP (Model Context Protocol) ist ein offener Standard, mit dem sich KI-Assistenten mit anderen Systemen verbinden. Über den MCP-Server von Count-IT kann ein KI-Assistent, der MCP unterstützt, zum Beispiel ChatGPT oder Claude, Ihre Daten abrufen. Sie aktivieren den KI-Datenzugriff je Mandant und erstellen ein persönliches MCP-Token. Damit arbeitet der Assistent im Rahmen der Rechte von Ihnen als Ersteller des Tokens.

So können Sie einem Assistenten in normaler Sprache Fragen zu Ihren Daten stellen oder ihn Artikel, Übersetzungen und Webseiten aktualisieren lassen, wenn Sie das erlauben. Sie bestimmen die Zugriffsstufe und prüfen, was der Assistent ändert. Benötigen Sie Daten oder Funktionen, die noch nicht enthalten sind? Nach Ihrem Bedarf stellen wir (nahezu) alles über die API und MCP bereit. Nehmen Sie Kontakt auf und sagen Sie uns, was Sie brauchen.

Möglichkeiten

Was Sie mit der API und MCP tun können

Beides funktioniert im Rahmen der Benutzerrechte, die Sie in Count-IT bereits eingerichtet haben.

Eigene Software anbinden

Erstellen Sie eine API-App für Ihre eigene Anbindung. Sie erhalten eine Client-Kennung und ein Geheimnis und tragen eine Redirect-URI ein: die Adresse, zu der Ihre Software nach der Freigabe zurückkehrt.

Zugriff je Unternehmen und Bereich

Bei der Freigabe wählen Sie die Unternehmen und je Bereich, etwa Artikel oder Kontakte, ob die App ansehen und ob sie ändern darf. Auf dem Reiter Verbundene Apps passen Sie das später an oder widerrufen den Zugriff.

Artikel, Kontakte, Bestand und mehr

Über die API arbeiten Sie derzeit unter anderem mit Artikeln, Preisen, Artikelgruppen, Scancodes, Bildern und Produktinfofeldern, Kunden, Lieferanten und Ansprechpartnern, Bestand und Lagern, Verkaufsaufträgen und Steuercodes. Mehr nötig? Das stellen wir nach Ihrem Bedarf bereit.

Ihre eigene Website auf Count-IT

Lesen Sie zum Beispiel Webseiten, Fotoalben und Bewertungen aus dem CMS, mit Bildern als öffentlichem Link. Für einen Onlineshop gibt es einen fertigen Katalog mit Kategorien, aktiven Artikeln, Preisen ohne MwSt., Bildern und Produktinfofeldern.

KI-Assistent über MCP

Mit einem persönlichen MCP-Token kann ein KI-Assistent Ihre Daten lesen, zum Beispiel um Fragen zu Verkauf oder Bestand zu beantworten. Nur lesen ist der Standard.

Texte schreiben und übersetzen lassen

Mit der Zugriffsstufe Lesen, Hinzufügen und Bearbeiten kann der Assistent unter anderem Artikel, Artikelgruppen, Onlineshop-Kategorien und Onlineshop-Artikel anlegen und ändern sowie deren Übersetzungen und die der Produktinfofelder aktualisieren.

Webseiten verwalten

Der Assistent kann auch Webseiten Ihrer Website und Onlineshops verwalten, etwa eine Datenschutzerklärung: Titel, Inhalt, Adresse, Meta-Beschreibung, Sichtbarkeit, Position im Menü und Übersetzungen. Dafür benötigt der Ersteller die Rechte für Webseiten.

Sicher und widerrufbar

Eine App oder ein Token kann nie mehr als die Rechte des Benutzers. Eine Änderung der Zugriffsstufe gilt sofort, und eine widerrufene App oder ein widerrufenes Token funktioniert nicht mehr.

So funktioniert es

Von der ersten Anbindung bis zur Verwaltung

  1. API-App erstellen

    Erstellen Sie eine API-App und tragen Sie die Redirect-URI ein. Sie muss exakt mit der Adresse übereinstimmen, die Ihre Software mitsendet.

  2. Freigeben

    Geben Sie die App frei und wählen Sie die Unternehmen und je Bereich ansehen oder ändern. Schalten Sie ab, was die App nicht benötigt.

  3. Mit der Dokumentation entwickeln

    Die technische Dokumentation beschreibt Authentifizierung, Endpunkte, Felder, Filtern, Sortieren und Paginierung. Importieren Sie die OpenAPI-Spezifikation zum Beispiel in Postman.

  4. Oder: KI über MCP anbinden

    Aktivieren Sie den KI-Datenzugriff und erstellen Sie unter App connector ein MCP-Token mit einem erkennbaren Namen, einem Enddatum und der passenden Zugriffsstufe.

  5. Verwalten und widerrufen

    Widerrufen Sie ein Token, wenn es nicht mehr benötigt wird oder möglicherweise bekannt geworden ist. Eine App, die 90 Tage nicht genutzt wurde, geben Sie erneut frei.

Ehrlich gesagt

Gut zu wissen

So wissen Sie vorab, was Sie erwarten können.

  • Die technische API-Dokumentation ist nur auf Englisch verfügbar.
  • Count-IT liefert die API und den MCP-Server, nicht den KI-Assistenten selbst. Diesen wählen und organisieren Sie separat.
Häufige Fragen

Fragen zur API und KI-Anbindung

Hat Count-IT eine API?

Ja. Count-IT hat eine REST API mit OAuth2. Sie erstellen eine API-App, geben sie frei und wählen je Unternehmen und Bereich, ob die App Daten ansehen und ändern darf. Die App kann nie mehr als Ihre eigenen Benutzerrechte.

Welche Daten sind über die API und MCP verfügbar?

Derzeit unter anderem Artikel, Preise, Artikelgruppen, Produktinfofelder, Kontakte, Bestand, Verkaufsaufträge, Steuercodes, Onlineshops sowie die Webseiten, Fotoalben und Bewertungen des CMS. Fehlt Ihnen etwas? Nach Ihrem Bedarf stellen wir (nahezu) alles über die API und MCP bereit. Nehmen Sie Kontakt auf und sagen Sie uns, was Sie brauchen.

Wo finde ich die API-Dokumentation?

Die technische Dokumentation (auf Englisch) finden Sie unter start.count-it.eu/api/docs; eine Anmeldung ist nicht nötig. Sie öffnen sie auch über die Schaltfläche API-Dokumentation bei Ihren API-Apps. Die Spezifikation lässt sich als OpenAPI-Datei herunterladen, zum Beispiel für Postman.

Wie binde ich einen KI-Assistenten an Count-IT an?

Aktivieren Sie den KI-Datenzugriff für Ihren Mandanten und erstellen Sie unter App connector ein persönliches MCP-Token mit erkennbarem Namen und Enddatum. Dieses Token verwenden Sie in einem KI-Assistenten, der MCP unterstützt. Unter Zugriffsstufe wählen Sie, ob der Assistent nur lesen oder auch ändern darf.

Kann ein KI-Assistent Daten in Count-IT ändern?

Nur wenn Sie es erlauben. Nur lesen ist der Standard. Mit Lesen, Hinzufügen und Bearbeiten kann der Assistent unter anderem Artikel, Artikelgruppen, Onlineshop-Kategorien und -Artikel, Übersetzungen, Produktinfofelder und Webseiten ändern; mit der höchsten Stufe auch löschen. Auch dann gelten die Rechte des Token-Erstellers.

Ist die KI-Anbindung sicher?

Das Token hat nie mehr Rechte als der Benutzer, der es erstellt. Verwenden Sie daher einen Benutzer mit möglichst wenigen Rechten, geben Sie dem Token ein Enddatum, teilen Sie es nie per E-Mail oder Chat und widerrufen Sie es bei Verlust. Vergeben Sie Schreibrechte nur, wenn es wirklich nötig ist, und prüfen Sie die Änderungen des Assistenten.

Kann ich meine eigene Website auf Count-IT aufbauen?

Ja. Über die API lesen Sie Webseiten, Fotoalben und Bewertungen aus dem CMS, und es gibt einen fertigen Katalog eines Onlineshops mit Kategorien, aktiven Artikeln, Preisen ohne MwSt., Bildern und Produktinfofeldern. Lieber nicht selbst entwickeln? Dann sehen Sie sich die Website und den Onlineshop von Count-IT an.

Was tue ich, wenn der MCP- oder API-Zugriff nicht funktioniert?

Prüfen Sie, ob die Funktion aktiviert ist, das Token oder Geheimnis noch gültig ist, das Enddatum nicht abgelaufen ist und der Ersteller ausreichende Rechte hat. Bei einer API-App muss die Redirect-URI exakt übereinstimmen, und nach 90 Tagen ohne Nutzung geben Sie die App erneut frei. Mehr in der Wissensdatenbank zu Anbindungen.

In welchem Paket sind die API und die KI-Anbindung enthalten?

Die API und die KI-Anbindung über MCP sind im Paket Full enthalten. Den KI-Assistenten selbst, zum Beispiel ChatGPT oder Claude, regeln Sie separat mit einem eigenen Abonnement.

Besprechen Sie Ihre Anbindung mit uns

In einer Demo zeigen wir Ihnen, wie die API und die KI-Anbindung funktionieren, und überlegen mit Ihnen, welche Daten Sie benötigen.