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 を追加する
- 無料キー登録でアカウントを作る(ログインしなくても jp-corporate は月100回まで使えます/キーの管理は /dashboard/)
- 下の2行で MCP サーバーを追加する(jp-corporate:
https://jp-corporate.plugrail.dev/mcp/jp-calendar:https://jp-calendar.plugrail.dev/mcp) - 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 の営業日計算は月次の呼び出し上限がなく、登録なしで使えます(カード不要)。
プランの比較は料金のページにもまとめています。
質問
よくある質問
-
3段を1回の質問でまとめて頼めますか
できます。登録番号と支払日の条件を書いた文をそのまま渡せば、AI エージェントが jp-corporate と jp-calendar のツールを順に呼び出します。
-
法人番号が分からないときは
lookup_corporateをnameとprefectureで呼び出して候補を探し、最後に候補の法人番号で照会して確定します。 -
支払日が休日になるときは
add_business_daysが土日・日本の祝日を除外して営業日を返します。銀行休業日も除くならcalendar="banking"を、自社の休業日も除くならextra_closed_datesを指定します。
エラーが出たとき
よくあるエラーと対処
| 返ってくる内容 | 原因 | 対処 |
|---|---|---|
| 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 エージェントに渡してみてください。キー登録は後からでもできます。