BoomTax

BoomTax MCP サーバー

Claude、ChatGPT、Codex、Cursor、Windsurf、VS Code Copilot、その他の Model Context Protocol クライアント向けの、読み取り専用の BoomTax 申告ツールです。

ホスト型エンドポイントは https://api.boomtax.com/mcp で、Streamable HTTP と OAuth を使用します。BoomTax アカウントで API アクセスを有効にする必要があります。必要に応じて [email protected] までお問い合わせください。

リリース状況（2026 年 10 月 9 日）：ホスト型 API の更新はデプロイ済みで、リモートサーバーは公式 MCP Registry に io.github.boomtax/mcp-server、バージョン 2.0.0 として公開されています。npm 2.0.0 クライアントはまだ公開されていません。npm 1.0.0 は従来のパスワード認証を使用します。リモート接続を使用するか、このソースツリーからローカルクライアントを実行してください。クライアントの検証と残りの公開作業については、リリースの検証をご覧ください。

ツール

ツール	説明
list_filings	年、フォームの種類、ステータスで申告を絞り込みます。申告システムも含みます
get_filing_details	申告の詳細、支払者の概要、電子申告のステータス
get_filing_summary	ステータスとフォームの種類ごとの件数
list_filing_forms	申告内のページ分割されたフォームメタデータ
get_form	フォームのメタデータ、ステータス、日付
get_efile_status	電子申告リクエストと応答のタイムライン
get_efile_errors	電子申告のエラーとメッセージ
list_payers	アクセス可能な申告全体の支払者
get_payer	マスキングされた支払者の TIN を含む、支払者の詳細
list_filing_types	利用可能な申告の種類、税年度、申告システム

これらのツールでは、申告の作成、編集、削除、送信はできません。ローカルクライアントは、この 10 個のツールをホスト型サービスに転送し、それ以外のツール名はブロックします。税年度ごとに古くなる可能性がある静的なリストではなく、最新のフォーム提供状況を確認するには list_filing_types を使用してください。

セットアップ

リモート接続（推奨）

Streamable HTTP と PKCE を使った OAuth に対応するクライアントで、https://api.boomtax.com/mcp を使用してください。求められたら、ブラウザーでサインインを完了します。OAuth クライアントの登録には Dynamic Client Registration（DCR）を使用します。クライアントで DCR と公開済みのクライアント ID のどちらかを選べる場合は、自動登録を選択してください。Client ID Metadata Documents（CIMD）は現在サポートされていません。

検出エンドポイント：

• https://api.boomtax.com/.well-known/oauth-protected-resource
• https://api.boomtax.com/.well-known/oauth-authorization-server

認証せずに /mcp を開いたときの 401 応答は想定どおりです。この応答には WWW-Authenticate 検出ヘッダーが含まれます。ブラウザーで URL を直接開いても、認証済み接続のテストにはなりません。

ローカルクライアント（バージョン 2）

Node.js 22 以降が必要です。BoomTax API 認証情報で読み取り専用の API 認証情報を作成します。値は、クライアントのシークレットストレージまたは環境変数を使って渡してください。

変数	必須	用途
BOOMTAX_CLIENT_ID	はい	API 認証情報のクライアント ID
BOOMTAX_CLIENT_SECRET	はい	API 認証情報のシークレット
BOOMTAX_API_URL	いいえ	デフォルトは https://api.boomtax.com です。/mcp ではなくオリジンを指定してください

クライアントは有効期間の短い OAuth トークンを取得し、トークンの期限が切れると再認証します。アカウントのメールアドレスとパスワードは使用しません。HTTP が許可されるのは、開発用のループバックサーバーに限られます。それ以外のオリジンでは HTTPS が必要です。

これらの環境変数を設定した後、ソース版を実行します。

git clone https://github.com/boomtax/mcp-server.git
cd mcp-server
npm ci
node index.js

2.0.0 が公開された後は、同等のパッケージコマンドを使用できます。

npx -y @boomtax/[email protected]

Windows で npx を直接起動できないクライアントでは、cmd /c npx -y @boomtax/[email protected] を使用するか、インストール済みクライアントを node で起動し、index.js の絶対パスを指定できます。

AI クライアントごとの設定

Claude Desktop と Claude web

リモート接続するには、Connectors を開き、カスタムコネクターを追加して https://api.boomtax.com/mcp を入力します。OAuth クライアントの自動登録を選択し、サインインを完了します。組織アカウントでは、管理者が先にコネクターを追加する必要がある場合があります。リモートコネクターはコネクターの UI から設定します。claude_desktop_config.json に URL のみを入力する方法では設定できません。

Claude Desktop でローカルソースをインストールするには、絶対パスを使用し、2 つの認証情報環境変数を安全に渡します。

{
  "mcpServers": {
    "boomtax": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"],
      "env": {
        "BOOMTAX_CLIENT_ID": "YOUR_READ_SCOPED_CLIENT_ID",
        "BOOMTAX_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

シークレットを含むファイルは、ソース管理の対象外にしてください。Windows のパスを JSON に記述する場合は、バックスラッシュを 2 つ重ねるか、スラッシュを使用してください。

Claude Code

claude mcp add boomtax --transport http https://api.boomtax.com/mcp

Claude Code で /mcp を使用して認証を完了してください。

ChatGPT

カスタム MCP 接続が許可されているワークスペースで、URL https://api.boomtax.com/mcp を指定してカスタムコネクターまたはプラグインを追加し、OAuth とクライアントの自動登録を選択してサインインを完了します。利用可能な機能や正確な UI は、ワークスペースの管理設定によって異なります。事前登録済みの OAuth クライアントを求められた場合は、BoomTax サポートにお問い合わせください。マシン間 API 認証情報は、認可コード用のクライアント登録ではありません。

Codex

codex mcp add boomtax --url https://api.boomtax.com/mcp
codex mcp login boomtax

Codex は、ホスト型サーバーの OAuth ディスカバリーメタデータを使用します。ローカルの stdio クライアントでは、上記のソースパスを指定して node を実行し、環境から BOOMTAX_CLIENT_ID と BOOMTAX_CLIENT_SECRET を継承することもできます。

Cursor と Windsurf

このリモートサーバーをクライアントの MCP 設定に追加し、OAuth サインインを完了します。

{
  "mcpServers": {
    "boomtax": {
      "url": "https://api.boomtax.com/mcp"
    }
  }
}

Cursor では .cursor/mcp.json を使用します。Windsurf または Devin Desktop では、MCP 設定の Open MCP config file アクションを使用して、インストール済みのバージョンに対応する設定ファイルを選択します。クライアントのバージョンがリモートサーバーの OAuth に対応していない場合は、代わりにローカルソースの設定を使用してください。

VS Code / GitHub Copilot

.vscode/mcp.json に追加します。

{
  "servers": {
    "boomtax": {
      "type": "http",
      "url": "https://api.boomtax.com/mcp"
    }
  }
}

VS Code の MCP コントロールからサーバーを起動し、OAuth サインインを完了します。この設定にアカウントのシークレットは含まれません。

プロンプトの例

• 「2025 年の課税年度について、どの申告書がありますか？」
• 「申告書をステータス別に要約してください。」
• 「この申告書の電子申告ステータスは何ですか？」
• 「1099-NEC 申告書のエラーを表示してください。」
• 「利用可能な申告書の種類と課税年度を教えてください。」

セキュリティとトラブルシューティング

• データへのアクセスは、認証されたアカウントとその申告権限の範囲に限定されます。
• 構造化された支払者 TIN フィールドは、ホスト型サービスによってマスキングされます。結果には引き続き、機密性のある氏名、連絡先情報、申告情報が含まれます。権限のあるアシスタントとのみ共有してください。
• ローカル統合ごとに、読み取り専用の API 認証情報を別々に使用し、不要になったら BoomTax で失効させてください。
• 認証情報はローカルクライアントのメモリに保持されます。設定された API 発行者に OAuth ディスカバリーを固定し、上流エラーの本文や認証情報はログに記録しません。
• ローカルでの起動失敗は通常、クライアント認証情報の不足、API アクセスの無効化、または API に到達できないことが原因です。BOOMTAX_API_USERNAME / BOOMTAX_API_PASSWORD は指定しないでください。これらのバージョン 1 の設定は廃止されています。
• invalid_redirect_uri 登録エラーには、対応しているコールバックホスト、またはサポートによる登録が必要です。認証情報を別のホストに送信して回避しようとしないでください。
• ディレクトリのヘルスチェックには、承認済みのテスト接続が必要です。テスト用プロフィールがない場合、OAuth ディスカバリーに到達できても、バッジが異常を示すことがあります。

開発

npm ci
npm test
npm run check
npm pack --dry-run

テストでは、ループバック OAuth/MCP フィクスチャと、実際の stdio クライアントプロセスを含む合成データを使用します。顧客アカウントには接続しません。公開の前提条件と検証については、リリースとディレクトリのメンテナンスを参照してください。

ライセンス

このリポジトリ内のローカルクライアントソースは MIT ライセンスです。ホスト型 BoomTax サービスへのアクセスには、引き続き BoomTax のサービス利用規約とアカウント権限が適用されます。