Claribi.com

clariBI MCP サーバー

clariBI Model Context Protocol サーバーの公開リファレンスです。LLM クライアントからユーザー登録、データのアップロード、OAuth 経由でのクラウドソースへの接続、自然言語による分析の実行、レポートの生成を可能にする、ホスト型 MCP エンドポイントです。

このリポジトリには、公開マニフェスト、サンプル、リファレンスドキュメントが含まれています。clariBI プラットフォーム自体は商用のホスト型サービスです。このホスト型 MCP エンドポイントのドキュメントを公開しているため、MCP 仕様に準拠するあらゆるクライアントから接続できます。

エンドポイント

トランスポート	URL	プロトコルバージョン
Streamable HTTP	https://claribi.com/mcp/v1/	2025-03-26
SSE（レガシー）	https://claribi.com/mcp/v1/sse	2024-11-05

認証

Dynamic Client Registration（RFC 7591）を使用した OAuth 2.1。検出エンドポイント：

• 認可サーバーメタデータ（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 のウェブアプリで「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）はサブスクリプションを必要としません。そのため、新規ユーザーは事前にアカウントを作成しなくても、LLM クライアントから 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/
• LLM を使った新規登録の手順：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 アカウントが必要です。