CData CLI を使用して Cursor CLI と QuickBooks Online のデータ を連携する方法
Cursor は Anysphere が開発した AI エディター兼コーディングエージェントで、コードベース全体を理解するエージェントを使ってコードの計画、記述、レビューを行います。Cursor CLI はこうしたエージェント機能をターミナルにネイティブに持ち込み、開発者はコンテキストを切り替えることなく、あらゆるターミナル、スクリプト、エディターでエージェントを実行できます。インテグレーションやカスタムエージェントルールに対応しているため、Cursor CLI は構造化された複数ステップのワークフローに適しており、CData CLI のようなツールを通じて外部データソースに接続する用途にぴったりです。データに対してやりたいことを自然な言葉で伝えるだけで、Cursor のエージェントがドライバーの構成からクエリの実行まで、各ステップで手作業を挟むことなくセットアップ全体を処理してくれます。
この記事では、CData CLI を通じて QuickBooks Online を Cursor CLI に接続する手順を、ステップごとに詳しく説明します。
前提条件
- Cursor CLI がインストールされていること
- CData CLI がインストールされていること
- QuickBooks Online へのアクセス権があること
QuickBooks Online データ連携について
CData は、QuickBooks Online のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- フィルターや集計などの複雑な操作に対するプッシュダウンクエリ最適化により、高性能なデータ読み取りを実現します。
- QuickBooks Online データの読み取り、書き込み、更新、削除ができます。
- SQL ストアドプロシージャを使用して、レポートの実行、添付ファイルのダウンロード、請求書の送信や無効化をコードから直接実行できます。
- OAuth と TLS 1.2、SHA-256、ECC などの最新の暗号化を使用して安全に接続できます。
多くのユーザーは、Power BI や Excel などのお気に入りの分析ツールからライブ QuickBooks Online データにアクセスしたり、フェデレートアクセスでデータベースから直接アクセスしたり、CData ソリューションを使用して QuickBooks Online データを B2B コミュニケーション用の自動化ワークフローに簡単に統合したりしています。
お客様が CData の QuickBooks Online ソリューションで問題を解決している方法については、ブログをご覧ください:https://jp.cdata.com/blog/360-view-of-your-customers
はじめに
ステップ 1: スキルをダウンロードする(初回のみのセットアップ)
CData CLI は、必ず公式スキルと組み合わせて使用しましょう。
-
GitHub 上の公式 CData CLI Skill は、ターミナルから npx skills を使ってダウンロードできます。
npx skills add CDataSoftware/cli-skills
-
ターミナルに表示されるプロンプトに従って、Cursor CLI 向けにインストールします。
ステップ 2: プロジェクトディレクトリをセットアップする
プロジェクトファイルをまとめて格納するためのプロジェクトディレクトリを作成します。
-
ターミナルで目的のディレクトリに移動し、agent コマンドでセッションを開始します。
ステップ 3: ドライバーと接続を設定する
このセッションで CLI と QuickBooks Online データを使って何を実現したいのかを伝えます。
QuickBooks Online に接続して Customers からの更新を確認するコマンドラインアプリを作りたいです。DisplayName や Balance といった重要なカラムのデータも必ず含めてください。
このプロンプトを入力すると、自動的にスキルが読み込まれ、以下のプロセスが開始されます。次の各ステップは、エージェントに手動で個別にプロンプトを送ることもできます。
- ドライバーのセットアップ: Cursor CLI は既存の CData QuickBooks Online ドライバーを確認し、なければ新しいドライバーを検索してダウンロードします。
cdatacli drivers list
cdatacli drivers search --driver "QuickBooks Online"
cdatacli drivers download --artifact-id <artifact-id>
- アクティベーション: 1 つのコマンドで QuickBooks Online ドライバーをトライアルライセンスまたは正規ライセンスでアクティベートします。
cdatacli drivers activate "QuickBooks Online" --name "<name>" --email "<email>" --trial
cdatacli drivers activate "QuickBooks Online" --name "<name>" --email "<email>" --key "<product-key>"
- 接続を確立する: 既存の QuickBooks Online 接続を確認するか、新しい接続を作成します。
cdatacli connection list
cdatacli connection create --driver QuickBooksOnline --name my_quickbooksonline_connection --connectionstring "Prop1=value1;Prop2=value2;..."
- QuickBooks Online スキルを作成する(該当する場合): CData は主要なデータソース向けのドライバー手順書を提供しており、これを使ってデータソース固有のスキルを作成することで、ドライバーのベストプラクティスに沿ってエージェントを導けます。
- 次のコマンドを実行してスキルファイルを生成し、出力をスキルディレクトリに保存します。スキルはプロジェクト単位またはグローバルのいずれかに保存できます。(注: 「No instructions available for QuickBooks Online」というエラーが返された場合は、そのドライバー用の手順書が存在しないため、メインのドライバースキルをそのまま使用できます)
cdatacli drivers skill "QuickBooks Online" > ~/skills/cdata-quickbooksonline/SKILL.md
ステップ 4: QuickBooks Online データをクエリする
CData ドライバーの構成がすべて完了したら、エージェントはリアルタイムの QuickBooks Online データに対してクエリを実行したり、コードを書いたりできるようになります。
cdatacli query sql --connection my_quickbooksonline_connection --sql "SELECT * FROM Customers"
CData CLI でターミナルから直接 QuickBooks Online データをクエリする
Cursor CLI と CData CLI を組み合わせれば、カスタムのミドルウェアやスケジュール同期、各ステップでの手作業なしに、AI コーディングエージェントがリアルタイムの QuickBooks Online データへ直接アクセスできる道筋が手に入ります。やりたいことを伝えるだけで、エージェントがドライバーの構成、接続のセットアップ、クエリの実行までをターミナル上で最初から最後まで処理します。
無料の CData CLI をダウンロードして、CData JDBC Driver for QuickBooks Online の 30 日間無償トライアルを今日から始めましょう。