mf-accounting-voucher-mcp

Локальный MCP-сервер, дополняющий функции, которые не поддерживает официальный MCP-сервер Money Forward Cloud Accounting. Напрямую вызывает REST API v3 и используется совместно с официальным MCP (удалённым).

Предоставляемые инструменты

Примечание: перевод деталей интеграции в статус «вне объекта» не предусмотрен, поскольку такой функции в REST API нет. Скачивание файлов-документов также не поддерживается API. Функции, уже предоставляемые официальным MCP (например, getJournals), повторно не реализуются.

Бинарные данные файлов-документов не проходят через LLM. Этот сервер (Node-процесс) принимает локальный путь к файлу, считывает его, преобразует в base64 и отправляет в API.

Related MCP server: freee-chat-mcp-server

Настройка

1. Зарегистрируйте приложение на портале приложений

Создайте приложение на портале приложений Money Forward и задайте следующие параметры.

• URI перенаправления: http://127.0.0.1:53682/callback

• Области (scopes):

  • mfc/accounting/voucher.write (регистрация и удаление документов)

  • mfc/accounting/journal.write (регистрация, обновление и удаление проводок)

Запишите выданные идентификатор клиента / секрет клиента.

2. Установка и сборка

pnpm install && pnpm run build

3. Настройка переменных окружения

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

4. Первичная авторизация

pnpm run auth

Откроется браузер — войдите в Money Forward и авторизуйте приложение. Токен сохраняется в ~/.mf-accounting-voucher-mcp/tokens.json (режим 600) и в дальнейшем обновляется автоматически.

Регистрация в Claude Desktop / Cowork

После однократной регистрации MCP-сервер запускается автоматически при старте клиента. Ежедневный ручной запуск не требуется.

Рекомендуемый способ: использование связки ключей (без записи секрета в файл конфигурации)

Только при первом запуске зарегистрируйте учётные данные в связке ключей 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

В mcpServers файла claude_desktop_config.json зарегистрируйте скрипт запуска (замените путь на фактическое место установки):

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

Первичную OAuth-авторизацию также можно выполнить через скрипт (без настройки переменных окружения):

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

Альтернативный способ: запись переменных окружения непосредственно в файл конфигурации

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

Обратите внимание: при таком способе секрет остаётся в файле конфигурации в открытом виде.

Пример использования

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

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

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

Результат прикрепления можно проверить, получив соответствующую проводку через getJournalById официального MCP и убедившись, что она отражена в voucher_file_ids.

Примечания

• Точные ограничения Money Forward по типу, размеру и количеству файлов см. в официальной спецификации /specs/vouchers (ограничения данного сервера — это локальный предохранитель)

• Переключение организации (офиса) выполняется повторным запуском pnpm run auth

• delete_journal нельзя отменить. Вызывающая сторона (LLM) спроектирована так, чтобы выполнять удаление только после явного подтверждения пользователя.