Agenticbi

AgenticBI MCP サーバー

デモ

AgenticBI の動作をご覧ください：https://www.youtube.com/@TryAgenticBI

項目	値
製品	AgenticBI MCP サーバー
目的	Claude、Cursor、VS Code、ChatGPT、Codex CLI など、MCP 対応の AI クライアントをビジネスデータに直接接続します
エンドポイント	https://app.agenticbi.com/api/2.0/mcp
プロトコル	MCP 2024-11-05
トランスポート	SSE を使用する Streamable HTTP（POST）
認証	PKCE を使用する OAuth 2.1
利用可能なツール	33
GitHub	https://github.com/AgenticBIHQ/agenticbi-mcp-server

前提条件

要件
MCP 対応の AI クライアント（Claude Desktop、Claude Code、Cursor、VS Code、ChatGPT、Codex CLI）

クライアントのセットアップ

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "agenticbi": {
      "url": "https://app.agenticbi.com/api/2.0/mcp"
    }
  }
}

ファイルの場所：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

初回使用時に、ブラウザーで AgenticBI のログイン画面が開きます。サインインするかアカウントを作成して、認証を許可してください。

詳細ガイド： https://app.agenticbi.com/docs/mcp-server.html

---

Claude Code

claude mcp add agenticbi --transport http https://app.agenticbi.com/api/2.0/mcp

1. 上記のコマンドをターミナルで実行します。

2. Claude Code を終了して再起動します。

3. /mcp を実行し、agenticbi を選択して Enable をクリックします。

4. 認証ボタンをクリックすると、ブラウザーで AgenticBI のログイン画面が開きます。

5. サインインするかアカウントを作成して、アクセスを許可します。

6. 次のように質問して確認します：

   利用可能な AgenticBI ツールを教えてください。

代替方法：手動トークン認証

AgenticBI → Settings → AI Settings → MCP Token でトークンを生成し、次のコマンドを実行します：

claude mcp add agenticbi https://app.agenticbi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

詳細ガイド： https://app.agenticbi.com/docs/claude-code-setup.html

---

Cursor

Cursor v0.45 以降が必要です。

1. Settings → Cursor Settings を開きます
2. Tools & Integrations → New MCP Server を選択します
3. mcp.json に次の内容を追加します：

{
  "mcpServers": {
    "agenticbi": {
      "url": "https://app.agenticbi.com/api/2.0/mcp"
    }
  }
}

4. ファイルを保存します。初回使用時に、ブラウザーで AgenticBI のログイン画面が開きます。

代替方法：手動トークン認証

{
  "mcpServers": {
    "agenticbi": {
      "url": "https://app.agenticbi.com/api/2.0/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

詳細ガイド： https://app.agenticbi.com/docs/cursor-mcp-setup.html

---

VS Code

オプション A — コマンドパレット（推奨）

1. コマンドパレットを開きます：

   • macOS：Cmd + Shift + P
   • Windows：Ctrl + Shift + P

2. MCP: Add Server を検索します

3. サーバーの種類として HTTP を選択します

4. 次の内容を入力します：

   https://app.agenticbi.com/api/2.0/mcp
   

5. agenticbi という名前を付けます

6. 保存します

7. 初回使用時にブラウザーで認証を許可します

オプション B — 設定ファイル

settings.json に追加します：

{
  "mcp": {
    "servers": {
      "agenticbi": {
        "type": "http",
        "url": "https://app.agenticbi.com/api/2.0/mcp"
      }
    }
  }
}

または .vscode/mcp.json に追加します：

{
  "servers": {
    "agenticbi": {
      "type": "http",
      "url": "https://app.agenticbi.com/api/2.0/mcp"
    }
  }
}

代替方法：手動トークン認証

{
  "mcp": {
    "servers": {
      "agenticbi": {
        "type": "http",
        "url": "https://app.agenticbi.com/api/2.0/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_MCP_TOKEN"
        }
      }
    }
  }
}

詳細ガイド： https://app.agenticbi.com/docs/vscode-mcp-setup.html

---

ChatGPT

1. メッセージ入力欄の + をクリックして Connectors を選択するか、Settings → Connected Apps を開きます

2. Add Custom Connector を選択します

3. AgenticBI という名前を付けます

4. サーバー URL を入力します：

   https://app.agenticbi.com/api/2.0/mcp
   

5. 認証方式として OAuth 2.0 を選択します

6. Save をクリックします

7. 初回使用時に、ChatGPT がブラウザーを開き、AgenticBI へのサインインと認証を求めます

代替方法：手動トークン認証

1. AgenticBI → Settings → AI Settings → MCP Token でトークンを生成します
2. 上記の手順 1～4 を繰り返します
3. 認証方式として Bearer Token を選択します
4. トークンを貼り付けます
5. Save をクリックします

詳細ガイド： https://app.agenticbi.com/docs/chatgpt-mcp-setup.html

---

Codex CLI

~/.codex/config.json に追加します：

{
  "mcpServers": {
    "agenticbi": {
      "type": "http",
      "url": "https://app.agenticbi.com/api/2.0/mcp"
    }
  }
}

初回使用時に、認証のためブラウザーで AgenticBI のログイン画面が開きます。

代替方法：手動トークン認証

{
  "mcpServers": {
    "agenticbi": {
      "type": "http",
      "url": "https://app.agenticbi.com/api/2.0/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

詳細ガイド： https://app.agenticbi.com/docs/codex-mcp-setup.html

認証エンドポイント

エンドポイント	URL
認証	https://app.agenticbi.com/oauth/mcp/authorize
トークン	https://app.agenticbi.com/oauth/mcp/token
登録	https://app.agenticbi.com/oauth/mcp/register

ツールカテゴリ

カテゴリ	ツール数
質問とクエリ	6
ダッシュボードとエクスポート	4
インサイトとアラート	3
ドキュメント	2
作成と管理	16
破壊的操作	2
合計	33

質問とクエリのツール

ツール	説明
ask	自然言語でデータに関する質問をする
get_data	データセット全体またはウィジェットのデータを取得する
search	AgenticBI のアセットを検索する
find_widget	名前でウィジェットを検索する
get_details	アセットの詳細を取得する
explain_lineage	回答がどのように作成されたかを追跡する

ダッシュボードとエクスポートのツール

ツール	説明
list_dashboards	ダッシュボードの一覧を表示する
get_embed_url	埋め込みリンクを生成する
export_pdf	ダッシュボード／ウィジェットを PDF としてエクスポートする
export_csv	データを CSV としてエクスポートする

インサイトとアラートのツール

ツール	説明
get_insights	AI を活用したインサイトを生成する
list_alerts	アラートの一覧を表示する
cloud9ql_assist	Cloud9QL の生成、修正、説明、変換、検証、またはプレビューを行う

ドキュメントのツール

ツール	説明
ask_document	取り込んだドキュメントについて質問する
list_documents	取り込んだドキュメントの一覧を表示する

作成と管理のツール

ツール	説明
do	自然言語で操作を実行する
push_data	データセットに行を追加する
run	保存済みのクエリ／レポートを実行する
create_datasource	データソース接続を作成する
create_query	クエリを作成する
create_widget	ビジュアライゼーションを作成する
update_widget	ビジュアライゼーションを更新する
layout_dashboard	ダッシュボードのウィジェットを配置する
import_file	CSV、JSON、XML、または Excel をインポートする
create_report	スケジュール済みレポートを作成する
update_report	レポートを更新する
create_alert	アラートを作成する
test_alert	アラートをテストする
update_alert	アラートを更新する
ingest_document	ドキュメントを取り込む
extract_document_data	ドキュメントから構造化データを抽出する

破壊的操作のツール

ツール	説明
delete	AgenticBI のアセットを削除する
delete_document	取り込んだドキュメントを削除する

ヘルスと制限

設定	値
ヘルスエンドポイント	GET /api/2.0/mcp/health
セッションヘッダー	Mcp-Session-Id
アイドルタイムアウト	30 分
最大同時セッション数	1,000
デフォルト行数（ask）	500
デフォルト行数（get_data）	10,000
最大行数	200,000

プロンプトの例

例
前四半期の売上高上位 10 社の顧客はどこですか？
3 月に解約が急増したのはなぜですか？
今月、最も多くのパイプラインを生み出したマーケティングチャネルはどれですか？
流入元別の週ごとの登録数を示すダッシュボードを作成してください。
MRR が前週比で 5% を超えて減少したら通知してください。
通話の文字起こしを取得し、失注案件で最も多かった反論を要約してください。
この PDF をアップロードして、主要な指標を抽出し、データセットにしてください。
Q3 の売上ダッシュボードを PDF としてエクスポートし、チームにメールで送信してください。

重要なリンク

リソース	URL
ウェブサイト	https://www.agenticbi.com
MCP ドキュメント	https://app.agenticbi.com/docs/mcp-server.html
プライバシーポリシー	https://www.agenticbi.com/privacy
利用規約	https://www.agenticbi.com/terms

サポート

連絡先
[email protected]

ディレクトリ掲載