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

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: freee-chat-mcp-server

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="（クライアントシークレット）"

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.