# microtech Komponente im Portal konfigurieren

---
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**)


# microtech Komponente im Portal konfigurieren

> **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](#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](/knowledge/docs/base/microtech-connection.md)). |
| **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](/knowledge/docs/base/microtech-netbird-setup.md).

---

## Verbindungstest

Bevor Sie die Verbindung aktivieren, sollten Sie den Verbindungstest durchführen. Der Test prüft:

1. **OAuth-Token**: Es wird ein echtes OAuth-Token von Ihrer microtech-Instanz angefordert.
2. **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-ID` und `Client-Secret` mit den Werten aus der microtech-Anwendungsverwaltung überein?
> - Bei NetBird- oder selbstsignierten Zertifikaten: Ist das passende Zertifikat hinterlegt und in `BpConfig.exe` aktiviert?
> - Ist GraphQL im Mandanten aktiviert?
> - Hat der zugeordnete Benutzer die Berechtigung `Zugriff über GraphQL erlaubt`?
>
> Details zur Einrichtung finden Sie in der [Basis-Konfiguration](/knowledge/docs/base/microtech-connection.md).


---

## 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**](/knowledge/docs/products/invoice/tenant-config/invoice-portal-config.md)
> - [**Belegeingang per E-Mail im Portal einrichten**](/knowledge/docs/products/invoice/tenant-config/mail-portal-config.md)
> - [**Workflow-Komponente im Portal konfigurieren**](/knowledge/docs/products/workflow/tenant-config/workflow-portal-config.md)
>
> Fahren Sie anschließend mit der produktbezogenen [**Systemkonfiguration**](/knowledge/docs/products/invoice/system-config.md) fort oder kehren Sie zur [**Basiskonfiguration Übersicht**](/knowledge/docs/base.md) zurück.
