mf-accounting-voucher-mcp

Ein lokaler MCP-Server, der Funktionen ergänzt, die der offizielle MCP-Server von Money Forward Cloud Accounting nicht unterstützt. Er ruft die REST-API v3 direkt auf und wird zusammen mit dem offiziellen MCP (Remote) verwendet.

Bereitgestellte Tools

Hinweis: Die Markierung von Verknüpfungsdetails als „nicht relevant" existiert in der REST-API nicht und wird daher nicht bereitgestellt. Auch der Download von Belegdateien wird von der API nicht unterstützt. Bereits vom offiziellen MCP bereitgestellte Funktionen (z. B. getJournals) werden nicht neu implementiert.

Die Binärdaten der Belegdateien durchlaufen nicht das LLM. Dieser Server (Node-Prozess) empfängt lokale Dateipfade, liest sie, kodiert sie in base64 und sendet sie an die API.

Related MCP server: freee-chat-mcp-server

Einrichtung

1. App im App-Portal registrieren

Erstellen Sie im App-Portal von Money Forward eine App und konfigurieren Sie Folgendes:

• Redirect-URI: http://127.0.0.1:53682/callback

• Scopes:

  • mfc/accounting/voucher.write (Registrieren und Löschen von Belegen)

  • mfc/accounting/journal.write (Registrieren, Aktualisieren und Löschen von Buchungen)

Notieren Sie die ausgestellte Client-ID / das Client-Secret.

2. Installation und Build

pnpm install && pnpm run build

3. Umgebungsvariablen konfigurieren

export MF_CLIENT_ID="（クライアントID）"
export MF_CLIENT_SECRET="（クライアントシークレット）"

4. Erstmalige Autorisierung

pnpm run auth

Ein Browser öffnet sich; melden Sie sich bei Money Forward an und autorisieren Sie. Das Token wird unter ~/.mf-accounting-voucher-mcp/tokens.json (Modus 600) gespeichert und danach automatisch aktualisiert.

Registrierung in Claude Desktop / Cowork

Nach der einmaligen Registrierung startet der MCP-Server automatisch beim Start des Clients. Ein manueller Start im Alltag ist nicht erforderlich.

Empfohlen: Schlüsselbund verwenden (Secret nicht in die Konfigurationsdatei schreiben)

Nur beim ersten Mal werden die Anmeldedaten im macOS-Schlüsselbund registriert:

security add-generic-password -s mf-accounting-voucher-mcp -a client_id -w '（クライアントID）' -U
security add-generic-password -s mf-accounting-voucher-mcp -a client_secret -w '（クライアントシークレット）' -U

In mcpServers der claude_desktop_config.json wird das Startskript registriert (ersetzen Sie den Pfad durch den tatsächlichen Installationsort):

{
  "mcpServers": {
    "mf-accounting-voucher-mcp": {
      "command": "/path/to/mf-accounting-voucher-mcp/scripts/mf-accounting-voucher-mcp.sh",
      "args": []
    }
  }
}

Auch die erstmalige OAuth-Autorisierung kann über das Skript ausgeführt werden (keine Konfiguration von Umgebungsvariablen erforderlich):

scripts/mf-accounting-voucher-mcp.sh auth

Alternative: Umgebungsvariablen direkt in die Konfigurationsdatei schreiben

{
  "mcpServers": {
    "mf-accounting-voucher-mcp": {
      "command": "node",
      "args": ["/path/to/mf-accounting-voucher-mcp/dist/index.js"],
      "env": {
        "MF_CLIENT_ID": "（クライアントID）",
        "MF_CLIENT_SECRET": "（クライアントシークレット）"
      }
    }
  }
}

Beachten Sie, dass bei dieser Methode das Secret im Klartext in der Konfigurationsdatei verbleibt.

Verwendungsbeispiel

「この領収書（/Users/xxx/Downloads/receipt.pdf）を仕訳 XXXX に添付して」
→ post_vouchers が呼ばれ、添付結果（voucher_file_ids）が返る

「仕訳 XXXX の証憑 a60cd25d-... の添付を解除して」
→ delete_voucher

「仕訳 XXXX を削除して」
→ delete_journal（実行前に仕訳内容の提示と明示的な確認が入る）

Das Anhängeergebnis kann verifiziert werden, indem die betreffende Buchung mit getJournalById des offiziellen MCP abgerufen und geprüft wird, ob sie in voucher_file_ids enthalten ist.

Hinweise

• Die genauen Beschränkungen von MF für Dateityp, -größe und -anzahl finden Sie in der offiziellen Spezifikation /specs/vouchers (die Obergrenze dieses Servers ist eine lokale Sicherheitsmaßnahme)

• Der Wechsel des Unternehmens (Office) erfolgt durch erneutes Ausführen von pnpm run auth

• delete_journal kann nicht rückgängig gemacht werden. Der Aufrufer (LLM) ist so ausgelegt, dass er erst nach ausdrücklicher Bestätigung durch den Benutzer ausgeführt wird.