Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

FISCAi Octopus API Connector

von MnrAlciVersion 1.0.0i★ 0iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.MnrAlci/fiscai-octopus-api-connector

So installierst du es

Was es kann

Read-only Octopus API for Belgian accountants. Powered by FISCALCI Accounting & Tax (Askin Alci)

Originaltext des Herstellers

  • Verbindung Läuft auf deinem Computer
  • Konto oder Schlüssel Braucht OCTOPUS_SOFTWARE_HOUSE_UUID, OCTOPUS_USER, OCTOPUS_PASSWORD, OCTOPUS_CACHE_KEY
  • Kategorie Buchhaltung, Finanzen & Steuern

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

3/3 Prüfungen bestanden · Läuft auf deinem Computer

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

  1. Installationsdatei des Anbieters herunterladen

    Die .mcpb-Datei des Entwicklers herunterladen

    Die .mcpb-Datei kommt direkt vom Anbieter; wir ändern sie nicht

  2. Datei doppelklicken, dann in der Claude-Desktop-App Install klicken

  3. Ausprobieren

    Nutze FISCAi Octopus API Connector und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es FISCAi Octopus API Connector nutzt, oder ein Werkzeug von FISCAi Octopus API Connector in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann FISCAi Octopus API Connector noch nicht verbinden

FISCAi Octopus API Connector läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die FISCAi Octopus API Connector verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

B · Andere in Buchhaltung, Finanzen & Steuern, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Claude Code kann FISCAi Octopus API Connector noch nicht verbinden

Der Anbieter liefert nur ein Installationspaket für die Claude-Desktop-App

Das kannst du stattdessen tun

A · Eine App nutzen, die FISCAi Octopus API Connector verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Cursor kann FISCAi Octopus API Connector noch nicht verbinden

Der Anbieter liefert nur ein Installationspaket für die Claude-Desktop-App

Das kannst du stattdessen tun

A · Eine App nutzen, die FISCAi Octopus API Connector verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

VS Code kann FISCAi Octopus API Connector noch nicht verbinden

Der Anbieter liefert nur ein Installationspaket für die Claude-Desktop-App

Das kannst du stattdessen tun

A · Eine App nutzen, die FISCAi Octopus API Connector verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die FISCAi Octopus API Connector nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Werte, die du selbst einträgst

  • OCTOPUS_SOFTWARE_HOUSE_UUID geheim erforderlich env
    UUID that Octopus assigns to your software (header softwareHouseUuid). Secret.
    Englisches Original anzeigenUUID die Octopus aan uw software toekent (header softwareHouseUuid). Geheim.
  • OCTOPUS_USER geheim erforderlich env
    Benutzername (E-Mail) des Octopus-Benutzers mit API-Zugriff. Geheim.
    Englisches Original anzeigenGebruikersnaam (e-mail) van de Octopus-gebruiker met API-toegang. Geheim.
  • OCTOPUS_PASSWORD geheim erforderlich env
    Wachtwoord van die gebruiker. Alleen in het geheugen; nooit gelogd. Geheim.
  • OCTOPUS_CACHE_KEY geheim erforderlich env
    Optional, mindestens 16 Zeichen: verschlüsselt den lokalen Cache und die Synchronisation auf dem Datenträger. Ohne Schlüssel nur im Arbeitsspeicher. Geheim.
    Englisches Original anzeigenOptioneel, minstens 16 tekens: versleutelt de lokale cache en synchronisatie op schijf. Zonder sleutel alleen in het geheugen. Geheim.
  • OCTOPUS_LOCALE_ID env
    localeId voor het dossiertoken (0-4, standaard 1; verifieer actuele regel).
  • OCTOPUS_ALLOWED_DOSSIERS env
    Optional: durch Kommas getrennte Ordner-IDs; andere Ordner werden abgelehnt.
    Englisches Original anzeigenOptioneel: komma-gescheiden dossier-id's; andere dossiers worden geweigerd.
  • OCTOPUS_QUOTA_RESERVE env
    Anzahl der Aufrufe pro Endpunkt, die der Connector reserviert (Standard 0).
    Englisches Original anzeigenAantal calls per endpoint dat de connector vrijhoudt (standaard 0).
  • OCTOPUS_AMOUNTS_MODE env
    movement (beweging per periode, standaard) of cumulative. Verifieer actuele regel met de controle in de dossieroverdracht.
  • OCTOPUS_WRITE_ENABLED env
    Off by default. Only true enables the two-step write tools.
    Englisches Original anzeigenStandaard uit. Alleen true zet de tweestaps-schrijftools aan.
  • OCTOPUS_WRITE_MAX_PER_DAY env
    1 bis 200, Standard ist 20.
    Englisches Original anzeigen1 tot 200, standaard 20.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Lizenzi
Apache-2.0
Verbindung
Läuft auf deinem Computer
Neueste Versioni
1.0.0
In der Registry veröffentlichti
21. Nov. 2026
Code zuletzt geänderti
21. Nov. 2026
Entwickler
MnrAlci
Pakete
mcpb: …/fiscai-octopus-api-connector-1.0.0.mcpb
Website
github.com
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 21. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto MnrAlci bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: heute

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt Apache-2.0

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Nicht geprüft: nur npm- und PyPI-Pakete mit Version lassen sich prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mnralci-fiscai-octopus-api-connector.svg)](https://mcp.popnx.com/en/servers/mnralci-fiscai-octopus-api-connector)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

  • Mehr Sterne als 0 % der anderen 3609 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 95 % der anderen 3609 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 3609 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist FISCAi Octopus API Connector sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: OCTOPUS_SOFTWARE_HOUSE_UUID, OCTOPUS_USER, OCTOPUS_PASSWORD, OCTOPUS_CACHE_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (1.0.0) kam heute in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du MCPB auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

von SolidInvoiceWachsend★ 989Aktualisiert vor 12 Tagen

Läuft in der Cloud✓ vom Dienst · solidinvoice.co

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

von CursivezWachsend★ 265Aktualisiert vor 13 Tagen

Läuft in der Cloud✓ vom Dienst · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

von bex-coWachsend★ 723 Sterne des ganzen ReposAktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · beancount.io

Twelve Data

Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.

von twelvedataWachsend★ 87Aktualisiert vor 17 Tagen

Läuft in der Cloud✓ vom Dienst · twelvedata.com
Im Vergleich mit ähnlichen
Dieser
FISCAi Octopus API Connector
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinJaNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinJa
Basisprüfungen3/34/64/44/45/54/4
LizenzApache-2.0MITNOASSERTIONMITMIT–
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

FISCAi Octopus API Connector Plugin for Grok Bot, also works in Copilot, Claude, Cursor, Windsurf and other MCP clients

Read-only access to the Octopus accounting REST API, built around its very low daily limits: cache first, sync through the modified-since endpoints, never a paid plan.

Nederlands · Tools · Manual · Changelog

Powered by FISCALCI Accounting & Tax (Askin Alci)

Author: Askin Alci

Belgium. Made for Belgian accountants and bookkeepers: it follows the Belgian chart of accounts (MAR) and Belgian VAT. Outside Belgium, check the local rules yourself.

Not yet tested against a live Octopus dossier. This connector has only been tested against a mocked API built from the official specification (there is no Octopus sandbox). Feedback and findings are welcome through GitHub issues. Open points: docs/OPEN-QUESTIONS.md.

Nederlandse samenvatting. Bedoeld voor Belgische boekhouders/accountants; gebaseerd op Belgische boekhoud- en btw-regels (MAR, Belgisch btw-stelsel). Gebruik buiten België: verifieer zelf de lokale regels. Zie README.nl.md.

About

FISCAi Octopus API Connector is a local MCP server (stdio) and command-line tool that lets Grok Bot and other MCP clients read Octopus dossiers: fiscal years, journals, chart of accounts, balances per period, booking lines, customers and suppliers, open items and reports. On top of that it builds what the API does not offer directly (a trial balance, ageing, MAR key figures) and produces exports and a dossier transfer package per fiscal year for the next accountant. Status: 1.0.0, tested offline against a mocked API built from the official specification; not yet validated against a live Octopus dossier (see open questions).

Contents

What it does · Daily limits · Install · Configuration · Security · Tools · Limitations · License

More. Setup · Manual (EN) · Handleiding (NL) · CLI · Hooks · Automation · Dossier transfer · Export schema · Integrations · Postman · Write mode · Operations · Privacy and data flow · Troubleshooting · Open questions · Agents

What it does

  • 49 read-only tools (51 with the optional write mode): dossiers, fiscal years, journals, chart of accounts, balances, booking lines, relations, open items, history reports, invoices, delivery notes, reminders, master data.
  • Trial balance built from accounts and balances per period, because Octopus has no trial-balance endpoint; with a balance check and totals per MAR class.
  • Analyses: ageing of open items, MAR key figures (revenue, costs, result, cash, receivables, payables, VAT indication), comparison with the previous fiscal year.
  • Local sync through the official modified-since endpoints: one full load, then only changes. Encrypted on disk with your own key, or memory only.
  • Export to CSV, JSON, Excel (xlsx) and Parquet for Power BI, Excel, databases and notebooks.
  • Dossier transfer per fiscal year: chart of accounts, closing trial balance, booking lines, open items at year end, journals, relations, VAT codes, CONTROL.md checks and MANIFEST.json with SHA-256, resumable when a daily limit is hit.
  • Automation: meeting preparation and recurring obligations (VAT, listings, annual accounts) as overviews and draft e-mails; nothing is sent by default.
  • Free official helpers (optional): Belgian VAT-number check (offline modulo 97, optional VIES of the European Commission) and ECB euro reference rates.

Daily limits and how the connector copes

The official Octopus REST specification sets a maximum number of calls per day per endpoint. Some are very low:

Endpoint groupCalls per day
Accounts, VAT codes, currencies, cost centres, custom fields, products, product groups; relations without search2
One purchase/sales or financial/miscellaneous booking10
Fiscal years, journals, reports (open items, history)24
All *modified-since* endpoints48
Dossier list and dossier token150
Relations with a search term, invoices, delivery notes, reminders400

So the connector:

  1. counts every call before sending it and refuses when today's limit (Europe/Brussels) is reached, instead of letting Octopus send you a warning e-mail (octopus_quota shows what is left);
  2. caches responses according to the limit (12 hours for 2/day master data);
  3. syncs accounts, balances, relations and bookings with the modified-since endpoints (first load per fiscal year and journal type with 1980-01-01 00:00:00.000, then fiscal year -1 and journal type -1 with the last watermark), exactly as the specification describes;
  4. refreshes the 10-minute tokens (authentication token and dossier token) automatically, one minute before they expire, and retries once on HTTP 401;
  5. never uses the paid Management API, the file-import API or any paid plan.

Install

Requirements: Python 3.10+, httpx, cryptography (and pyarrow only for Parquet). Octopus API access: a software house UUID from Octopus and an Octopus user with API rights. There is no sandbox; use the demo dossier for testing (verifieer actuele regel).

Grok Bot. Add the plugin from its repository and fill in the variables OCTOPUS_SOFTWARE_HOUSE_UUID, OCTOPUS_USER and OCTOPUS_PASSWORD (secrets). Then ask, for example: *"Show the trial balance of dossier 101 for 2026"* (example dossier number).

Command line.

pip install -r requirements.txt

python server/run_cli.py config init # writes a .env with placeholders only python server/run_cli.py doctor # checks Python, dependencies and configuration; makes no call python server/run_cli.py call octopus_dossiers python server/run_cli.py sync --dossier 101 --bookyear 2 python server/run_cli.py call octopus_proefbalans dossier_id=101 jaar=2026 python server/run_cli.py transfer --dossier 101 --out ./overdracht # estimate first; add --yes to run

Other MCP clients (Cursor, Claude Desktop/Code, VS Code Copilot, Windsurf): see examples/ for ready-made configuration files; they all start server/run_server.py over stdio.

Configuration

VariableMeaning
OCTOPUS_SOFTWARE_HOUSE_UUIDSoftware house UUID (header softwareHouseUuid). Secret.
OCTOPUS_USER, OCTOPUS_PASSWORDOctopus user with API access. Secret; memory only, never logged.
OCTOPUS_CACHE_KEYOptional, 16+ characters: encrypts cache and sync on disk. Without it everything stays in memory.
OCTOPUS_LOCALE_IDlocaleId for the dossier token (0-4, default 1; verifieer actuele regel).
OCTOPUS_ALLOWED_DOSSIERSOptional comma-separated allow-list of dossier ids.
OCTOPUS_QUOTA_RESERVECalls per endpoint kept in reserve (default 0).
OCTOPUS_AMOUNTS_MODEmovement (default) or cumulative: how balances per period are read (verifieer actuele regel).
OCTOPUS_WRITE_ENABLEDOff by default. true adds the two-step write tools.
OCTOPUS_DATA_DIR, OCTOPUS_HOOKS_FILE, OCTOPUS_LOG_LEVELData folder, hooks file, log level.

Security and safety

  • Read-only by default. Write tools do not exist unless OCTOPUS_WRITE_ENABLED=true; even then every write is a proposal first and needs a confirmation code, with a daily maximum. Delete operations are never offered. See WRITE.md.
  • Your credentials, your computer. No central server. Tokens live in memory only; secrets are scrubbed from every output, log and error.
  • Only the official host. The base URL must be https://service.inaras.be/octopus-rest-api/...; the Management API is refused.
  • No client data in this repository. Examples use [Voorbeeld] data only.
  • No tax or legal advice: check figures against the source and the current rules.

Tools

See docs/TOOLS.md for all tools with their Octopus endpoint and daily limit (generated from the code).

Limitations

  • Not yet validated against a live Octopus dossier; several API details are marked verifieer actuele regel and listed in docs/OPEN-QUESTIONS.md (for example whether balances per period are movements or cumulative, and the exact error object).
  • No pagination in the API: large lists come in one response; tools cap what they show (max_rijen), exports always contain everything.
  • Attachments (file sync), OAuth and a dashboard widget are on the roadmap.

Shared core

The reusable parts (MCP server, CLI base, hooks, export layer, automation, dossier-transfer package, token cache, daily-limit counter, encrypted store, trial-balance builder, analyses) live in FISCAi Accounting API Core and are vendored in server/vendor/accounting_api_core (python scripts/sync_core.py).

License

Apache License 2.0, see LICENSE and NOTICE. The attribution "Powered by FISCALCI Accounting & Tax (Askin Alci)" must stay intact in every copy and in generated exports.

Octopus is a trademark of its owner; this project is not endorsed by it.

Powered by FISCALCI Accounting & Tax (Askin Alci)