Agenticbi

AgenticBI MCP Server

演示

观看 AgenticBI 的实际演示：https://www.youtube.com/@TryAgenticBI

字段	值
产品	AgenticBI MCP Server
用途	将 Claude、Cursor、VS Code、ChatGPT、Codex CLI 和其他支持 MCP 的 AI 客户端直接连接到业务数据
端点	https://app.agenticbi.com/api/2.0/mcp
协议	MCP 2024-11-05
传输方式	支持 SSE 的可流式 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，并将关键指标提取到数据集中。
将第 3 季度收入仪表板导出为 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]

目录列表