Skip to main content
Glama
mf-accounting-voucher-mcp

mf-accounting-voucher-mcp

by solara-co-jp

mf-accounting-voucher-mcp

Es un servidor MCP local que complementa las funciones no compatibles con el servidor MCP oficial de マネーフォワード クラウド会計. Llama directamente a la API REST v3 y se utiliza junto con el MCP oficial (remoto).

Herramientas proporcionadas

Nombre de la herramienta

Función

Endpoint de la API

post_vouchers

Adjunta archivos de comprobante (PDF, imágenes) al asiento

POST /api/v3/vouchers

delete_voucher

Desvincula el comprobante

DELETE /api/v3/vouchers

delete_journal

Elimina el asiento (irreversible)

DELETE /api/v3/journals/{id}

Nota: No se ofrece la función de marcar los detalles vinculados como «excluidos» porque no existe en la API REST. La descarga de archivos de comprobante tampoco es compatible con la API. No se reimplementan las funciones ya proporcionadas por el MCP oficial (como getJournals).

El binario de los archivos de comprobante no pasa por el LLM. Este servidor (proceso de Node) recibe la ruta local del archivo, lo lee, lo convierte a base64 y lo envía a la API.

Related MCP server: money-forward-mcp-community

Configuración

1. Registrar la aplicación en el portal de aplicaciones

Cree una aplicación en el portal de aplicaciones de マネーフォワード y configure lo siguiente:

  • URI de redirección: http://127.0.0.1:53682/callback

  • Scopes:

    • mfc/accounting/voucher.write (registro y eliminación de comprobantes)

    • mfc/accounting/journal.write (registro, actualización y eliminación de asientos)

Anote el ID de cliente / secreto de cliente emitido.

2. Instalación y compilación

pnpm install && pnpm run build

3. Configuración de variables de entorno

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

Variable

Valor predeterminado

Uso

MF_CLIENT_ID / MF_CLIENT_SECRET

Ninguno (obligatorio)

Emitido en el portal de aplicaciones

MF_REDIRECT_PORT

53682

Puerto local para la devolución de llamada (callback)

MF_REDIRECT_URI

http://127.0.0.1:{PORT}/callback

URI de redirección

MF_TOKEN_PATH

~/.mf-accounting-voucher-mcp/tokens.json

Ubicación de almacenamiento del token

MF_MAX_FILE_MB

20

Límite por archivo (válvula de seguridad local)

MF_ALLOWED_EXT

.pdf,.jpg,.jpeg,.png

Extensiones permitidas (se pueden sobrescribir separadas por comas)

4. Autorización inicial

pnpm run auth

Se abrirá el navegador; inicie sesión en マネーフォワード y autorice. El token se guarda en ~/.mf-accounting-voucher-mcp/tokens.json (modo 600) y a partir de entonces se renueva automáticamente.

Registro en Claude Desktop / Cowork

Una vez registrado, el servidor MCP se inicia automáticamente al arrancar el cliente. No es necesario iniciarlo manualmente en el uso diario.

Recomendado: usar el llavero (no escribir el secreto en el archivo de configuración)

Solo la primera vez, registre las credenciales en el llavero de macOS:

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

En mcpServers de claude_desktop_config.json, registre el script de inicio (sustituya la ruta por la ubicación real de instalación):

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

La autorización OAuth inicial también se puede ejecutar mediante el script (sin necesidad de configurar variables de entorno):

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

Alternativa: escribir las variables de entorno directamente en el archivo de configuración

{
  "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": "(クライアントシークレット)"
      }
    }
  }
}

Tenga en cuenta que con este método el secreto queda en texto plano en el archivo de configuración.

Ejemplo de uso

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

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

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

El resultado de la adjunción se puede verificar obteniendo el asiento correspondiente con getJournalById del MCP oficial y comprobando que aparece en voucher_file_ids.

Notas

  • Consulte la especificación oficial /specs/vouchers para conocer los límites exactos de tipo, tamaño y número de archivos de MF (el límite de este servidor es una válvula de seguridad local)

  • El cambio de operador (oficina) se realiza volviendo a ejecutar pnpm run auth

  • delete_journal no se puede deshacer. El llamador (LLM) está diseñado para ejecutarlo solo después de obtener la confirmación explícita del usuario.

Available Tools

3 tools
delete_journalA

マネーフォワード クラウド会計の仕訳を削除する。この操作は元に戻せません。実行前に必ずユーザーの明示的な確認を取り、対象仕訳の内容(取引No・日付・金額・摘要)を提示してから呼び出すこと。

Inputs: id (required).

delete_voucherA

マネーフォワード クラウド会計の仕訳から証憑ファイルの添付を解除する(添付解除。ファイル自体の削除ではなく仕訳との紐付けを外す操作)。

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

post_vouchersA

マネーフォワード クラウド会計の仕訳に証憑ファイル(PDF・画像)を添付する。ファイルはローカルの絶対パスで指定し、サーバー側で読み込んでbase64送信する(ファイル内容はLLMを経由しない)。

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

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 3 tools

    Disambiguation3/5

    post_vouchers与delete_voucher都涉及証憑添付,前者是添付、后者是解除添付,边界清晰;但delete_voucher和delete_journal都含'delete'前缀,容易混淆,且语义上一个删除附件、一个删除仕訳本身,描述虽说明但名称上不够鲜明。整体可区分但有轻微重叠。

    Naming Consistency3/5

    工具名采用动词+名词的snake_case(post_vouchers, delete_voucher, delete_journal),但动词风格不一致:post是动作,delete重复使用,且voucher与journal概念不同但都涉及删除,名词部分略显混乱。整体模式可识别但不够统一。

    Tool Count3/5

    3个工具属于偏少但可接受的范围。对于会计凭证管理,可能预期有获取/查询工具,但当前仅有写入和删除操作,功能面较窄,工具数接近最低阈值。

    Completeness2/5

    缺少核心的获取/查询功能(如获取凭证列表、获取仕訳详情),也缺少更新操作。用户无法查看已存在的凭证或仕訳,仅能添加和删除,导致操作闭环不完整,代理将面临无法验证或修订的困境。

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Secure remote MCP for supported accounting workflows in authorized Money S3 companies.

      https://money-mcp.uctomost.sk/mcp
    • e-Boekhouden MCP server for ChatGPT, Claude and any AI agent: create invoice, book mutation, add relation, list open items and export ledger in your own e-Boekhouden account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to e-Boekhouden yourself; Cotlet does not store your password and you need no e-Boekhouden API key. About the official e-Boekhouden API: Yes. e-Boekhouden has a REST API with an OpenAPI description (checked 14 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/e-boekhouden-api-mcp-server

    • Headless API-first double-entry accounting & bookkeeping engine. 84 MCP tools over HTTP.

      https://api.craneledger.ai/mcp
    • Bokio MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, upload receipt, create journal entry and list unpaid invoices in your own Bokio account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Bokio yourself; Cotlet does not store your password and you need no Bokio API key. About the official Bokio API: Yes, Bokio has a public REST API for invoices, customers, journal entries, uploads and supplier invoices (checked 14 Oct 2026), but it depends on your price plan and on the kind of integration: a private integration token works for one company only, and a tool that serves several companies must be registered as a public integration with OAuth 2.0. Bokio publishes no MCP server of its own. Setup and FAQ: https://cotlet.dev/integrations/bokio-api-mcp-server

      https://cotlet.dev/mcp/v1/bokio

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables Claude Desktop to interact with freee accounting API for expense registration, transaction management, and receipt image processing.
      15
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Unofficial, community-maintained stdio MCP server for Money Forward ME that uses cookie-based authentication to retrieve accounts and assets from manual entry accounts.
      14
      36 npm
      9
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      An unofficial MCP server for Money Forward Cloud Accounting that extends the official beta MCP by enabling simultaneous connections to multiple businesses, attaching receipts and invoices to journal entries, and fully deleting journal entries.
      29
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Enables AI assistants to operate MoneyForward Cloud Invoice, Expense, and Accounting through their public APIs, exposing 56 tools for issuing invoices, filing expenses with receipt images, and posting journal entries.
      56
      8 npm
      MIT