Claude楽楽精算連携ガイド — API連携とCSV連携の使い分け

楽楽精算にClaude用のMCPサーバーは見当たらない

楽楽精算の公式サイトには、Slack MCPサーバーのようなClaude向けの接続口の案内が見つかりませんでした。実際に選べる経路は、公式の自動仕訳・会計ソフト連携とAPI連携・外部サービス連携のページに載っているものです。

自社の状況からどの経路を選ぶか

会計ソフトの種類と、自動化したい範囲で分かれます。各ページの記載を突き合わせると、次のように切り分けられます。

一覧にない会計ソフトでも、公式ページには「連携用CSVファイルの作成ができる」「詳細は問い合わせ」とあります。CSV連携の対象は、一覧だけでは決まりません。

経路1: CSV連携で会計ソフトに繋ぐ

CSV連携に追加のAPI開発は要りません。会計ソフトごとにCSVのテンプレートがあり、対応先は勘定奉行シリーズ・弥生会計・PCAシリーズ・SMILE・SAPシリーズ・GRANDITなど、公式の一覧で30を超えます。

Claudeの出番は、手順4の前です。「この月の仕訳データで、金額が前月の同一勘定科目の平均から大きく外れている行を指摘して」のように確認の観点を具体的に渡します。転記ミスや異常値の見落としを減らせます。

件数や合計のように正確さが要る数値は、Claudeの指摘を起点にスプレッドシート側で検算する運用が安全です。会計ソフトに取り込んだ後の修正は手間がかかるので、月次決算前のチェックに組み込むと手戻りを減らせます。

導入事例のページには、日本商業開発が会計ソフトへの手入力をゼロにし、経理本部で月32時間、人事総務本部で50時間の作業時間を削減したという記載があります。これは仕訳の手入力が消えた分の数字で、Claudeによる確認工程を足した効果ではありません。

同じページには、マルホ発條工業の事例もあります。会計ソフトへの連携が柔軟にでき、システムから出力したデータの取り込みと、インターネットバンキングに対応した振込データの作成・インポートができるようになったという内容です。CSV連携の効果は、仕訳の取り込みだけでなく振込データの作成まで広がる場合があることが分かります。

同ページは、金額や取引内容の転記ミスが減る点も連携の利点に挙げています。手入力がなくなる分、Claudeに確認させる対象は「転記の誤り」より「申請内容そのものの異常」になります。

経路2: API連携オプションを契約して自動連携する

API連携オプションは別オプションの機能で、楽楽精算と利用者のシステムの間で仕訳データやマスタデータを自動連携します。公式ページには「ご利用の際はお客様にプログラムをご用意いただく必要がございます」とあり、エンドポイントやパラメータの仕様は公開ページに載っていません。仕様書の入手方法や費用は、楽楽精算の窓口への確認が必要です。

例外が、会計ソフト側に連携ツールが用意されている3製品です。

連携できる項目は会計システムによって異なり、各システム側の必要契約は各メーカーや販売店への確認が必要です。

別オプションの「楽楽コネクタ」を使うと、TKCの統合型会計情報システムFX5と、どっと原価NEOは、連携パターンが用意されているため開発なしで連携できます。ただし「楽楽コネクタオプション」と「API連携オプション」の両方の申し込みが必要です。公式ページに載っている連携先はこの2製品です。

自社の会計システムが載っていなければ、問い合わせで対応を確かめたうえで、通常のAPI連携オプションでの自社開発か、対応済み会計ソフトへの乗り換えを検討することになります。契約前に対応範囲を確認しておけば、契約後に「思っていた連携ができない」という事態を避けられます。

経路3: 会計ソフトの手前を埋める外部サービス連携

会計ソフトとの連携とは別に、申請データの入り口を自動化する連携が公式ページに3つ載っています。Claudeを使う前に、これらで済む作業がないかを確認できます。

外部サービス連携の導入事例としては、従業員51名のダイナミックマップ基盤株式会社の声が載っています。API連携機能で会計ソフトへの入力が必要なくなり、全国銀行協会フォーマットで振込データを自動作成できるようになった点が便利だったという内容です。

Amazonビジネス連携は、Amazonビジネスでのユーザー登録や承認フロー設定が不要で、楽楽精算のユーザー情報とフローをそのまま使えます。AI Travel自動連携は、出張手配をAI Travelに一本化することで、出張精算の工数と転記ミスによる差し戻しの工数を減らすとされています。

このページには、楽楽精算が提携している外部パートナーの総称である「ソリューションパートナー」として、RPA、電子帳簿保存法へのコンサルティング、アウトソーシング(BPO)の3分野も載っています。RPAは経費精算に関わる単純業務や定期業務を自動化するものとして紹介されており、Claudeに任せる前に、定型の繰り返し作業ならRPAで足りないかを見比べる材料になります。

Claude Codeで連携プログラムを実装する

API連携オプションの仕様書を入手したら、そのファイルをローカルに置き、Claude Codeに読ませて実装させる進め方になります。Claudeに渡す情報の一次ソースは、その仕様書だけです。

claude -p "楽楽精算のAPI仕様書(rakuraku-api-spec.pdf)を読み、
仕訳データを日次でPOSTするバッチスクリプトの雛形を書いて。
認証方式とエンドポイントは仕様書の記載に厳密に従うこと" \
  --tools "Read,Write" \
  --permission-mode acceptEdits

-p(非対話モード)と組み合わせるフラグは、v2.1.285のclaude --helpで次のように表示されます。

claude --help

  --allowedTools, --allowed-tools <tools...>
      Comma or space-separated list of tool names to allow (e.g. "Bash(git *)
      Edit")
  --json-schema <schema>                JSON Schema for structured output
                                        validation. Example:
                                        {"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}
  --max-budget-usd <amount>             Maximum dollar amount to spend on API
                                        calls (only works with --print)
  --output-format <format>              Output format (only works with --print):
                                        "text" (default), "json" (single
                                        result), or "stream-json" (realtime
                                        streaming) (choices: "text", "json",
                                        "stream-json")
  --tools <tools...>                    Specify the list of available tools from
                                        the built-in set. Use "" to disable all
                                        tools, "default" to use all tools, or
                                        specify tool names (e.g.
                                        "Bash,Edit,Read").

経理の連携では--tools "Read,Write"で使えるツールを2つに限ります。Bashがセッションから外れるので、雛形の生成中にシェルコマンドは走りません。

--allowedToolsは役割が違い、確認なしで実行してよいツールを指定するものです。ツールを制限する働きはなく、--allowedToolsに載せなくても、読み取り専用のコマンドやpermissions.allowで許可済みの操作は実行されることがあります。

--max-budget-usdは非対話モードでのAPI利用額の上限です。--json-schemaは--output-format jsonと併せて付けると、structured_outputに指定した形のJSONが入ります。CSVの異常行を一覧にして後続の処理に渡す用途に向きます。

会計データを扱う連携では、次の3点を実装レビューの観点に加えると事故を防ぎやすくなります。

• 冪等性: 同じ仕訳データを誤って2回送信しても、二重計上にならない設計か
• 失敗時の追跡: バッチの途中で失敗したとき、どこまで反映済みかを判別できるログが残るか
• 認証情報の管理: APIキーや証明書がリポジトリやログに残っていないか

Claude Codeが生成したスクリプトも、本番と切り離したテスト環境の小さいデータで動作を確かめてから本番に使います。金額の誤りがそのまま業務影響になる領域だからです。

よくあるつまずき

CSVのフォーマットが会計ソフトと合わない: CSVは会計ソフトごとにテンプレートが分かれているので、手順も「会計ソフトに合わせたCSVファイルを出力」する形です。汎用フォーマットのまま取り込むと、勘定科目コードや日付形式の違いで弾かれることが考えられます。

楽楽コネクタなら何でもつながると思い込む: 連携できるデータは、TKCのFX5とどっと原価NEOで一部異なります。ページにも「詳細はお問い合わせください」とあるので、自社が動かしたいデータが対象に入っているかを契約前に確かめます。

claude -p でスクリプトの雛形が保存されない: -p で起動したセッションの開始時の権限モードはManualで、確認が要るファイル書き込みは承認する人がいないため拒否されます。前節のコマンド例に--permission-mode acceptEditsを付けているのはそのためです。acceptEditsはファイルの書き込みを確認なしで許可します。

--permission-mode dontAskにすると、確認が要る呼び出しはすべて拒否されます。作業ディレクトリ内のファイル読み取りや読み取り専用のコマンドは確認なしで動くので、仕訳CSVを読ませて異常行を報告させるだけの用途なら、書き込みを許さないこの設定が合います。--allowedToolsに載せたツールやpermissions.allowで許可済みの操作は、dontAskでも動きます。読み取り専用のClaudeに、あらかじめ許可した限られた操作だけを任せる設計になります。

無人のバッチで「書けなかった」ことに気づくには、--output-format stream-jsonを付けます。拒否はpermission_deniedのシステムメッセージとして流れ、最終結果にはpermission_denialsとして一覧が入ります。

--permission-prompts none(v2.1.259以降)は、Agent SDKのcanUseToolコールバックや--permission-prompt-toolのように、承認を受け付ける側がある実行向けの指定です。応答を待たずに拒否させ、Claudeには承認者がいないので再試行しないよう伝えます。受け手のない-pでは元から拒否されるため、このフラグの効果は再試行を止める点にあります。

会計ソフトと連携する場合、CSV連携やAPI連携でClaudeに渡すのは仕訳データです。社外のClaudeに何を送ってよいかは、社内の情報取り扱い規程に沿って決めてから始めます。

まとめ

自社の会計ソフトが連携実績の一覧にあるか、勘定奉行・PCA・SMILE・FX5・どっと原価NEOのどれかを使っているかを最初に確認します。そのうえで、CSV連携で十分な段階ではClaudeをチェック工程に使い、自動連携が必要になったらAPI連携オプションの契約とClaude Codeでの実装を検討する、という順番が無理のない選択です。

会計・経費データのCSV分析はClaude CSV分析の使い方、Excel関数を使った集計はClaude Excel関数の書き方、SATORIなど公開APIを持つサービスとの連携実装はClaude SATORI連携ガイド、MCP対応サービスとの連携パターンはClaude Code MCP設定ガイドが参考になります。

よくある質問

API連携オプションの費用はいくらですか

公式のAPI連携・外部サービス連携のページには料金の記載がありません。金額は楽楽精算への問い合わせで確認します。