MCP 経由で Ringostat を Claude に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Ringostat をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Ringostat + Claude

Ringostat のコールトラッキングとクラウド PBX: 流入元、通話時間、ステータス、担当者、録音リンク付きの通話履歴、オンライン中または通話中の担当者、部署と着信先付きの従業員一覧、日次の SIP オンラインレポート、Smart Phone のステータス。コールバックの開始はインストール時にオフになっています。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

RINGOSTAT_AUTH_KEY, RINGOSTAT_PROJECT_ID

ステップ 1 — 認証情報を取得

設定は約 2 分で、Ringostat のプロジェクト管理者が必要です。

1. Ringostat で Settings、Integrations、Ringostat API を開き、Auth-key を RINGOSTAT_AUTH_KEY にコピーします。キーは 1 つのプロジェクトに属し、Auth-key ヘッダーで送られます。
2. RINGOSTAT_PROJECT_ID にそのプロジェクトの番号を設定します。Ringostat ウェブアプリのアドレスバーで project_id= または projectId= の後ろにある値で、たとえば 39071 です。従業員、SIP レポート、カスタムステータスのツールだけが使います。
3. コネクタをインストールします。確認では ringostat_list_online_sip を実行します。

読み取れるデータ: ある期間の通話履歴。1 通話 1 行で、指定した列を返します: 日時、発信番号と着信番号、通話の種類、ステータス（disposition）、通話時間、総時間と待ち時間、担当者の氏名と部署、番号プールと転送スキーム、ターゲットコールと再コールのフラグ、UTM の source、medium、campaign、content、term、ランディングページとリファラー、不在着信の理由、CSAT 評価、通話 ID、録音リンク。さらに、今オンラインの SIP アカウントと今通話中の SIP アカウント、SIP ステータス、氏名、メール、内線番号、staffId、部署、着信先（メインと予備の SIP アカウントまたは電話番号）付きの従業員、従業員ごと日ごとのオンラインとオフラインの時間、そして「昼休み」「会議」のような Smart Phone のカスタムステータスです。

通話履歴: ringostat_list_calls は from と to を YYYY-MM-DD HH:MM:SS で受け取ります。指定しない場合は直近 24 時間を返します。応答は期間内の全通話を含む 1 つの配列で、ページングされません。そのため通話の多いプロジェクトでは、AI は期間を短く（1 日または 1 週間）して、必要な fields だけを指定します。通話時間は秒単位の billsec です。call_type は in、out、callback、transitin、transitout のいずれかで、proper_flag と repeated_flag はターゲットコールと再コールを示します。担当者ごとの統計では、AI は行を employee_fio でまとめて billsec を合計します。

フィルタと並べ替え: フィルタはカンマで区切った Ringostat の式で、たとえば call_type=in,billsec>=30 です。演算子は =、<>、>、<、>=、<=、~（base64 でエンコードした正規表現）です。order で並べ替え（例: calldate desc）、merge で発信番号ごとに 1 日単位（1）または期間全体（2）で通話をまとめます。

個人データ: 電話番号と録音リンクは個人データです。recording と recording_wav の録音リンクは 1 年間有効です。

インストール時にオフ: ringostat_start_callback は、プロジェクトの番号と電話番号または従業員の SIP ログインをつなぐ実際の通話を開始します。すぐに発信して通話料金がかかるため、管理者が意図的にオンにします。オンにした後も、AI は両方の番号を見せて、あなたの承認を待ちます。番号は + を付けない国際形式です。

読み取りのみの POST 呼び出し: 従業員一覧、SIP レポート、カスタムステータスは Ringostat API では POST リクエストですが、読み取りしか行いません。

よくあるエラー: 401 または 403 は、Auth-key がないか間違っているか、キーとプロジェクト ID が別々のプロジェクトのものです。従業員、レポート、ステータスのツールで JSON-RPC エラーが返る場合は、たいてい RINGOSTAT_PROJECT_ID が間違っています。"User does not exist" は、従業員のフィルタに誰も一致しなかったことを意味します。

このコネクタは、PBX の設定、従業員、番号プール、転送スキームを変更せず、録音は音声そのものではなくリンクで返します。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Claude にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

推奨ルート：設定ファイルを触らずに claude.ai web で動作します。

1. Claude で Customize → Connectors を開きます。
2. + をクリックし、Add custom connector を選びます。
3. 名前（例: Ringostat）とリモート MCP サーバー URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力し、Add をクリックします。
4. Connect をクリックし、AnythingMCP にサインイン（OAuth）してアクセスを許可します。

下記のすべてのツールがチャットに表示されます。プロンプトを入力し始めてください。

利用可能なツール

プロンプトの例

• 「昨日の着信は何件で、そのうち不在着信は何件、平均通話時間はどれくらいでしたか？」
• 「先週の通話を担当者ごとにまとめて、通話件数と合計通話時間を出してください。」
• 「今月ターゲットコールをもたらした UTM のソースとキャンペーンはどれですか？」
• 「今オンラインなのは誰で、そのうち通話中なのは誰ですか？」
• 「先週、各従業員は 1 日ごとにどれくらいオンラインでしたか？」

FAQ

Claude Code は Claude Desktop と同じように動作しますか? はい。両方を https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID に向けてください。

次のステップ

• コネクタのランディング
• ChatGPT に接続
• Cursor に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続