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_idweggelassen, 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 buildBei 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 |
| OAuth-Authentifizierung starten (über |
| Status des laufenden Authentifizierungsvorgangs anzeigen |
| Gespeicherte Unternehmen und aktuelle Verbindung anzeigen |
| Verbindungsziel dieser Sitzung wechseln |
| Gespeichertes Token löschen |
| 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 |
| Beleg hochladen und an Journaleintrag anhängen (bei Angabe des Pfads einer lokalen Datei wird automatisch base64-kodiert) |
| Zuordnung von Journaleintrag und Beleg aufheben (der Beleg selbst bleibt isoliert erhalten) |
| Journaleintrag vollständig löschen |
Umgebungsvariablen
Variable | Standardwert | Beschreibung |
| Keine | Unternehmen für die Verbindung der Sitzung beim Start festlegen |
| Automatische Zuweisung | Port für den OAuth-Callback festlegen |
| 16 Buchhaltungs-Scopes | Angeforderte Scopes überschreiben |
|
| 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.putJournalsersetzt 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_officelö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
unofficial-official-mf-mcp-skil – Inoffizielles Skil, das einer KI die Nutzung des offiziellen MCP und die Eigenheiten der API beibringt.
[mfc
Available Tools
29 toolsauthenticateA
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
Scored across 29 tools
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.
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.
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.
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
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
MCP server for ABRA Flexi — accounting, contacts, stock and draft-checked invoice creation.
MCP server for Codat — companies, connections, invoices, bills and financial statements.
MCP server for Mekari Jurnal — company accounting, sales, purchases and customer/vendor creation.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceAn 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 npm521Apache 2.0
- AlicenseBqualityDmaintenanceAn 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.221MIT
- FlicenseNot gradedqualityDmaintenanceAn 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.-
- FlicenseAqualityCmaintenanceUnofficial MCP server for accessing and managing TimeTree calendar data, supporting events, memos, and comments via email/password authentication.6-