原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚 登录

FISCAi Octopus API Connector

作者:MnrAlci版本 1.0.0i★ 0i在你的电脑上运行代码仓库 ↗
注册名称io.github.MnrAlci/fiscai-octopus-api-connector

安装方法

能做什么

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

作者提供的原文

  • 连接方式 在你的电脑上运行
  • 账号或密钥 需要 OCTOPUS_SOFTWARE_HOUSE_UUID, OCTOPUS_USER, OCTOPUS_PASSWORD, OCTOPUS_CACHE_KEY
  • 分类 会计、财务与税务

为什么排在这里

列表按使用分(满分 100)排序,由以下部分组成

热度0/80GitHub 星标或每周下载量:较大的计 60,较小的计 20
新鲜度12/1230 天内有发布或代码更新得满分
仍在响应0/8上次检查时云端端点有响应
使用分12/100

质量: 基础检查通过 3/3 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)

安装

选择你使用的 AI 应用,然后复制设置。

通过 3/3 项检查 · 在你的电脑上运行

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude,但需要先准备

不需要密钥,不用安装程序 · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用

  1. 下载开发者的安装文件

    下载作者的 .mcpb 文件

    .mcpb 文件直接来自开发者,我们没有修改

  2. 双击文件,然后在电脑版 Claude 应用中点击 Install

  3. 试一试

    用 FISCAi Octopus API Connector 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 FISCAi Octopus API Connector,或回答中出现 FISCAi Octopus API Connector 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

ChatGPT 暂时无法连接 FISCAi Octopus API Connector

FISCAi Octopus API Connector 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器

你可以改用这些方式

A · 使用能连接 FISCAi Octopus API Connector 的应用

  • 不需要密钥,不用安装程序 · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用

B · 会计、财务与税务 类中能连接 ChatGPT 的其他服务器

从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的

Claude Code 暂时无法连接 FISCAi Octopus API Connector

开发者只提供了电脑版 Claude 应用的安装文件

你可以改用这些方式

A · 使用能连接 FISCAi Octopus API Connector 的应用

  • 不需要密钥,不用安装程序 · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用

Cursor 暂时无法连接 FISCAi Octopus API Connector

开发者只提供了电脑版 Claude 应用的安装文件

你可以改用这些方式

A · 使用能连接 FISCAi Octopus API Connector 的应用

  • 不需要密钥,不用安装程序 · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用

VS Code 暂时无法连接 FISCAi Octopus API Connector

开发者只提供了电脑版 Claude 应用的安装文件

你可以改用这些方式

A · 使用能连接 FISCAi Octopus API Connector 的应用

  • 不需要密钥,不用安装程序 · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 FISCAi Octopus API Connector 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

需要你填写的值

  • OCTOPUS_SOFTWARE_HOUSE_UUID 机密 必填 env
    UUID die Octopus aan uw software toekent (header softwareHouseUuid). Geheim.
  • OCTOPUS_USER 机密 必填 env
    具有 API 访问权限的 Octopus 用户的用户名(电子邮件)。机密信息。
    查看英文原文Gebruikersnaam (e-mail) van de Octopus-gebruiker met API-toegang. Geheim.
  • OCTOPUS_PASSWORD 机密 必填 env
    Wachtwoord van die gebruiker. Alleen in het geheugen; nooit gelogd. Geheim.
  • OCTOPUS_CACHE_KEY 机密 必填 env
    可选,至少 16 个字符:用于加密本地缓存和磁盘上的同步数据。若无此密钥,则仅保存在内存中。机密信息。
    查看英文原文Optioneel, 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
    可选:逗号分隔的文件夹 ID;其他文件夹将被拒绝。
    查看英文原文Optioneel: komma-gescheiden dossier-id's; andere dossiers worden geweigerd.
  • OCTOPUS_QUOTA_RESERVE env
    连接器为每个端点保留的调用次数(默认为 0)。
    查看英文原文Aantal 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
    Standaard uit. Alleen true zet de tweestaps-schrijftools aan.
  • OCTOPUS_WRITE_MAX_PER_DAY env
    范围 1 至 200,默认值为 20。
    查看英文原文1 tot 200, standaard 20.

说明为自动翻译,变量名保持原样;不确定时请查看原文。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

一览

每周下载量i
不在 npm/PyPI 上
许可证i
Apache-2.0
连接方式
在你的电脑上运行
最新版本i
1.0.0
发布到注册中心i
2026年11月21日
代码最后更新i
2026年11月21日
作者
MnrAlci
软件包
mcpb: …/fiscai-octopus-api-connector-1.0.0.mcpb
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

在你的电脑上运行,适用于

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

全部应用及其优缺点 →

它能做什么

它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月21日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 MnrAlci 验证,该账户拥有此仓库

  • ✓ 通过

    仍在维护

    代码最后更新于今天

  • ✓ 通过

    有许可证

    使用 Apache-2.0

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

已公开的漏洞(OSV.dev)

未检查:只能检查标明版本的 npm 和 PyPI 包

我们检查什么 → · JSON

作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![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)

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“会计、财务与税务”中的其他服务器比较i

  • 星标数多于此分类中其他 3609 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 3609 个服务器的 95% 更新
  • 基础检查结果等于或优于此分类中其他 3609 个服务器的 99%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

FISCAi Octopus API Connector 安全吗?

它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:OCTOPUS_SOFTWARE_HOUSE_UUID, OCTOPUS_USER, OCTOPUS_PASSWORD, OCTOPUS_CACHE_KEY

它在我的电脑上运行还是在云端?

它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。

它还在维护吗?

GitHub 仓库最后更新于今天,最新版本(1.0.0)于今天进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 MCPB。

有什么可以替代它?

同一分类中有:SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

SolidInvoice

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

作者:SolidInvoice正在增长★ 98912天前更新

在云端运行✓ 服务方 · solidinvoice.co

Journalit

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

作者:Cursivez正在增长★ 26513天前更新

在云端运行✓ 服务方 · journalit.co

Beancount.io

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

作者:bex-co正在增长★ 723 整个仓库的星标2个月前更新

在云端运行✓ 服务方 · beancount.io

Twelve Data

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

作者:twelvedata正在增长★ 8717天前更新

在云端运行✓ 服务方 · twelvedata.com
与相似项目对比
本项
FISCAi Octopus API Connector
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
运行位置需要安装在电脑上在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装云端或安装在电脑上都可以在云端运行,无需安装
需要密钥是否否否是否
可在 Claude 中按 + 添加否否否否否是
基础检查3/34/64/44/45/54/4
许可证Apache-2.0MITNOASSERTIONMITMIT–
价格登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

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)