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

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

Ringostat + Microsoft Copilot

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 — Microsoft Copilot にコネクタを追加

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

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。Ringostat のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

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

FAQ

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

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