Verbindung einrichten · Stand 4. November 2026
Accounting Scalable mit Codex CLI verbinden
Verbinden Sie den Terminal-Client Codex CLI über Streamable HTTP mit einem bewusst eingerichteten Lesezugang. Die native Konfiguration verweist auf eine private Umgebungsvariable statt ein Token in die Konfigurationsdatei zu schreiben.1
Voraussetzung: Erforderlich ist ein für Codex CLI freigeschalteter Zugang. OpenAI nennt den CLI-Zugriff ausdrücklich beim Plus-Tarif; prüfen Sie die Freischaltung Ihres konkreten Kontos. Ein separat abgerechneter API-Zugang ist ein anderer möglicher Weg. Ein ChatGPT-Web-Plugin verwendet einen eigenen Verbindungsweg.2
Client, Datenweg und Browserfunktion
- Plattform
- Terminal-Client, hier Linux; die Befehle gelten für Codex CLI. Für andere Betriebssysteme sind Terminal und sichere Umgebungsvariablenverwaltung passend einzurichten.
- Deutschland und Konto
- Deutschland ist im OpenAI-API-Zugangsgebiet aufgeführt. Das ersetzt keine Prüfung des konkreten Kontos, Tarifs oder einer Browserfreischaltung.
- MCP und Authentifizierung
- Streamable HTTP, Bearer-Token über bearer_token_env_var. Die tatsächlich aus Ihrer Instanz übernommene HTTPS-MCP-Adresse verwenden.
- Browser
- Die Datenverbindung bringt keine Browserbedienung mit. Für ELSTER ist ein zusätzlich verfügbarer und ausdrücklich freigegebener Browserweg nötig.3
1. Persönlichen Agentenzugang mit Leserecht bereitstellen
Öffnen Sie in Ihrer Accounting-Scalable-Instanz die Benutzerverwaltung, wählen Sie den vorgesehenen aktiven Agenten und lassen Sie „Schreibzugriff“ ausdrücklich aus. Diese Einstellung ist für den Leseweg entscheidend: Die Tokenrotation darf nicht unbeabsichtigt Schreibrecht einschalten. Der Zugang umfasst trotzdem alle Gesellschaften der Instanz.
- Unter /#/accounting/table_user den vorgesehenen Agenten öffnen; Administrator-/Superuserrecht ist erforderlich.
- MCP-Adresse aus dem Agentenprofil übernehmen. Der App-Endpunkt ist /mcp; er ist nicht der Website-Produktwissensserver.
- Nur wenn ein neues Zugangstoken benötigt wird „Zugangstoken ändern“ bewusst ausführen. Es wird einmalig angezeigt und widerruft alle bisherigen Tokens dieses Agenten.
- Das Token direkt im Zugangsfeld des Clients beziehungsweise einer privaten Prozess-Umgebungsvariablen hinterlegen. Nicht in URL, HTML, Screenshots, Git oder Analyseereignisse schreiben.
2. Native URL-/Bearer-Verbindung registrieren
Übernehmen Sie die Serveradresse aus der Instanz. Die bekannte öffentliche Demo-MCP-Adresse lautet https://demo-api.accountingscalable.de/mcp; sie ist ein anderer Datenraum und benötigt einen gesondert bereitgestellten Lesezugang. Der normale Browserdemo-Login liefert keinen persönlichen Agententoken.
- Die private Prozess-Umgebungsvariable AS_MCP_TOKEN mit dem persönlich bereitgestellten Token befüllen, ohne es in Shell-History oder Screenshots zu schreiben.
- Die unten gezeigte native Konfiguration mit Ihrer echten Serveradresse verwenden. Ein Platzhalter ist keine Serveradresse.
- Alternativ den dokumentierten nativen Befehl verwenden: codex mcp add accounting_scalable --url "<MCP_ADRESSE_AUS_IHRER_INSTANZ>" --bearer-token-env-var AS_MCP_TOKEN.
- In einer neuen Codex-Sitzung /mcp öffnen und Werkzeuge/Rechte prüfen. codex mcp list oder get allein bestätigt nur die Registrierung, keinen erfolgreichen Buchhaltungsabruf.
3. Mit einem nicht schreibenden Auftrag kontrollieren
Eine konfigurierte Verbindung beweist noch keinen passenden Datenabruf. Prüfen Sie Rechte, Gesellschaft und Zeitraum an der tatsächlichen Serverantwort.
- Im Client die aktuelle Werkzeugliste und die Antwort von capabilities_get lesen; der über MCP verfügbare Abschlussbereich ist enger als der vollständige App-Assistent.
- Gesellschaft über companies_list bestimmen, Wirtschaftsjahr über economic_years_search auswählen.
- Report mit ausdrücklich bestätigter company_id und Stichtag anfordern.
- Identität, parameters, Währung und Abrufstand der Antwort mit Ihrer Auswahl vergleichen. Ein aktiver UI-Mandant wird nicht automatisch benutzt.
4. Typische Fehler gezielt eingrenzen
HTTP 401 kann ein fehlendes, widerrufenes oder falsch übertragenes Token bedeuten. Bei 403 prüfen Sie Agentenstatus und Rechte. HTML statt MCP oder HTTP 404 spricht für eine falsche Adresse.
- Den festen Bearer-Header an jeder Anfrage prüfen, ohne das Token in Fehlerberichte zu kopieren.
- Keinen OAuth-Login erfinden: Der derzeitige App-MCP bietet keinen solchen Anmeldeweg.
- Bei fehlender Gesellschaft oder nicht passendem Zeitraum anhalten; keine Ersatz-ID raten.
- Ein UStVA-Monatsabruf kann zu einem quartalsweisen Meldeintervall unpassend sein. Prüfen Sie die Stammdaten statt einen Fehler durch Nullwerte zu verdecken.
5. Verbindung widerrufen und verbleibende Aufgaben trennen
Entfernen Sie die Verbindung im Client und deaktivieren Sie den Agenten oder rotieren Sie dessen Token bewusst in der App. Rotation wirkt auf alle bisherigen Tokens dieses Agenten.
- Prüfen Sie, ob derselbe Agentenzugang noch von anderen freigegebenen Workflows benötigt wird.
- Browserbedienung und Steuerformularzugriff werden separat freigegeben und geprüft. Die MCP-Verbindung allein öffnet kein ELSTER-Formular.
- Für Erklärungen die jeweiligen Zusatzangaben und Fachfragen klären; vor der Abgabe bewusst stoppen.
- Die lokale Client-Verbindung mit codex mcp remove accounting_scalable entfernen. codex mcp logout betrifft OAuth-Zugangsdaten; es widerruft keinen festen App-Bearer-Token. Serverseitigen Zugriff separat am persönlichen Agenten entziehen.
Ein erster, ausschließlich lesender Auftrag
Ersetzen Sie die Platzhalter nach der tatsächlichen Werkzeugantwort. Das Ergebnis muss die gewünschte Gesellschaft und den richtigen Stichtag erkennen lassen. Eine gespeicherte Serverkonfiguration allein ist kein erfolgreicher Datenabruf.
Passenden Workflow anschließen
Wenn Datenzugang und zusätzlicher Browserzugang zusammen verfügbar und freigegeben sind, können Sie bestätigte Werte im passenden ELSTER-Formular eintragen lassen.
Kompatibilität und tatsächlichen Prüfstand ansehen →Offizielle Clientgrundlagen
- Model Context Protocol
- Command line options – Codex CLI
- Pricing
- Supported countries and territories
- Browser
Anleitung aktualisiert am 4. November 2026. Prüfen Sie sichtbare Konto- und Clientfunktionen vor der Einrichtung.
Hinweise und Voraussetzungen
Sie prüfen Geschäftsvorfälle, Ergebnisse und fachliche Entscheidungen. Die App ermöglicht selbstständige laufende Buchhaltung und Jahresabschluss; der konkrete MCP-Zugang hat seinen eigenen, gegebenenfalls engeren Funktionsumfang.
Agentenzugänge gelten instanzweit für alle Gesellschaften. Der gewählte Client verarbeitet die freigegebenen Daten nach seinen eigenen Bedingungen; ein Cloud-Connector überträgt Daten an seinen Anbieter. Zugangsdaten gehören nur in die vorgesehenen vertraulichen Clientfelder.
MCP-Datenzugriff, Browserbedienung, steuerliche Prüfung und tatsächliche Übermittlung sind getrennte Schritte. Eine Formularprüfung ersetzt keine materielle Fachprüfung. Anmeldung und Abgabeentscheidung bleiben bei Ihnen.