AI チャットを接続する

リモート MCP（Model Context Protocol）サーバーに対応する AI チャットから、FastBI のデータ探索、分析、レポート取得を行えます。アクセス範囲は、承認した権限に限られます。

OAuth で接続する

FastBI の User settings → Connect your AI with MCP を開き、MCP server URL をコピーします。本番サービスの URL は https://fastbi.app/api/mcp/v1 です。
AI クライアントの連携設定または MCP 設定に URL を追加します。指定が必要な場合は、通信方式に Streamable HTTP、認証方式に OAuth を選びます。操作名はクライアントによって異なります。
接続を開始し、Google、Microsoft、またはメールアドレスとパスワードで FastBI にサインインします。
Connect … 画面でアプリ名と Return address を確認します。Organization を選び、Allow access to で必要な機能だけを選択して Allow access を押します。拒否する場合は Cancel を選びます。
チャットに戻り、必要に応じてその会話で FastBI を有効にして、利用可能な機能の一覧を尋ねます。

サインインは本人確認です。その後の承認によって、選択した組織へのアクセスが許可されます。所属するすべての組織が自動的に公開されるわけではありません。

MCP サーバー URL をコピーし、AI クライアントに許可する機能を選びます。

許可する機能を選ぶ

Catalog：接続データとスキーマの参照。
Reports：レポートの参照と保存済みウィジェットの実行。
Ad hoc analysis：質問と分析の実行。
SQL Workbench：クエリの計画、SQL の実行、結果の参照。

AdHoc と SQL には Analyst ロールが必要です。有効なワークスペースのメンバーシップと権限も引き続き適用されます。要求されたデータは AI クライアントに送信され、分析とクエリには通常の FastBI クレジットが使われます。

単発の質問をする

データソース、指標、期間、タイムゾーン、除外条件を指定します。次の例を実際のデータに合わせて変更してください。

FastBI を使って、直近の完了した 4 週間の純売上を週別に USD で表示してください。注文データソースを使い、キャンセル注文を除外して、レポート用タイムゾーンで集計してください。グラフ、対象期間、使用したソースも示してください。

クライアントは該当する保存済みレポートを使うか、AdHoc 分析を開始します。確認の質問に答え、完了を待ってフィルターと合計を確認します。追加の質問は同じ会話で続けてください。クライアントでグラフを表示できない場合は FastBI で結果を開きます。

定期的にデータを取得する

スケジュール実行時の認証付き MCP 呼び出しに対応するクライアントまたは自動化サービスで予定を設定します。FastBI への接続だけではスケジュールは作成されません。未対応のクライアントでも単発の取得は可能です。

繰り返し取得する指標とフィルターを含む保存済みレポートを作成します。
過去の回答を再表示するだけでなく、対象ウィジェットを実行して新しい結果を取得するよう指定します。クライアント側で期間、タイムゾーン、頻度、出力先を設定します。
手動で一度実行し、期間とデータの鮮度を確認してから予定を有効にします。

毎平日の 09:00 Asia/Bangkok に、FastBI の「日次売上」レポートの「売上」ウィジェットを前日の完了した 1 日分について実行してください。売上、注文数、その前日との比較、対象期間、データの最終更新時点を返してください。

名前をワークスペースに合わせ、クライアントに保存された予定を確認します。FastBI Jobs は選択したデータを Lake に同期し、AI クライアントの予定がそのデータを取得します。同期が正常に完了した後に取得するよう設定してください。実行ごとにクレジットを消費する場合があります。

OAuth の仕組み、有効期限、取り消し

承認後、クライアントは戻り先アドレスで短時間有効な認可コードを受け取り、PKCE を使ってアクセストークンと更新トークンに交換します。FastBI のパスワードを AI クライアントに入力する必要はありません。

アクセストークンの有効期間は最大 1 時間です。対応クライアントは 30 日間の認可期間内に自動更新します。期間が終了したら、再接続して再度承認してください。トークン更新で認可期間が無期限に延長されるわけではありません。定期実行にも有効な認可が必要です。

アクセスを取り消すには User settings → Connect your AI with MCP → Connected AI apps → Revoke を選びます。以後のアクセスは停止しますが、クライアントがすでに受け取ったデータは削除されません。

手動トークンを使う場合

Manual access tokens で接続名を入力し、Allowed features を選んで Create access token を押します。一度だけ表示されるトークンをコピーし、同じ MCP URL に対するクライアントの Bearer トークン入力欄に設定します。チャットや共有設定には貼り付けないでください。この画面で作成したトークンは 30 日後に期限切れとなり、User settings で取り消せます。

接続エラーでは有効期限、組織、承認した機能、ロールを確認します。結果が古い場合はレポート期間と最後に成功した同期を確認してください。外部 MCP データソースを FastBI に追加する方法は MCP integrations を参照してください。