Claribi.com

clariBI MCP 服务

clariBI Model Context Protocol 服务的公开参考文档。该托管 MCP 端点允许大模型客户端为用户注册、上传数据、通过 OAuth 连接云数据源、运行自然语言分析并生成报告。

此仓库包含公开清单、示例和参考文档。clariBI 平台本身是一项商业托管服务；本文档介绍了托管 MCP 端点，以便任何符合规范的 MCP 客户端都能连接。

端点

传输方式	URL	协议版本
可流式 HTTP	https://claribi.com/mcp/v1/	2025-03-26
SSE（旧版）	https://claribi.com/mcp/v1/sse	2024-11-05

身份验证

采用 OAuth 2.1 和动态客户端注册（RFC 7591）。发现端点：

• 授权服务器元数据（RFC 8414）：https://claribi.com/mcp/v1/.well-known/oauth-authorization-server
• 受保护资源元数据（RFC 9728）：https://claribi.com/mcp/v1/.well-known/oauth-protected-resource

公共客户端使用 PKCE S256。机密客户端在注册时会获得客户端密钥。

单用户安装的替代方案：持有者令牌 Authorization: Bearer claribi_mcp_<key>。可在 clariBI Web 应用的 Settings > Developer > MCP Server 中生成密钥。

接口

提供 19 个工具、3 个资源和 2 个提示词。工具名称和 JSON 架构会实时发布在工具目录端点：

curl https://claribi.com/mcp/v1/  # returns server metadata
curl https://claribi.com/api/mcp-server/tool-catalog/  # full catalog

工具包括 register_account、verify_email、check_pricing（注册时无需身份验证）、upload_data_source、ingest_url_data_source、request_oauth_integration_url、run_analysis、generate_report、get_usage、get_billing_status、create_checkout_session，以及用于列出和获取仪表板/报告的工具。

官方 SDK

两个 SDK 均采用 MIT 许可证，并由实时工具目录驱动代码生成，因此类型化方法接口始终与服务端保持一致。

Python

pip install claribi-mcp

from claribi_mcp import Client

with Client(api_key="claribi_mcp_...") as client:
    client.initialize()
    result = client.run_analysis(
        question="What was revenue by region last quarter?",
        wait_seconds=30,
    )
    print(result.text)

PyPI 源码：https://pypi.org/project/claribi-mcp/

TypeScript

npm install @claribicom/mcp

import { Client } from '@claribicom/mcp';

const client = new Client({ apiKey: 'claribi_mcp_...' });
await client.initialize();
const r = await client.callTool('run_analysis', {
  question: 'What was revenue by region last quarter?',
  wait_seconds: 30,
});
console.log(r.text());

npm 源码：https://www.npmjs.com/package/@claribicom/mcp

MCP 服务注册表

已列入官方 Model Context Protocol 服务注册表，命名空间为 com.claribi/mcp-server：

curl 'https://registry.modelcontextprotocol.io/v0.1/servers?search=com.claribi'

清单：server.json。

定价与套餐限制

MCP 服务访问权限由 clariBI 订阅中的 mcp_server_access 功能标志控制。该功能包含在 Trial（免费，14 天）、Starter（$99/月）、Professional（$199/月）和 Enterprise（$999/月）套餐中。Free 和 Lite 套餐不包含此功能。工具错误响应会指出触发了哪项配额限制。

注册工具（register_account、verify_email、check_pricing）无需订阅，因此新用户无需事先拥有账户，即可在自己的大模型客户端中创建 Trial 工作区。

文档

• 概览：https://claribi.com/docs/mcp/overview
• 从 Claude Desktop 连接：https://claribi.com/knowledge-base/mcp-connect-claude-desktop/
• 从 Cursor 连接：https://claribi.com/knowledge-base/mcp-connect-cursor/
• 通过大模型注册的操作指南：https://claribi.com/knowledge-base/mcp-signup-via-llm/
• API 参考：https://claribi.com/knowledge-base/mcp-api-reference/

安全

漏洞披露：[email protected]。请参阅 SECURITY.md。

许可证

此仓库（README、清单、示例、SDK 代码）采用 MIT 许可证。

此服务所接入的托管 clariBI 平台是一项商业服务；使用 MCP 服务端点需要拥有 clariBI 账户。