CData CLI を使用して OpenCode Terminal と QuickBooks Time のデータ を連携する方法

OpenCode は Anomaly が開発したオープンソースの AI コーディングエージェントで、コードやコンテキストデータを一切保存することなく、ターミナル、デスクトップ、IDE に直接 AI アシスタント機能を提供します。Claude、GPT、Gemini、ローカルモデルを含む 75 以上の LLM プロバイダーに対応しており、同一プロジェクト上でそれぞれ独自のコンテキストを持つ複数のエージェントセッションを並行して実行できます。インテグレーション、AGENTS.md 設定ファイル、TypeScript/JavaScript プラグインシステムに対応しているため、OpenCode は構造化されたツール駆動型のワークフローに適しており、CData CLI を通じて外部データソースに接続する用途にぴったりです。データに対してやりたいことを自然な言葉で伝えるだけで、OpenCode がドライバーの構成からライセンスのアクティベーション、接続の作成、クエリの実行まで、各ステップで手作業を挟むことなくセットアップ全体を処理してくれます。

この記事では、CData CLI を通じて QuickBooks Time を OpenCode Terminal に接続する手順を、ステップごとに詳しく説明します。

前提条件

1. OpenCode Terminal がインストールされていること
2. CData CLI がインストールされていること
3. QuickBooks Time へのアクセス権があること

ステップ 1: スキルをダウンロードする（初回のみのセットアップ）

CData CLI は、必ず公式スキルと組み合わせて使用しましょう。

1. GitHub 上の公式 CData CLI Skill は、ターミナルから npx skills を使ってインストールできます。

   npx skills add CDataSoftware/cli-skills

2. ターミナルに表示されるプロンプトに従って、OpenCode 向けにインストールします。

ステップ 2: プロジェクトディレクトリをセットアップする

プロジェクトファイルをまとめて格納するためのプロジェクトディレクトリを作成します。

1. ターミナルで目的のディレクトリに移動し、opencode コマンドでセッションを開始します。

ステップ 3: ドライバーと接続を設定する

このセッションで CLI と QuickBooks Time データを使って何を実現したいのかを伝えます。

QuickBooks Time に接続して Timesheets からの更新を確認するコマンドラインアプリを作りたいです。Id や JobcodeId といった重要なカラムのデータも必ず含めてください。

このプロンプトを入力すると、自動的にスキルが読み込まれ、以下のプロセスが開始されます。次の各ステップは、エージェントに手動で個別にプロンプトを送ることもできます。

1. ドライバーのセットアップ: OpenCode は既存の CData QuickBooks Time ドライバーを確認し、なければ新しいドライバーを検索してダウンロードします。

• cdatacli drivers list

• cdatacli drivers search QuickBooks Time

• cdatacli drivers download --artifact-id artifact-id

2. アクティベーション: 1 つのコマンドで QuickBooks Time ドライバーをトライアルライセンスまたは正規ライセンスでアクティベートします。

• cdatacli drivers activate --name "name" --email "email" --trial QuickBooks Time

• cdatacli drivers activate --name "name" --email "email" --key "product-key" QuickBooks Time

3. 接続を確立する: 既存の QuickBooks Time 接続を確認するか、新しい接続を作成します。

• cdatacli connection list

• cdatacli connection create --driver QuickBooks Time --name my_QuickBooks Time_connection --connectionstring "Prop1=value1;Prop2=value2;..."

4. QuickBooks Time スキルを作成する（該当する場合）: CData は主要なデータソース向けのドライバー手順書を提供しており、これを使ってデータソース固有のスキルファイルを生成することで、ドライバーのベストプラクティスに沿ってエージェントを導けます。
• 次のコマンドを実行してスキルファイルを生成し、出力をスキルディレクトリに保存します。スキルはプロジェクト単位またはグローバルのいずれかに保存できます。（注: 「No instructions available for QuickBooks Time」というメッセージが返された場合は、そのドライバー用の手順書が存在しないため、メインのドライバースキルをそのまま使用できます）

  cdatacli drivers skill QuickBooks Time > ~/skills/cdata-QuickBooks Time/SKILL.md

ステップ 4: QuickBooks Time データをクエリする

CData ドライバーの構成がすべて完了したら、エージェントはリアルタイムの QuickBooks Time データに対してクエリを実行したり、コードを書いたりできるようになります。

cdatacli query sql --connection my_QuickBooks Time_connection --sql "SELECT * FROM table"

CData CLI でターミナルから直接 QuickBooks Time データをクエリする

OpenCode と CData CLI を組み合わせれば、カスタムのミドルウェアやスケジュール同期、各ステップでの手作業なしに、AI コーディングエージェントがリアルタイムの QuickBooks Time データへ直接アクセスできる道筋が手に入ります。やりたいことを伝えるだけで、エージェントがドライバーの構成、接続のセットアップ、クエリの実行までをターミナル上で最初から最後まで処理します。

無料の CData CLI をダウンロードして、CData JDBC Driver for QuickBooks Time の 30 日間無償トライアルを今日から始めましょう。