Skip to main content
Glama
mf-full-mcp

mf-full-mcp

mf-full-mcp

Dies ist ein inoffizieller MCP-Server für マネーフォワード クラウド会計. Er bietet Tools mit denselben Namen wie das offizielle Beta-MCP (mfc_ca_*) und ergänzt die folgenden drei Punkte:

  • Anhängen von Belegen – Belege wie Quittungen oder Rechnungen hochladen und einem Journaleintrag zuordnen. Das offizielle Remote-MCP hat diese Funktion Stand August 2026 nicht.

  • Gleichzeitige Verbindung zu mehreren Unternehmen – Tokens für mehrere juristische Personen vorhalten und ohne erneute Authentifizierung je Fenster/Sitzung mit unterschiedlichen Unternehmen verbinden.

  • Vollständiges Löschen von Journaleinträgen – Das offizielle MCP unterstützt nur das Anlegen und Aktualisieren, kein Löschen.

Die Nutzung ist auf Arbeitsabläufe ausgelegt, wie sie in Steuerberatungskanzleien üblich sind, die täglich in den Büchern von Dutzenden von Unternehmen arbeiten.

Dies ist ein inoffizielles Projekt. Es steht in keiner Verbindung zu 株式会社マネーフォワード und wird von diesem Unternehmen nicht unterstützt.


Warum ich das gebaut habe

Die Access-Tokens von MF sind an das eine Unternehmen gebunden, das im Autorisierungsbildschirm ausgewählt wurde (das zeigt sich daran, dass /api/v3/offices statt eines Arrays ein einzelnes Objekt zurückgibt). Um mehrere juristische Personen zu verwalten, muss man genauso viele Tokens besitzen.

Das offizielle Remote-MCP hat zwei Endpoints, die jeweils unterschiedliche Eigenheiten haben.

Offizielle Beta

Offizielle Alpha

Dieser Server

Mehrere juristische Personen gleichzeitig

Nein (bei Wechsel erneute Authentifizierung)

Ja

Ja

Lebensdauer der Tokens

Lang

ca. 1 Stunde

Automatische Aktualisierung (messbar länger als 1 Monat unbeaufsichtigt möglich)

Authentifizierungsvorgang

Automatisch

Autorisierungscode manuell kopieren/einfügen

Automatisch

Belege anhängen

Nein

Nein

Ja

Die Beta-Version ist bei der Authentifizierung bequem, kann aber nur ein Unternehmen vorhalten; die Alpha-Version kann mehrere vorhalten, aber das Token läuft nach ca. 1 Stunde ab und erfordert eine manuelle erneute Authentifizierung.

**„Mehrere juristische Personen getrennt je Fenster zu bedienen, ohne sich um erneute Authentifizierung kümmern zu müssen – das ist mit keiner der offiziellen Varianten möglich.“** Dieser Server schließt diese Lüke, indem er OAuth selbst implementert.


Related MCP server: MF Invoice MCP

Design-Prinzipien

1. OAuth selbst implementeren (dynamische Client-Registrierung)

Bei jeder Authentifizierung wird über die dynamische Client-Registrierung nach RFC 7591 ein öffentlicher Client registriert (token_endpoint_auth_method: "none" + PKCE).

Daher ist keine vorherige App-Registrierung erforderlich, und client_secret existert von vornherein nicht. Weder in diesem Repositori noch in der Umgebung des Nutzers werden irgendwelche geheimnisse abgelegt.

2. Tokens pro Unternehmen mit Label speichern

~/.mf-full-mcp/tokens.json (Verzeichnis 0700 / Datei 0600) speichert die Tokens für mehrere Unternehmen mit Labeln als Schlüssel. Die Idee dahinter: Ein Token = ein Unternehmen – man hält also so viele, wie man braucht.

Abgelaufene Tokens werden automatisch erneuert (proaktiv 60 Sekunden vor Ablauf plus ein Retry bei 401). Messungen zeigen, dass Refresh-Tokens über einen Monat gültig sind; nach einer einmaligen Authentifizierung können Sie das System eine Weile unbeaufsichtigt lassen.

3. Das aktive Unternehmen ist pro Sitzung unabhängig

Das ist der Kern dieses Projekts.

use_office ändert nur den Speicher innerhalb des Prozesses; das active-Feld in der gemeinsamen Datei wird nicht geändert. Der Wert der gemeinsamen Datei wird nur als Anfangswert für neue Prozesse gelesen, die noch nie umgeschaltet haben.

Dadurch können Sie in Fenster A mit Unternehmen A und in Fenster B parallel mit Unternehmen B arbeiten.

Wenn hier die gemeinsame Datei geändert würde, würde der andere Prozess in dem Moment, in dem einer das Unternehmen wechselt, Daten einer anderen juristischen Person abrufen. Beim Umgang mit Büchern ist das ein Unfal, der nicht passieren darf. Das eigentliche Wesen der „Gleichzeitigen Verbindung zu mehreren Unternehmen“ liegt weniger darin, mehrere Tokens zu besitzen, als viel mehr darin, den aktiven Status nicht zu teilen.

Wenn Sie es beim Start festlegen möchten, verwenden Sie die Umgebungsvariable MF_FULL_OFFICE.

4. Automatische Zuweisung des Callback-Ports

Mit server.listen(0) lässte das Betriebssystem einen freien Port zuweisen. Die Client-Registrierung erfolgt, nachdem die redirect_uri mit dem endgültig festgelegten Port zusammengesetzt wurde (Loopback-Redirect nach RFC 8252).

Bei einem festen Port schlägt die Authentifizierung im zweiten Fenster mit EADDRINUSE fehl. Die Reihenfolge „listen → Port festeegen → register → authorize“ war nötig, um das Design aus Punkt 3 tatsächlich funktionsfähig zu machen.

Aus Gründen der Abwärtskompatibilität wird ein fester Port nur verwendet, wenn MF_FULL_CALLBACK_PORT expizit gesetzt ist.


Anhängen von Belegen

Die Tools des offiziellen Remote-MCP umfasen Stand August 2026 nur die Bearbeitung von Journaleinträgen, Berichten, Transaktinen und Stammdaten – ein Tool für die Verwaltung von Belegen (Quittungen/Rechnungen) ist nicht entalten. Wer einen Beleg einem Journaleintrag zuordnen wolte, musste das manuel im Browser tun.

Dieser Server stelt das als Tool bereit. Man übergibt lediglich den absoluten Pfad einer lokalen Datei; ales von der base64-Kodierung über den Uplad bis zum Anhängen an den Journaleintrag wird erledigt.

mfc_ca_postVouchers(journal_id: "<仕訳ID>", file_paths: ["/path/to/receipt.pdf"])

Zum Lösen der Zuordnung verwenden Sie mfc_ca_deleteVouchers.

Dass man in einem einzigen Ablauf sowohl den Journaleintrag anlegen als auch den zugehörigen Beleg anhängen kann, war eines der Motive für die Entwicklung dieses Servers.

Achtung – Wird journal_id weggelassen, entsteht ein isolierter Beleg, der keinem Journaleintrag zugeordnet ist, und es gibt keine Möglichkeit, ihn später einem Journaleintrag zuzuordnen. Geben Sie diese daher grundsätzlich immer an.


Voraussetzungen

  • Node.js 20 oder höher

  • Ein Konto bei マネーフォワード クラウド会計

Installation

git clone https://github.com/kentaroajisaka/mf-full-mcp.git
cd mf-full-mcp
npm install
npm run build

Bei Ihrem MCP-Client registrieren (im Fall von Claude Code: ~/.claude.json).

{
  "mcpServers": {
    "mf-full": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mf-full-mcp/dist/index.js"],
      "env": {}
    }
  }
}

Verwendung

Erstes Unternehmen authentifizieren

authenticate(label: "company-a")

Öffnen Sie die zurückgegebene authUrl im Browser, wählen Sie das Unternehmen aus und erteilen Sie die Zustimmung. Anschließend prüfen Sie den Status mit auth_status.

Weitere Unternehmen hinzufügen

Wiederholen Sie einfach denselben Vorgang mit einem anderen Label.

authenticate(label: "company-b")

Verbindungsziel wechseln

list_offices          保存済み事業者の一覧
use_office            このセッションの接続先を切り替える
mfc_ca_currentOffice  いまどの事業者に繋がっているか確認する

use_office hat keine Auswirkungen auf andere Sitzungen. Es wird empfohlen, vor dem Abrufen von Dten mit mfc_ca_currentOffice das Zielunternehmen zu prüfen.

Tool-Übersicht

Authentifizierung und Unternehmensverwaltung

Tool

Beschreibung

authenticate

OAuth-Authentifizierung starten (über extra_scopes können zusätzliche Bereiche wie Gehaltsabrechnung angefordert werden)

auth_status

Status des laufenden Authentifizierungsvorgangs anzeigen

list_offices

Gespeicherte Unternehmen und aktuelle Verbindung anzeigen

use_office

Verbindungsziel dieser Sitzung wechseln

remove_office

Gespeichertes Token löschen

mf_full_info

Angeforderte Bereiche, Callback-Port und andere Einstellungen anzeigen

Kompatibel mit dem offiziellen M-CP (mfc_ca_*)

Unternehmen, Abrechnungszeitraum, Sachkonten, Unterkonten, Abteilungen, Steuerkategorien, Geschäftspartner, Integrationsdienste, Abruf/Erstellung/Aktualisierung von Journaleinträgen, Bilanz sowie Gewinn- und Verlustrechnung (BS/PL), Verlaufsübersichten (BS/PL), Abruf/Erstellung/Journalisierung von Transaktionen.

Was das offizielle MCP nicht bietet

Tool

Beschreibung

mfc_ca_postVouchers

Beleg hochladen und an Journaleintrag anhängen (bei Angabe des Pfads einer lokalen Datei wird automatisch base64-kodiert)

mfc_ca_deleteVouchers

Zuordnung von Journaleintrag und Beleg aufheben (der Beleg selbst bleibt isoliert erhalten)

mfc_ca_deleteJournals

Journaleintrag vollständig löschen

Umgebungsvariablen

Variable

Standardwert

Beschreibung

MF_FULL_OFFICE

Keine

Unternehmen für die Verbindung der Sitzung beim Start festlegen

MF_FULL_CALLBACK_PORT

Automatische Zuweisung

Port für den OAuth-Callback festlegen

MF_FULL_SCOPES

16 Buchhaltungs-Scopes

Angeforderte Scopes überschreiben

MF_FULL_CLIENT_NAME

mf-full-mcp

Client-Name bei der dynamischen Client-Registrierung


Bekannte Stolpersteine

Die API von MF hat einige Stolperfallen, in die man leicht tappt.

  • ID-Enkodierung – Die IDs von MF stammen aus Base64 und enthalten z. B. %2F. Wenn man sie beim Einfügen in einen URL-Pfad nicht neu enkodiert, wird der Pfad beschädigt und es kommt zu 403. Dieser Server ist dagegen abgesichert; geben Sie die zurückgegebenen IDs jedoch unverändert und ohne Bearbeitung weiter.

  • putJournals ersetzt alles – Eine Teilaktualisierung ist nicht möglich. Bewahren Sie den ursprünglichen Journaleintrag auf, bevor Sie aktualisieren.

  • Umgang mit Schreibwerkzeugen – Das Anlegen und Aktualisieren von Journaleinträgen, das Anhängen und Lösen von Belegen sowie die Journalisierung von Transaktionen verändern die Buchhaltung. Wenn diese Tools über einen KI-Agenten verwendet werden, stellen Sie bitte sicher, dass vor der Ausführung immer eine menschliche Genehmigung erfolgt.

Sicherheit

Wo die Tokens gespeichert werden

Beim offiziellen Remote-MCP läuft die Authentifizierung vollständig auf der Serverseite ab. Die Autorisierung und der Token-Austausch werden als MCP-Tools bereitgestellt; es gibt keine Phase, in der der Nutzer access_token direkt in die Hand bekommt. Das heißt: MF-Tokens werden nie auf dem Gerät des Nutzers gespeichert.

Dieser Server speichert dagegen die Tokens auf Ihrem eigenen Gerät. Sie werden im Klartext in ~/.mf-full-mcp/tokens.json abgelegt (Verzeichnis 0700 / Datei 0600).

Das ist ein Trade-off. Dass die Tokens mehrerer juristischer Personen ohne erneute Authentifizierung vorgehalten werden können und dass abgelaufene automatisch erneuert und dann eine Weile unbeaufsichtigt bleiben können, funktioniert nur, weil die Refresh-Tokens lokal vorliegen. Anders ausgedrückt: Wenn diese Datei in falsche Hände gerät, erhält man Zugriff auf die Bücher aller gespeicherten Unternehmen.

Vor dieesem Hintergrund wird der folgende Umgang vorausgesetzt:

  • Nur auf einem persönlichen Gerät mit verschlüsseltem Datenträger verwenden. Nicht auf gemeinsan genutzten Geräten verwenden.

  • Nicht mehr benötigte Unternehmen mit remove_office löschen.

  • Die Speicherung im Schülsselbund des Betriebssystems ist eine künftige Aufgabe.

client_secret existert nicht

Durch die dynamische Client-Registrierung ist das Design so ausgelegt, dass keine geheimnen Schülssel aufbewahrt werden müsen. Weder in dieesem Repositori noch in der Umgebung des Nutzers wird ein client_secret abgelegt.

Haftungsausschluss

Diees Software ist inoffiziell und steht in keiner Verbindung zu 株式会社マネーフォーワード.

Ein Teil der von dieesem Server angeforderen Scopes kann **aufgrund von Spezifikationsändrungen seitens MF ohne Vorankündigung unbrauchbar werden.** In dieseem Fal funktionieren einige Funktinen wie der Belegbereich nicht mehr.

Aufgrund der Natur von Buchhaltungsdaten beachten Sie bei der Nutzung bitte die folgenden Punkte:

  • Für die Ergebnisse von Schreiboperatinen übernimmt der Autor keinerlei Haftung.

  • Bevor Sie das Tool mit echten Büchern verwenden, prüfen Sie die Funktinen mit einem Testunternehmen.

  • Bitte prüfen Sie selbst die Nutzungsbedingungen von マネーフォーワード, bevor Sie das Tool verwenden.

Diees Software wird unter der MIT-Lizenz bereitgestellt. Detals finden Sie in der LICENSE.

Verwandtes

Available Tools

29 tools
authenticateA

MFへのOAuth認証を開始する。返ってきたauthUrlをユーザーがブラウザで開き、事業者を選択して許可すると自動でトークンが保存される。完了確認はauth_status。

Inputs: label, extra_scopes.

auth_statusA

進行中の認証フローの状態を確認する(waiting/exchanging/done/error)。

Inputs: no named parameters.

list_officesA

保存済みトークン(事業者)の一覧とアクティブな接続先を表示する。

Inputs: no named parameters.

mfc_ca_currentOfficeB

事業者情報と会計期間を取得します。

Inputs: no named parameters.

mfc_ca_deleteJournalsA

仕訳を完全削除します(公式MCP未提供・帳簿書き込み。要ユーザー承認)。

Inputs: id (required).

mfc_ca_deleteVouchersA

仕訳と証憑の紐付けを解除します(証憑自体は孤立して残る。公式MCP未提供・要ユーザー承認)。

Inputs: journal_id (required), voucher_file_id (required).

mfc_ca_getAccountsC

勘定科目を取得します。

Inputs: available.

mfc_ca_getConnectedAccountsB

連携サービス(自動連携・手動管理とも)を取得します。

Inputs: no named parameters.

mfc_ca_getDepartmentsB

部門を取得します。

Inputs: available.

mfc_ca_getJournalByIdB

仕訳を1件取得します。

Inputs: id (required).

mfc_ca_getJournalsB

仕訳一覧を取得します。start_date または end_date のいずれかが必要。

Inputs: page, end_date, per_page, account_id, +3 more.

mfc_ca_getReportsTransitionBalanceSheetB

貸借対照表の推移表(月別)を取得します。

Inputs: type (required), end_month, fiscal_year, include_tax, +2 more.

mfc_ca_getReportsTransitionProfitLossC

損益計算書の推移表(月別)を取得します。

Inputs: type (required), end_month, fiscal_year, include_tax, +2 more.

mfc_ca_getReportsTrialBalanceBalanceSheetB

貸借対照表の試算表(累計)を取得します。

Inputs: end_date, end_month, start_date, fiscal_year, +4 more.

mfc_ca_getReportsTrialBalanceProfitLossC

損益計算書の試算表(累計)を取得します。

Inputs: end_date, end_month, start_date, fiscal_year, +4 more.

mfc_ca_getSubAccountsC

補助科目を取得します。

Inputs: available.

mfc_ca_getTaxesC

税区分を取得します。

Inputs: available.

mfc_ca_getTermSettingsA

会計年度設定(税込/税抜・課税方式等)を取得します。

Inputs: no named parameters.

mfc_ca_getTradePartnersC

取引先を取得します。

Inputs: available.

mfc_ca_getTransactionsB

連携サービスで収集された明細一覧を取得します(自動連携・手動とも)。

Inputs: end_date (required), start_date (required), page, side, +9 more.

mfc_ca_postJournalsB

仕訳を作成します(帳簿書き込み。要ユーザー承認)。

Inputs: journal (required).

mfc_ca_postTradePartnersB

取引先を作成します。

Inputs: trade_partner (required).

mfc_ca_postTransactionJournalizeA

明細から仕訳を作成します(帳簿書き込み。要ユーザー承認)。相手科目account_idのみ必須。貸借方向・口座側科目・税区分・invoice_kindはMFが自動補完。

Inputs: account_id (required), transaction_id (required), memo, tags, +7 more.

mfc_ca_postTransactionsA

手動管理の連携サービスに明細を作成します(要ユーザー承認)。

Inputs: transactions (required), connected_account_id (required).

mfc_ca_postVouchersA

証憑をアップロードし仕訳に添付します(公式MCP未提供・要ユーザー承認)。file_paths を渡せばローカルファイルを自動でbase64化する。journal_id 省略時は孤立証憑になる(後から仕訳に紐づける手段はない)ので原則指定すること。

Inputs: file_paths, journal_id, voucher_files.

mfc_ca_putJournalsA

仕訳を更新します(全置換API・帳簿書き込み。要ユーザー承認)。

Inputs: id (required), journal (required).

mf_full_infoB

このサーバーの設定情報(要求スコープ・コールバックポート等)を表示する。

Inputs: no named parameters.

remove_officeC

保存済みトークンを削除する。

Inputs: label (required).

use_officeA

このセッションのアクティブな接続先事業者を切り替える(プロセス内メモリのみ。他セッション/他ウィンドウには影響しない)。

Inputs: label (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 29 tools

    Disambiguation4/5

    Most tools have clear resource/action separation: journals, transactions, reports, master data, auth, and office management each have distinct targets. A few pairs like currentOffice vs list_offices or postJournals vs postTransactionJournalize have some boundary overlap, but the descriptions are precise enough to resolve most ambiguity.

    Naming Consistency3/5

    The dominant mfc_ca_get/post/put/delete + Resource pattern is readable and consistent within the core accounting tools. However, the server mixes styles: verbless mfc_ca_currentOffice, un-prefixed snake_case names like remove_office and list_offices, and bare verbs like authenticate.

    Tool Count2/5

    29 tools is a heavy surface and exceeds the 25+ threshold. Although the tools are grouped into clear subdomains such as journals, reports, master data, and auth, the high number of parallel getters and report variants creates meaningful selection overhead for agents.

    Completeness3/5

    Core workflows are well covered: authentication, office switching, journal CRUD, report retrieval, and master data reads are all present. Obvious gaps remain, however: trade partners have no update/delete, transactions have no update/delete, and vouchers lack list/get or an attach-orphan recovery path.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      An MCP server and Claude plugin that enables interaction with freee APIs for accounting, human resources, invoicing, and more. It provides secure OAuth 2.0 authentication and integrates detailed API reference skills to support tasks like creating invoices and managing company data through natural language.
      21,715 npm
      521
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that integrates with MoneyForward Cloud Invoice API v3 to automate the creation and management of quotes and invoices. It supports Japanese invoice system compliance, allowing users to handle partners, items, and billing through natural language.
      22
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An unofficial MCP server that integrates with the hokan Insurance CRM API v2 to manage customer data, schedules, and tasks. It also features specialized tools for Japanese insurance law compliance, including intent confirmation and regulatory check generation.
      -