Anleitung · Codex und MCP
Codex mit bimetrics verbinden
Verbinde Codex mit bimetrics und frage nach deinen Belegen. Diese Anleitung zeigt die Einrichtung über die Codex CLI und einen ersten lesenden Auftrag: eine Lieferantenrechnung finden und in bimetrics prüfen.
- MCP-Server hinzufügen
- Unternehmen freigeben
- Beleg finden
Das brauchst du
- Eine installierte Codex CLI auf deinem Rechner und Zugang zu Codex. Die lokale Desktop-App, CLI und IDE-Erweiterung teilen sich die MCP-Konfiguration auf demselben Codex-Host.
- Ein Unternehmen in bimetrics mit bezahltem Tarif. Der MCP-Zugang ist ohne Aufpreis in Solo, Team und Scale enthalten, nicht in der Testphase.
- Die Rolle Inhaber oder ein MCP-Recht vom Inhaber unter Einstellungen → Team. Für den ersten Auftrag genügt Lesen.
Ein API-Schlüssel und ein eigener MCP-Server sind nicht nötig. Die Verbindung meldest du bei bimetrics im Browser an.
Codex verbinden
Server hinzufügen und Anmeldung starten
Führe diese beiden Befehle nacheinander im Terminal aus. Eine Client-ID oder ein Client-Secret brauchst du nicht.
Codex CLIcodex mcp add bimetrics --url https://app.bimetrics.de/mcp codex mcp login bimetrics --scopes mcp:read,mcp:write,offline_accessFirma und Rechte wählen
Melde dich im geöffneten Browser bei bimetrics an und wähle die gewünschten Unternehmen. Schreibzugriff erlauben ist vorausgewählt, sofern du schreiben darfst. Nimm das Häkchen für den lesenden Einstieg heraus und bestätige mit Verbindung erlauben.
Verbindung in Codex prüfen
Mit
codex mcp listprüfst du den eingetragenen Server. Starte Codex neu und öffne einen neuen Chat. In der Codex CLI zeigt/mcpdie aktiven MCP-Verbindungen.
Unter Einstellungen → MCP in bimetrics kannst du die Verbindung prüfen oder widerrufen. Sie gilt höchstens 30 Tage. Für spätere Änderungen brauchst du eine neue Freigabe mit Schreibzugriff.
Einen Lieferantenbeleg finden
Wähle einen Lieferanten, dessen Rechnung bereits in bimetrics liegt. Ersetze Firmenname, Lieferant und Zeitraum im Auftrag. Der Zeitraum bezieht sich auf das Rechnungsdatum.
Lieferantenbelege lesen
Prompt anzeigen
Nutze die bimetrics-Verbindung. Liste zuerst die freigegebenen Unternehmen auf und arbeite nur in [Firmenname]. Frage bei einer unklaren Firmenauswahl nach. Suche dort eingehende Belege von [Lieferant] mit Rechnungsdatum zwischen [JJJJ-MM-TT] und [JJJJ-MM-TT]. Zeige höchstens fünf Treffer mit Rechnungsnummer, Rechnungsdatum, Lieferant, gespeichertem Bruttobetrag und App-Link. Nenne fehlende Angaben und ob weitere Treffer vorhanden sind. Ändere keine Daten und lade keine Dateien hoch.
Arbeitsvorlage für einen lesenden Abruf, kein ausgeführtes Ergebnis. Die Suche zeigt zuerst die zuletzt hinzugefügten Belege; fünf Treffer sind gegebenenfalls nur eine Auswahl.
So prüfst du das Ergebnis: Öffne einen App-Link und vergleiche Firma, Rechnungsnummer und Betrag mit dem Originalbeleg. Bei mehreren ähnlichen Treffern entscheidet die Rechnungsnummer. Findet Codex nichts, prüfe den Lieferantennamen und das Rechnungsdatum in bimetrics; kein Treffer beweist nicht, dass die Rechnung fehlt.
Mit deinen Belegen weiterarbeiten
Mit der bestätigten Firma kannst du Lieferantenrechnungen und Zahlungen vergleichen oder die offenen Punkte eines Monats zusammenstellen.
Für den Belegupload brauchst du Schreibzugriff. Codex überträgt die Datei über files.bimetrics.de, wenn es die Datei lesen und den Host erreichen kann. Andernfalls wählst du die Datei über den angebotenen Link in bimetrics aus.
Wenn es nicht klappt
- Die Firma fehlt bei der Freigabe
- Prüfe den bezahlten Tarif und dein MCP-Recht in bimetrics. Als Teammitglied vergibt dir der Inhaber das Recht. Starte danach die Anmeldung erneut.
- Codex findet die Verbindung nicht
- Prüfe den Eintrag mit
codex mcp listauf dem Rechner, auf dem Codex läuft. Vergleiche die URL mithttps://app.bimetrics.de/mcpund starte Codex nach der Einrichtung neu. - Die Anmeldung ist abgelaufen
- Starte
codex mcp login bimetricserneut und bestätige die Freigabe in einem eigenen Browser-Tab. Für eine beendete Verbindung wählst du Unternehmen und Rechte erneut.
Quellen und Stand der Anleitung
Stand: 9. Oktober 2026. Verbindungsweg und Codex-Befehle: bimetrics-Anleitung zum Verbinden und offizielle OpenAI-Dokumentation zu MCP. Den Umfang der Freigabe erklärt bimetrics unter Berechtigungen und Freigabe.