Claude Media
ClaudeとAiwyn Taxを連携する方法 — 認証不要で米国の税額を試算
ClaudeClaude連携MCPチュートリアル

ClaudeとAiwyn Taxを連携する方法 — 認証不要で米国の税額を試算

Aiwyn Taxの税計算MCPサーバーをClaudeに接続する手順です。認証不要の接続先、W-2から連邦・州税を試算してPDFを出す流れ、ツールの役割、入力ルールの落とし穴をまとめます。

読了目安 約8分

Claude Aiwyn Tax連携とは何か

Aiwyn Tax連携は、米国の税計算エンジンを提供するAiwynのMCPサーバーをClaudeにつなぐ仕組みです。W-2などの内容を渡すと、連邦税と州税を試算し、1040のPDFまで受け取れます。

Connectorsディレクトリでは、開発元Aiwyn, Inc.の「Anthropic verified」表示付きで掲載されています。旧称はColumn Taxで、カテゴリは金融サービス、追加時期は2026年3月です。サインインは不要で、接続先のURLは https://mcp.columnapi.com/mcp です。

対象は米国の連邦税(IRSの様式)と州税です。日本の確定申告や所得税には使えません。日本の申告書類をClaudeで整理したい場合は、特定口座の年間取引報告書を整理する手順のような別のやり方になります。

Connector全般の仕組みはClaudeコネクタの解説にまとめています。

接続前に確認する条件

ここで押さえる条件は3つです。

  • 認証がない: ログインもAPIキーも要らないため、接続の手間は小さい
  • 対応範囲: 連邦と43の州の管轄(ドキュメントの表記は「43 state jurisdictions」)
  • 州は1回の計算につき1つ: 連邦だけの計算か、連邦と1つの州を束ねた計算になる

認証がないことは、導入のしやすさと引き換えに注意点も生みます。ドキュメントには、入力した税務データの保持期間や、PDFのダウンロードURLの有効期限に関する記載がありません。社会保障番号(SSN)を含む実在の申告データを渡す前に、提供元のプライバシーポリシーを確認してください。試し方としては、架空の数値で一度流してみるのが無難です。

Claudeに接続する手順

認証が不要なので、接続は「追加して有効にする」だけで終わります。

claude.aiとClaude Desktopから追加する

ディレクトリのAiwyn Taxの詳細ページで「Add to Claude」を押します。ログイン画面は挟まりません。追加後は、会話ごとにメッセージ欄の「+」から「Connectors」を開き、Aiwyn Taxをオンにします。

Claude Codeから追加する

Claude Codeでは claude mcp add で登録します。次のコマンドは、公式のコネクタURLをHTTPトランスポートで指定した形です。

claude mcp add --transport http aiwyn-tax \
  https://mcp.columnapi.com/mcp

登録後に claude mcp list で接続状態を確かめられます。認証の手順が要らないぶん、失敗するならURLの打ち間違いか、サーバー側の一時的な不調が疑わしくなります。

税額を試算するまでの流れ

提供元が示す推奨手順は6段階です。Claudeはこの順にツールを呼びます。

手順

試算からPDF出力までの6段階

  1. 1

    tax_simple_return

    最初に呼びます。シナリオ(simple または with_dependents)に合う名前空間の一覧、入力の骨組み、例のJSON、手順の案内が返ります。

  2. 2

    tax_namespace_schema

    必要な名前空間ごとにJSONスキーマを取得します。並列で呼べます。

  3. 3

    入力の組み立て

    スキーマと入力ルールに沿って、JSONの入力を作ります。

  4. 4

    check_tax

    計算前の検証です。入力エラーと、一部が適用外になる「部分的な失格」を拾います。

  5. 5

    calculate_tax

    申告全体を計算し、計算結果をMarkdownで返します。

  6. 6

    generate_tax_pdf_tool と get_tax_pdf_tool

    PDF生成を非同期で開始してジョブIDを受け取り、完了するまでIDで状態を確かめます。完了するとダウンロードURLが返ります。

たとえば「独身でW-2収入のみ。TY25の連邦とアリゾナ州を申告する」と伝えると、提供元の例では tax_simple_return を scenario="simple"、jurisdiction="az"、tax_year="TY25" で呼ぶところから始まります。ここから先のJSONはClaudeが組み立てるので、自分で書く必要はありません。

扶養家族や控除が絡むなら、シナリオは with_dependents を指します。提供元の例では、育児費用の様式(Form 2441)や教育控除の様式(Form 8863)に当たる名前空間が追加されます。

9つのツールの役割

ディレクトリに載るツールは9つです。役割で分けると次のとおりです。

分類ツール役割
調べるツールtax_years役割対応する課税年度の一覧
調べるツールtax_jurisdictions役割課税年度ごとの対応管轄
調べるツールtax_namespaces役割管轄ごとの入力名前空間
調べるツールtax_namespace_schema役割名前空間1つのJSONスキーマ
調べるツールtax_simple_return役割シナリオ別の骨組みと手順
計算するツールcheck_tax役割入力の検証
計算するツールcalculate_tax役割税額の計算
出力するツールgenerate_tax_pdf_tool役割PDF生成の開始
補助ツールgenerate_uuid_v5役割州の拡張項目に使うUUIDv5の生成

読み取り専用か書き込みありか、という区分は公式の説明にありません。ただしツールの内容を見る限り、外部のアカウントを変更する種類のものは並んでいません。入力を渡して結果を受け取る計算型のコネクタです。

ドキュメントとディレクトリで食い違うところ

開発元のドキュメントには、PDFの状態を確かめる get_tax_pdf_tool も載っています。ドキュメント上のツールは合計10個です。一方、Connectorsディレクトリの一覧は、このツールを除いた9つです。

読み方としては、ディレクトリの一覧が古いか、一部が省かれている可能性があります。PDFのジョブIDを受け取るだけで終わる場合は、Claudeが完了確認のツールを呼べているかを会話の中で見てください。ツール名はドキュメントに揃えてあるので、指示で名指しすることもできます。

入力ルールで失敗しやすい点

ドキュメントの入力ルールは、Claudeが組み立てるJSONの質を左右します。次の項目は、結果がずれても気づきにくい種類です。

入力ルール

入力を作らせるときの注意点

  • 値は必ず包む

    すべての項目の値は {"value": ...} の形にします。裸の値は渡せません。

  • 金額は整数ドル

    通貨は整数のドル単位です。$19,312.42 は 19312 と書きます。端数の扱いは自分で見直します。

  • 配列の項目にはUUID

    w2 のような配列の名前空間では、項目ごとにUUIDv4が必要です。入れ子の配列にも要ります。

  • 州の拡張はUUIDv5

    州の名前空間が連邦の配列を拡張するときは、generate_uuid_v5 で作ったUUIDv5を使います。照合は順番ではなくUUIDで行われます。

最後の項目は特に注意が要ります。ドキュメントは、UUIDを誤ると「silent data loss」(エラーを出さずにデータが抜ける)になると明記しています。州のW-2情報が反映されていないのに、計算は成功してしまう形です。

SSNとEINは9桁の数字で、ダッシュは入れません。日付は YYYY-MM-DD です。return_header は return_data の中ではなく、最上位のキーに置きます。

check_taxを先に見せる指示で入力の誤りを止める

試算結果を受け取ったら、Claudeに次の点を答えさせると、抜けを見つけやすくなります。

check_taxの結果を先に見せてください。
部分的な失格が出ていれば、どの項目が対象かを挙げてください。
州の拡張項目は、連邦のどの項目とUUIDで対応させましたか。

check_tax は計算の前の検証で、calculate_tax とは別のツールです。検証が通ってから計算に進む順序を、指示の中で明示すると、入力の誤りがPDFまで流れる事態を避けられます。

また、計算結果は試算です。提出用の申告書として使うかどうかは、税務の専門家や申告ソフトでの確認を前提に考えるのが妥当です。このコネクタが提供するのはAiwynの税エンジンによる計算とPDFの生成で、IRSへの電子申告(e-file)に当たるツールは一覧にありません。

同じ金融サービスのカテゴリで、決済データを扱う場合はClaude Stripe連携が参考になります。認証が必要な点で、このコネクタとは性格が違います。

使えない・つまずくときの切り分け

接続できない、または結果が空になるときは、次の順に見ます。

切り分け

Aiwyn Taxが動かないときの切り分け

  1. Q会話でAiwyn Taxがオンになっていますか?
    答えがいいえのとき

    メッセージ欄の「+」から「Connectors」を開き、Aiwyn Taxをオンにします。

    答えがはい
  2. Q対象の課税年度と管轄が対応していますか?
    答えがいいえのとき

    tax_years と tax_jurisdictions を呼ばせて、対応の有無を確かめます。

    答えがはい
  3. Qcheck_taxはエラーなしで通りましたか?
    答えがいいえのとき

    エラーの項目を直してから、もう一度 check_tax を通します。

    答えがはい

計算とPDF生成に進める

calculate_tax の結果を確かめたうえで、generate_tax_pdf_tool に進みます。

向いている使い方、向かない使い方

米国の税務をClaudeで下調べする場面には合います。W-2の内容から還付額か納付額かの目安を出す、扶養家族や控除が結果にどう効くかを見比べる、といった使い方です。

向かないのは、日本の税務と、実在する本番の申告そのものです。後者は、保持期間などの条件がドキュメントにないためです。

まとめ

Aiwyn Tax連携の特徴は、認証不要で米国の連邦税と州税を試算し、PDFまで出せる点です。手軽さの裏で、入力のUUIDを誤るとデータが黙って抜ける仕様がある点と、ディレクトリとドキュメントでツール数が1つずれている点を押さえておくと、結果の確認が楽になります。

この記事を共有:XはてブLinkedIn

関連する記事

Claude をもっと見る →