mf-accounting-voucher-mcp
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 |
| Adjunta archivos de comprobante (PDF, imágenes) al asiento |
|
| Desvincula el comprobante |
|
| Elimina el asiento (irreversible) |
|
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/callbackScopes:
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 build3. Configuración de variables de entorno
export MF_CLIENT_ID="(クライアントID)"
export MF_CLIENT_SECRET="(クライアントシークレット)"Variable | Valor predeterminado | Uso |
| Ninguno (obligatorio) | Emitido en el portal de aplicaciones |
|
| Puerto local para la devolución de llamada (callback) |
|
| URI de redirección |
|
| Ubicación de almacenamiento del token |
|
| Límite por archivo (válvula de seguridad local) |
|
| Extensiones permitidas (se pueden sobrescribir separadas por comas) |
4. Autorización inicial
pnpm run authSe 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 '(クライアントシークレット)' -UEn 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 authAlternativa: 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/voucherspara 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 authdelete_journalno 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 toolsdelete_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
Scored across 3 tools
post_vouchers与delete_voucher都涉及証憑添付,前者是添付、后者是解除添付,边界清晰;但delete_voucher和delete_journal都含'delete'前缀,容易混淆,且语义上一个删除附件、一个删除仕訳本身,描述虽说明但名称上不够鲜明。整体可区分但有轻微重叠。
工具名采用动词+名词的snake_case(post_vouchers, delete_voucher, delete_journal),但动词风格不一致:post是动作,delete重复使用,且voucher与journal概念不同但都涉及删除,名词部分略显混乱。整体模式可识别但不够统一。
3个工具属于偏少但可接受的范围。对于会计凭证管理,可能预期有获取/查询工具,但当前仅有写入和删除操作,功能面较窄,工具数接近最低阈值。
缺少核心的获取/查询功能(如获取凭证列表、获取仕訳详情),也缺少更新操作。用户无法查看已存在的凭证或仕訳,仅能添加和删除,导致操作闭环不完整,代理将面临无法验证或修订的困境。
Maintenance
Related MCP Connectors
Secure remote MCP for supported accounting workflows in authorized Money S3 companies.
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.
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
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Claude Desktop to interact with freee accounting API for expense registration, transaction management, and receipt image processing.151MIT
- AlicenseAqualityCmaintenanceUnofficial, community-maintained stdio MCP server for Money Forward ME that uses cookie-based authentication to retrieve accounts and assets from manual entry accounts.1436 npm9MIT
- AlicenseBqualityCmaintenanceAn 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.29MIT
- AlicenseCqualityCmaintenanceEnables 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.568 npmMIT