Dokumentation › Administration › microtech Komponente im Portal konfigurieren
Zuletzt geändert am 18.11.2026
Auf dieser Seite
title: microtech Komponente im Portal konfigurieren description: Die microtech-Verbindung eines Mandanten im ConnectCLOUD Portal einrichten: Basis-URL, Mandant, Zugangsdaten, Verbindungstest und NetBird. keywords: [microtech, Mandantenkonfiguration, Portal, GraphQL, OAuth2, NetBird, Mandant, BpConfig, Integrationen]
Zielgruppe & Rolle
Rolle: Mandanten-Administrator / IT-Admin | Voraussetzung: microtech ERP Basis-Anbindung vorhanden (immer 1. Schritt der Mandantenkonfiguration)
Unterstützung durch MBCOM
Auf Wunsch kann die vollständige Einrichtung der microtech-Konfiguration im Portal durch MBCOM übernommen werden.
Die microtech-Verbindung verbindet Ihren Mandanten mit Ihrer microtech-Instanz über die GraphQL-API. Sie ist die Grundlage für alle weiteren Module.
Jeder Mandant richtet seine eigene Verbindung ein, und zwar unter Einstellungen › Integrationen › microtech. Es gibt keine zentral verwalteten Server und keine Zuordnung in der Kunden-Administration mehr. Zum Ansehen genügt die Berechtigung tenant:settings:read, zum Ändern wird tenant:settings:write benötigt (Mandanten-Administratoren haben beides).
Verbindung
Im Bereich Verbindung hinterlegen Sie die Daten Ihres microtech-Servers:
| Feld | Beschreibung |
|---|---|
| Verbindung aktiv | Nur eine aktive Verbindung wird von ConnectCloud genutzt. |
| Basis-URL | Adresse des microtech-Servers, z. B. https://erp.ihrefirma.de/microtech/erp oder die NetBird-Adresse aus der Einrichtung. Bei einer NetBird-Einrichtung wird sie automatisch gesetzt, sobald das Zertifikat aktiviert ist. |
| Mandant | Die microtech-Mandantennummer. Mit „Mandanten ermitteln“ liest ConnectCLOUD die Mandanten vom Server aus; ein Klick auf einen Eintrag übernimmt ihn. Nicht aktive microtech-Mandanten sind gekennzeichnet. |
| Client-ID | Client-ID der microtech-Anwendung (siehe Basis-Konfiguration). |
| Client-Secret | Zugehöriges Secret. Es wird verschlüsselt gespeichert und nie wieder angezeigt; bleibt das Feld unverändert, wird das gespeicherte Secret behalten. Ändert sich die Adresse des Servers, muss das Secret erneut eingegeben werden. |
| TLS-Zertifikat (PEM) | Zertifikat des microtech-Servers für die verschlüsselte Verbindung über NetBird. Es gilt nur für NetBird-Adressen (*.netbird.cloud) und wird bei der NetBird-Einrichtung automatisch verwaltet (Anzeige des Fingerabdrucks). |
| Erweitert › GraphQL-URL (abweichend) | Nur angeben, wenn die GraphQL-Schnittstelle nicht unter der Basis-URL und dem Mandanten erreichbar ist. Das Portal zeigt die tatsächlich verwendete GraphQL-URL an. |
Klicken Sie nach Änderungen auf Speichern.
NetBird-Einrichtung
Steht Ihr microtech-Server in einem internen Netz ohne Portfreigaben, richten Sie die Anbindung im Bereich NetBird-Einrichtung derselben Seite ein. Das Portal erzeugt einen einmaligen PowerShell-Befehl, der auf dem Windows-Server NetBird installiert, das TLS-Zertifikat erzeugt und hochlädt. Läuft auf dem Server bereits ein anderes VPN, beantworten Sie die Frage „Läuft auf dem Server schon ein anderes VPN?“; ConnectCLOUD wird dann getrennt daneben eingerichtet. Nach der Ausführung bestätigen Sie mit „In microtech aktiviert“, dass das Zertifikat in microtech ausgewählt wurde.
Den vollständigen Ablauf beschreibt die Anleitung zur automatischen NetBird-Anbindung.
Verbindungstest
Bevor Sie die Verbindung aktivieren, sollten Sie den Verbindungstest durchführen. Der Test prüft:
- OAuth-Token: Es wird ein echtes OAuth-Token von Ihrer microtech-Instanz angefordert.
- GraphQL-API: Anschließend wird eine Testabfrage gegen die GraphQL-API ausgeführt.
Fehlerbehebung
Falls der Test fehlschlägt, prüfen Sie:
- Ist die microtech-Instanz von außen bzw. über das NetBird-Netzwerk erreichbar? Stimmt die Basis-URL?
- Stimmen
Client-IDundClient-Secretmit den Werten aus der microtech-Anwendungsverwaltung überein?- Bei NetBird- oder selbstsignierten Zertifikaten: Ist das passende Zertifikat hinterlegt und in
BpConfig.exeaktiviert?- Ist GraphQL im Mandanten aktiviert?
- Hat der zugeordnete Benutzer die Berechtigung
Zugriff über GraphQL erlaubt?Details zur Einrichtung finden Sie in der Basis-Konfiguration.
Nicht mehr vorhanden
Folgende frühere Bereiche gibt es nicht mehr; ihre Aufgaben übernimmt die Seite unter Einstellungen › Integrationen › microtech:
- der Reiter microtech in der Kunden-Administration (zentrale Server, Mandanten-Zuordnung, Hinweisbanner „Verbindung wird zentral verwaltet“),
- die microtech-Seite der Mandanten-Administration (
/admin) mit den Schaltern für Aktivierung und Indizierung, - die Seiten für ERP-Daten (Adressen, Artikel, Vorgänge, Projekte, Auswertungen) und die Release-Übersicht.
Bestehende zentrale Server-Einträge werden nicht übernommen; tragen Sie die Verbindung einmal je Mandant neu ein.
Abschluss der Basiskonfiguration & nächste Schritte
Die microtech-Mandantenkonfiguration schließt die Basiskonfiguration ab. Konfigurieren Sie nun die weiteren produktbezogenen Komponenten Ihres Mandanten (Reihenfolge beliebig):
- E-Rechnung im Portal konfigurieren
- Belegeingang per E-Mail im Portal einrichten
- Workflow-Komponente im Portal konfigurieren
Fahren Sie anschließend mit der produktbezogenen Systemkonfiguration fort oder kehren Sie zur Basiskonfiguration Übersicht zurück.
Hat das geholfen?
https://app.mbcom.cloud/knowledge/docs/base/microtech-portal-config