Avalara Developer Documentation

Avalara

これは Avalara が作成・保守している非コミュニティのリポジトリです

---

Avalara MCP サーバー

MCP（Model Context Protocol） サーバーは、AI アプリケーションを Avalara の税務コンプライアンスシステムに標準化された方法で接続します。MCP サーバーを利用することで、パートナーや開発者は AI を活用した税務ワークフローを統合し、越境コンプライアンスを自動化して、定期的に更新される Avalara の税務コンテンツにアクセスできます。

Avalara がサポートする MCP サーバーには、AvaTax、Returns、E-Invoicing and Live Reporting、Tax Registrations and Business Licenses and Exemption Certificate Management、Cross Border Trade、Tax Content が含まれます。今後、さらに多くのサービスが追加される予定です。

できること：

1. リアルタイムの税率や税額計算を照会する
2. コンプライアンスの監視や規制の更新情報にアクセスする
3. 免税証明書、事業許可証、申告書を管理する
4. ドキュメントやガイダンスを取得する

Avalara MCP サーバーを使い始める

AI を活用した税務コンプライアンスの統合に向けて、Avalara Model Context Protocol（MCP）サーバーの設定方法と接続方法を確認できます。

前提条件

Avalara MCP サーバーに接続するには、以下が必要です。

• Avalara のサブスクリプション：有効な Avalara アカウントが必要です
• AI クライアント：FastMCP またはその他の MCP 対応ライブラリを使用して構築されたプログラムクライアント。
• 最新のウェブブラウザー：OAuth 2.1 認可フローに必要です。

接続方法：

ステップ 1：MCP クライアントを設定する 各 MCP サーバーのページに記載されている手順に従ってください。

ステップ 2：アクセスを認可する

• プロンプトが表示されたら、MCP クライアントから Avalara の安全なサインインページにリダイレクトされます
• Avalara の認証情報でサインインします
• 特定の MCP サーバー機能へのアクセスについて、クライアントが要求する権限を確認します
• 同意を付与して OAuth フローを完了します

利用可能な MCP サーバー

サーバー	説明	インストール
Avalara AvaTax MCP サーバー	税額計算、取引管理、ネクサスへの対応、コンプライアンスデータのために、Avalara AvaTax API へのアクセスを提供します。
Avalara Returns MCP サーバー	税務申告管理、申告カレンダー、コンプライアンスデータのために、Avalara Global Returns API へのアクセスを提供します。
Avalara Tax Registrations and Business License MCP サーバー	ライセンスに関するガイダンス、売上税および給与税の登録、質問票の管理、事業活動の検証のために、Avalara Tax Registration and Business Licenses API へのアクセスを提供します。
Avalara E-Invoicing & Live Reporting MCP サーバー	文書ステータスの取得、コンプライアンスに準拠した文書のダウンロード、管轄区域全体のコンプライアンス管理のために、Avalara E-Invoicing and Live Reporting API へのアクセスを提供します。
Avalara Exemption Certificates Management MCP サーバー	証明書、顧客プロファイル、会社データを管理するために、Avalara Exemption Certificate Management API へのアクセスを提供します。
Avalara Cross-Border Trade Services MCP サーバー	Cross-Border Trade Services MCP サーバーは、関税計算など、国境を越えた取引を実行するツールと、貿易・関税コンテンツライブラリ（輸入貿易制限を含む）へのアクセスを提供することで、AI エージェントを支援します。
Avalara Tax Content MCP サーバー	Transaction Tax Export（TTE）の構成、ジョブ、通信、宿泊およびレンタカー向けのユーザー定義関数など、Avalara Tax Content（ATC）データへのアクセスを提供します。
Avalara Dev Documentation MCP サーバー	技術文書、製品情報、ハウツーガイド、コード例など、Avalara の開発者向けドキュメントと統合ガイドへのアクセスを提供します。
Avalara Classification MCP サーバー	国境を越えた取引向けに、統一システム（HS）コードの分類を提供します。管理された分類リクエスト、HS コードの検証と確認、AI を活用した輸出入、強化された貿易コンプライアンスコンテンツの検索に対応します。

よくある問題のトラブルシューティング：

• 接続に失敗しました：Avalara アカウントの状態とインターネット接続を確認してください。
• アクセスが拒否されました：アカウントが要求されたサービスにアクセスできることを確認してください。
• HTTP 429（リクエストが多すぎます）：サーバーのレート制限を超えています。
• 数分待ってから、もう一度お試しください。
• サーバーのレート制限の詳細は、個別のページで確認してください。