【Code Assist MCP】QuickBooks × Claude Code 連携ガイド | AI でデータを徹底活用
Claude Code は、AI を活用したコマンドラインツールで、エージェント型のコーディングワークフローを実現します。MCP に対応しているため、ターミナルからローカルツールやエンタープライズデータソースに直接接続でき、コンテキストを切り替えることなくライブシステムと自然言語でやりとりできます。
Model Context Protocol(MCP)は、LLM クライアントを外部サービスに接続するためのオープンスタンダードです。MCP サーバーは、スキーマの検出やリアルタイムクエリなどの機能を提供し、AI エージェントがリアルタイムデータを安全かつ一貫した方法で取得・分析できるようにします。
この記事では、CData Code Assist MCP for QuickBooks のインストール、QuickBooks への接続設定、Code Assist MCP アドオンと Claude Code の連携、そしてターミナルからリアルタイムの QuickBooks のデータ をクエリする方法を順を追って解説します。
QuickBooks データ連携について
CData は、QuickBooks のライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています:
- ローカルとリモートの両方の会社ファイルにアクセスできます。
- エディションと地域を問わず接続できます:QuickBooks Premier、Professional、Enterprise、Simple Start エディション 2002+、およびカナダ、ニュージーランド、オーストラリア、英国エディション 2003+。
- SQL ストアドプロシージャを使用して、取引の無効化やクリア、リストの統合、エンティティの検索などのアクションを実行できます。
お客様は、Power BI、Tableau、Excel などのお気に入りのツールと QuickBooks データを定期的に統合し、QuickBooks データをデータベースやデータウェアハウスに統合しています。
はじめに
ステップ1:CData Code Assist MCP for QuickBooks のダウンロードとインストール
- まず、CData Code Assist MCP for QuickBooks をダウンロードします。
- ダウンロードしたインストーラーをダブルクリックして実行します。
- 画面の指示に従ってインストールを完了させます。
インストールが完了したら、QuickBooks への接続を設定して Code Assist MCP アドオンを構成していきましょう。
ステップ2:QuickBooks への接続を設定
- インストール完了後、CData Code Assist MCP for QuickBooks の設定ウィザードを開きます。
NOTE: ウィザードが自動的に起動しない場合は、Windows の検索バーで「CData Code Assist MCP for QuickBooks」を検索してアプリケーションを開いてください。
- MCP Configuration > Configuration Name で、既存の構成を選択するか、
を選んで新しい構成を作成します。
- 構成名を入力(例:「cdata_quickbooks」)し、OK をクリックします。
-
設定ウィザードで適切な接続プロパティを入力します。
ローカルQuickBooks インスタンスへの接続には接続プロパティ入力は不要です。
CData 製品は、リモートコネクタ経由でQuickBooks にリクエストを作成します。リモートコネクタはQuickBooks と同じマシン上で動作し、軽量の組み込みWeb サーバーを介して接続を受け入れます。サーバーはSSL/TLS をサポートし、ユーザーにリモートマシンからのセキュアな接続を可能にします。
初めて接続するときは、CData 製品をQuickBooks で認証する必要があります。詳しくは、ヘルプドキュメントの「Using the Remote Connector」を参照してください。
- Connect をクリックして、QuickBooks の認証を行います。
- 続いて、Save Configuration をクリックして Code Assist MCP アドオンの設定を保存します。
この操作により、Claude Code が Code Assist MCP アドオンの起動時に参照する .mcp 構成ファイルが作成されます。これで Code Assist MCP アドオンの設定が完了したので、次は Claude Code との連携を設定していきましょう。
ステップ3:Code Assist MCP アドオンを Claude Code に接続
- ターミナルを使って Claude Code CLI をインストールします。
- Claude Code の設定ファイル ~/.config/claude-code/config.json(または初期化後に表示されるパス)を開きます。
方法1:MCP 構成を手動で追加する
- お使いのエディターで mcp.json ファイルを開きます。
- 以下のコードを追加します。
{
"mcpServers" : {
"cdata_quickbooks" : {
"type" : "stdio",
"command" : "C:\Program Files\CData\CData Code Assist MCP for QuickBooks\jre\bin\java.exe",
"args" : [ "-Dfile.encoding=UTF-8", "-jar", "C:\Program Files\CData\CData Code Assist MCP for QuickBooks/lib/cdata.mcp.quickbooks.jar", "cdata_quickbooks" ],
"env" : {}
}
}
}
NOTE: command の値には、Java 17 以上の java.exe 実行ファイルのパスを指定してください。また、JAR のパスにはインストール済みの CData Code Assist MCP アドオンの .jar ファイルを指定します。最後の引数は、CData 設定ウィザードで保存した MCP 構成名(例:「cdata_quickbooks」)と一致させる必要があります。
方法2:CData Code Assist MCP for QuickBooks の UI から MCP 構成をコピーする
- 設定ウィザードで接続の保存とテストが完了したら、Next をクリックします。
- AI MCP Tool ドロップダウンから Claude Code を選択します。
- Copy JSON をクリックして、生成された MCP 構成をクリップボードにコピーします。
- コピーした JSON を mcp.json ファイルに貼り付けます。
ステップ4:Claude Code で接続を確認
Claude Code には、アプリケーションの構築を開始する前に接続が有効であることを確認するためのツールが用意されています。
- ターミナルを開いてプロジェクトディレクトリに移動し、claude mcp list コマンドを実行します。
- 構成名が Connected ステータスで表示されていることを確認します。
- claude を実行して Claude Code を起動します。
- Claude Code セッション内で /mcp と入力して、アクティブなサーバーを確認します。
ステップ5:Claude Code でリアルタイムの QuickBooks のデータ をクエリ
接続が確認できたら、自然言語のプロンプトを使ってリアルタイムの QuickBooks のデータ をクエリしたり操作したりできます。
- まず、Claude Code に MCP 接続の手順を確認するようプロンプトを入力し、コード生成時に適切なコンテキストが参照されるようにします。
- あとは自然言語のプロンプトで開発を進めるだけです。例えば:
For my project, data from the Customers is very important. Pull data from the most important columns like Name and CustomerBalance.
Claude Code は MCP アドオンを通じて QuickBooks に接続し、リクエストされたデータを取得して、ターミナル上に直接結果を表示します。
Code Assist MCP で構築。CData Drivers で本番運用。
Code Assist MCP を無料でダウンロードして、開発中にリアルタイムの QuickBooks のデータ へのスキーマ対応アクセスを AI ツールに提供しましょう。本番環境への移行時には、CData QuickBooks Drivers が同じ SQL ベースのアクセスをエンタープライズグレードのパフォーマンス、セキュリティ、信頼性で実現します。
CData コミュニティにアクセスして、インサイトの共有や質問、MCP を活用した AI ワークフローの可能性を探索しましょう。