appontes.ai AI Connector 14 Tage testen

Hilfe

Einrichtung und Hilfe

So richten Sie den Appontes AI Connector ein, verbinden Ihre KI-Assistenten und helfen sich bei Störungen.

Einrichtung

  1. Registrieren: Legen Sie unter Kostenlos testen ein Konto für Ihr Unternehmen an und bestätigen Sie Ihre E-Mail-Adresse. In der Verwaltung finden Sie danach Ihre Seriennummer und den Download-Link für den Installer; beides kommt auch per E-Mail.
  2. Installieren: Führen Sie den Installer auf einem Windows-Server aus, der die Datenbank der Sage 100 und den Sage-Applikationsserver erreicht, in der Regel auf dem Applikationsserver selbst. Geben Sie die Seriennummer ein, wenn der Installer danach fragt. Danach finden Sie die Verwaltung des Connectors im Startmenü unter „Appontes AI Connector“.
  3. Kennung vergeben: Der Connector erscheint in der Verwaltung unter „Connectoren“. Die Kennung Ihres Unternehmens, z. B. mustermann, steht in der Adresse für die Assistenten und bei deren Anmeldung.
  4. Freischalten: Schalten Sie in der Verwaltung des Connectors die Mandanten frei, auf die Assistenten zugreifen dürfen, und legen Sie fest, ob sie nur lesen oder auch schreiben dürfen.
  5. Benutzer freigeben: Geben Sie auf der Seite „Benutzer“ der Verwaltung die Sage-Benutzer frei, die mit Assistenten arbeiten sollen. Jeder belegt einen Platz Ihres Pakets. Dort legen Sie auch die Rechte je Benutzer fest und können Anweisungen für den Assistenten hinterlegen, etwa Rolle oder Einschränkungen. Damit sich ein Benutzer mit seiner E-Mail-Adresse anmelden kann, muss sie an seinem Sage-Benutzer hinterlegt sein.
  6. Abo abschließen: Der Test läuft 14 Tage mit bis zu 5 Benutzern. Wollen Sie weitermachen, schließen Sie in der Verwaltung Insights oder Business ab (jährlich, auf Wunsch mit weiteren Mandanten) oder bestellen direkt bei uns.

Netzwerk

  • Der Connector braucht nur eine ausgehende Verbindung über Port 443 (HTTPS) zu appontes.ai. Eingehende Ports und ein eigenes Zertifikat sind nicht nötig.
  • Läuft der Weg ins Internet über einen Proxy, tragen Sie ihn in der appsettings.json unter Relay:Proxy ein, z. B. http://proxy:3128.
  • Prüft eine Firewall den TLS-Verkehr (TLS-Inspection), muss ihr Stammzertifikat im Windows-Zertifikatspeicher des Servers liegen. Alternativ nehmen Sie appontes.ai von der Prüfung aus.

Assistenten verbinden

Für alle Assistenten gilt dieselbe Adresse:

https://appontes.ai/mcp

Claude

Einstellungen → Connectors → „Benutzerdefinierten Connector hinzufügen“, als Adresse https://appontes.ai/mcp eintragen. Danach mit „Verbinden“ die Anmeldung starten.

ChatGPT

Fügen Sie in den Einstellungen einen Connector bzw. eine App mit MCP-Server hinzu und tragen Sie https://appontes.ai/mcp ein. Die Bezeichnungen der Menüs ändert der Anbieter gelegentlich. Je nach Tarif muss die Funktion erst freigeschaltet werden, z. B. durch den Administrator Ihres Arbeitsbereichs.

Microsoft Copilot Studio

Fügen Sie Ihrem Agenten unter den Werkzeugen einen MCP-Server hinzu, mit der Adresse https://appontes.ai/mcp und der Authentifizierung OAuth 2.0.

Andere Assistenten

Jeder Client, der MCP über Streamable HTTP mit OAuth 2.1 spricht, kann sich verbinden.

Anmeldung

  1. Der Assistent öffnet die Anmeldeseite von appontes.ai. Geben Sie die E-Mail-Adresse aus Ihrem Sage-Benutzer oder die Kennung Ihres Unternehmens ein.
  2. Melden Sie sich mit Ihrem Sage-Benutzer und Kennwort an. Melden Sie sich in Sage mit Windows an, nehmen Sie Ihren Windows-Benutzer (mit oder ohne Domäne) und Ihr Windows-Kennwort.
  3. Wählen Sie den Mandanten. Für einen zweiten Mandanten verbinden Sie den Connector ein weiteres Mal.
  4. Bestätigen Sie mit dem zweiten Faktor (Authenticator-App). Beim ersten Mal richten Sie ihn ein.
  5. Geben Sie den Zugriff frei. Dabei legen Sie fest, ob der Assistent nur lesen oder auch schreiben darf.

Der Assistent arbeitet danach mit Ihren Rechten in Sage: Der Connector führt alle Anfragen unter Ihrem eigenen Sage-Benutzer aus. Dafür speichert er Ihr Kennwort verschlüsselt auf dem Server Ihres Unternehmens, nicht bei appontes.ai. Ändern Sie Ihr Kennwort, fordert der Assistent Sie zur erneuten Anmeldung auf.

Freigaben sehen und widerrufen Sie jederzeit auf der Kontoseite Ihres Unternehmens unter https://<kennung>.appontes.ai/konto.

Demo ausprobieren

Ohne eigene Installation probieren Sie den Appontes AI Connector für Sage 100 mit dem Demo-Connector aus: Verbinden Sie Ihren Assistenten wie oben mit https://appontes.ai/mcp und geben Sie auf der Anmeldeseite demo ein. Am Demo-Connector melden Sie sich mit dem Benutzer demo an; das Kennwort erhalten Sie auf Anfrage unter info@appontes.de.

Die Demo enthält erfundene Daten eines Großhändlers für Sanitär und Heizung (acht Kunden, zwölf Artikel, Angebote, Aufträge, Rechnungen und offene Posten) und 14 Werkzeuge: Kunden und Artikel suchen und lesen, Bestand und Preise, Belege suchen, lesen, berechnen, anlegen und verwerfen sowie offene Posten. Angelegte Belege verwirft die Demo nach 24 Stunden. Probieren Sie z. B.:

  • „Welche Kunden haben überfällige Rechnungen, und wie hoch sind die Beträge?“
  • „Erstelle für Brunnmeier Haustechnik ein Angebot über 20 Thermostatköpfe und 2 Wärmepumpen – prüfe vorher Preise und Bestand.“
  • „Gib mir einen Überblick über die Kessler Bad & Wärme: Umsatz, offene Belege und offene Posten.“

Bereiche begrenzen

Sollen dem Assistenten nur einige Bereiche zur Verfügung stehen, ergänzen Sie die Adresse, z. B.:

https://appontes.ai/mcp?bereiche=xrm,belege

Weniger Werkzeuge machen den Assistenten schneller und treffsicherer. Welche es gibt, zeigt die Liste aller Werkzeuge; Anregungen finden Sie unter Beispiel-Prompts.

Fehlerbehebung

„Der Connector ist nicht verbunden“

Prüfen Sie auf dem Server, ob der Windows-Dienst des Connectors läuft und ins Internet darf (Port 443 zu appontes.ai). Der Selbsttest im Installationsordner (appontesai selbsttest) zeigt den Stand der Verbindung. Das Protokoll liegt im Ordner logs neben der Installation.

Die Seriennummer wird nicht angenommen

Kopieren Sie die Seriennummer aus der Verwaltung, Bindestriche und Großschreibung spielen keine Rolle. Ist die Testphase abgelaufen und noch kein Abo abgeschlossen, schließen Sie es in der Verwaltung ab. Hilft das nicht, schreiben Sie uns an info@appontes.de.

„Lizenzplätze erschöpft“

Alle Benutzer Ihres Pakets sind belegt (Insights 5, Business 25). Nehmen Sie in der Verwaltung des Connectors (Seite „Benutzer“) die Freigabe eines Benutzers zurück, der den Connector nicht mehr nutzt, oder wechseln Sie auf ein größeres Paket.

„Ihr Sage-Benutzer ist nicht freigegeben“

Ihr Administrator muss Ihren Sage-Benutzer in der Verwaltung des Connectors (Seite „Benutzer“) für KI-Assistenten freigeben. Melden Sie sich mit der E-Mail-Adresse an, muss sie an Ihrem Sage-Benutzer hinterlegt sein. Sonst nehmen Sie die Kennung Ihres Unternehmens.

„Bitte melden Sie sich erneut an“

Der Connector hat keine gültige Anmeldung für Sie gespeichert, meist weil sich Ihr Sage- oder Windows-Kennwort geändert hat oder der Connector aktualisiert wurde. Trennen Sie die Verbindung im Assistenten und verbinden Sie sie neu.

Proxy oder TLS-Inspection

Meldet das Protokoll Zertifikatsfehler beim Aufbau, prüft vermutlich eine Firewall den TLS-Verkehr. Tragen Sie den Proxy unter Relay:Proxy ein und legen Sie das Stammzertifikat der Firewall im Windows-Speicher „Vertrauenswürdige Stammzertifizierungsstellen“ des Computers ab.

Der Assistent fordert erneut zur Anmeldung auf

Die Freigabe wurde widerrufen, ist abgelaufen oder der Benutzer wurde gesperrt. Verbinden Sie den Connector im Assistenten neu.

Persönliche Hilfe

Auf Wunsch richten wir den Connector per Fernwartung für Sie ein. Schreiben Sie uns an info@appontes.de oder rufen Sie an: 0741 20679690.