jp-corporate + jp-calendar 組み合わせ例

請求書の確認から支払日までを、2つの MCP でつなぐ

取引先の法人番号の確認から、インボイス登録番号の有効性の照合、営業日での支払日の決定までを、自前のスクリプトや API の組み合わせで実装せずに AI エージェントへ会話のまま任せる手順をまとめました。

流れ

3段でつなぐ

①

法人番号を確認する

jp-corporate の lookup_corporate で、13桁の法人番号から取引先の正式名称・所在地を確定します。

②

登録番号を照合する

同じく jp-corporate の verify_invoice_number で、T+13桁の登録番号の登録・取消・失効を日付つきで確かめます。

③

支払日を営業日で決める

jp-calendar の add_business_days で、締め日から営業日を数えて支払日を出します。

各段のツール

各段で呼ぶツールと入力例

① 法人番号を確定する(lookup_corporate)

lookup_corporate にハイフンなし13桁の corporateNumber を渡します。正式名称・所在地と、閉鎖の有無が返ります。番号が分からないときは name と prefecture で候補を探し、最後に候補の法人番号で照会して確定します。

例:lookup_corporate {"corporateNumber": "1180301018771"}

② 登録番号を照合する(verify_invoice_number)

verify_invoice_number に invoiceNumber を渡します。T+13桁で指定してください。登録・取消・失効が日付つきで返ります。見つからない番号は、取り込んだデータに無いことを示すだけで、番号が存在しないとは断定しません。

例:verify_invoice_number {"invoiceNumber": "T1180301018771"}

③ 支払日を営業日で決める(add_business_days)

add_business_days に起点日 date と営業日数 days を渡します。起点日当日は数えず、翌日から数えます。例では 2026-07-10(金)の3営業日後は 2026-07-15(水)です。calendar="banking" を指定すると 12/31〜1/3 の銀行休業日も除外できます。月末が休日に当たるときの寄せ方は営業日 計算 API のページにまとめています。

例:add_business_days {"date": "2026-07-10", "days": 3}

lookup_corporate       {"corporateNumber": "1180301018771"}
verify_invoice_number  {"invoiceNumber": "T1180301018771"}
add_business_days      {"date": "2026-07-10", "days": 3}

①と②は jp-corporate、③は jp-calendar の MCP 接続から呼び出します。ツールの詳しい引数や制約は法人番号 API 無料のページ、インボイス 登録番号 API のページ、営業日 計算 API のページにまとめています。

つなぎ方

2つの MCP を追加する

  1. 無料キー登録でアカウントを作る(ログインしなくても jp-corporate は月100回まで使えます/キーの管理は /dashboard/)
  2. 下の2行で MCP サーバーを追加する(jp-corporate: https://jp-corporate.plugrail.dev/mcp/jp-calendar: https://jp-calendar.plugrail.dev/mcp)
  3. AI エージェントに下の「AI への頼み方」の文で頼む

Claude Code の場合は、ターミナルで次の2コマンドを実行します。

claude mcp add --transport http jp-corporate https://jp-corporate.plugrail.dev/mcp
claude mcp add --transport http jp-calendar https://jp-calendar.plugrail.dev/mcp

AI への頼み方

会話のまま、3段まとめて頼む

次のように頼むと、AI エージェントは3段のツールを順に呼び出して結果をまとめられます。

① 「T から始まる番号 T1234567890123 の取引先の登録を確かめて、今月末締め翌月末払いの支払日を営業日で出して」
② 「法人番号 1180301018771 の正式名称と所在地を確認して、T1180301018771 の登録番号も照合して」
③ 「2026-07-10 の3営業日後を、12/31〜1/3 も銀行休業日として除いて教えて」

ツールの返答には出典が付きます。重要な判断では、出典元の一次情報も確かめてください。

料金と上限

無料ではじめる

匿名・無料アカウントとも月100回まで無料です(暦月・日本時間、カード不要)。回数は日本時間の毎月1日にリセットされます。数えるのはツールの呼び出し(tools/call)だけです。limit で20件取得しても、回数は1回です。

  • 短時間の集中利用には分あたりの上限があります(ログインなしは1分あたり10回、無料アカウントは60回)。
  • プロは月次の回数制限がなく、毎分600回まで使えます(月額9,800円・税込)。
  • SLA は設けていません。

jp-calendar の営業日計算は月次の呼び出し上限がなく、登録なしで使えます(カード不要)。

プランの比較は料金のページにもまとめています。

質問

よくある質問

エラーが出たとき

よくあるエラーと対処

返ってくる内容 原因 対処
HTTP 401「認証に失敗しました。」 APIキーの形式が違うか、失効している 管理画面でキーを確かめ、Authorization: Bearer <キー> で送り直す。キーなしでも月100回までは使える
HTTP 429「レート制限を超過しました。」 1分あたりの上限(ログインなし10回・無料60回・プロ600回)に達した 返ってきた Retry-After の秒数だけ待って再試行する
「今月の無料枠(100回)を超えました。」 日本時間の今月、ツール呼び出しが100回を超えた 翌月1日に回数が戻る。続けて使うならプロ(月額9,800円・税込)へ
invalid_input 番号の桁が足りないなど、入力の形が違う ページ上部の入力例の形に合わせる

まず動くか確かめる(curl)

curl -s https://jp-corporate.plugrail.dev/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ツールの一覧が返れば接続はできています。

次の一歩

まず1件、つなげて聞いてみる

手元の登録番号と締め日を1件、AI エージェントに渡してみてください。キー登録は後からでもできます。