Microsoft 365 CopilotまたはCopilot StudioでListeningMind DaaS APIを連携する方法です。
事前準備事項
REST API連携
| 項目 | 内容 |
|---|---|
| API Key | ListeningMind DaaS API Keyの発行完了(契約後に提供) |
| 認証方式 | API Key認証 |
| Base URL | https://listeningmind-data-api.ascentlab.io |
| 認証ヘッダー | LM-API-KEY: <発行されたAPI Key> |
| 推奨用途 | データ連携、内部システムの統合 |
MCP Server連携
| 項目 | 内容 |
|---|---|
| MCP Server ID/PW | ListeningMind DaaS MCP Server ID/PWの発行完了(契約後に提供) |
| 認証方式 | OAuth認証 |
| MCP Server URL | https://listeningmind-daas-mcp.ascentlab.io |
| 推奨用途 | AIプラットフォームのTool/Connector接続、Agentベースのデータ探索 |
[!] 注意事項 – 主要な設定UIおよび連携手順は各プラットフォーム環境によって異なる場合があります。詳細な設定方法は各プラットフォームの公式ドキュメントをご参照ください。 – 各プラットフォームのMCPサポート状況および機能は変更される場合があります。最新情報は各プラットフォームの公式ドキュメントをご確認ください。
Copilot StudioでNew Tool(REST API)を追加する方法
【参照】Microsoftの公式ガイドドキュメントをご参照ください。
新しいエージェントツールを追加し、REST APIを選択してください。API仕様、説明およびソリューションを入力し、認証情報を提供します。APIからツールを選択し、確認して公開します。
Copilot Studioにアクセス:https://copilotstudio.microsoft.com
共通の進入経路:Toolsタブ → Add a tool → New tool

Step 1. New tool → REST APIを選択
Toolsタブ → Add a tool → New tool → REST API
Step 2. OpenAPI仕様のアップロード
OpenAPI JSONファイルをドラッグ&ドロップまたは直接アップロード
ファイルを確認後、Nextをクリック

Step 3. APIの説明 & ソリューションの指定
Description:言語モデルがこのツールをいつ呼び出すかを判断する基準 → 具体的かつ豊富に記載
ListeningMind is a search intelligence API that provides real-time consumer search behavior data from Korea, the United States, and Japan. Use this API to retrieve, analyze, find, and explore keyword search volume, search trends, consumer intent signals, keyword clusters, and search path patterns. This tool should be invoked when the user wants to:
– Look up, check, or get search volume or trend data for any keyword or topic
– Discover, extract, or identify related keyword groups, clusters, or topic buckets
– Understand, analyze, or explore what users are searching for and why (search intent)
– Trace, map, or find what keywords or pages consumers navigate through before reaching a destination (search path, funnel, journey)
– Conduct market research, competitive analysis, or consumer insight analysis using search data
– Generate reports or insights based on actual search behavior data
Synonyms and related actions: keyword research, SEO analysis, search trend analysis, consumer behavior analysis, market signal detection, demand forecasting, brand mention tracking, search funnel analysis, topic modeling from search data
Solution:環境内のソリューションを選択(未選択時は自動生成)
Step 4. 認証方式の設定:API Key(API key)を選択
Step 5. ツール(アクション)の選択 & 構成
APIからエージェントに許可するツールを選択
各ツールに名前と説明を記載し、パラメーターの入出力説明を補完
Next → 全体を確認 → Next(publish)
Actionsの定義
Definitionタブ → New Actionをクリックし、エンドポイントごとに登録します。
ListeningMind DaaS API技術ドキュメント参照:https://listeningmind-data-api.ascentlab.io/
| エンドポイント | Request Bodyスキーマ | Responseスキーマ |
|---|---|---|
| POST /keyword_info | keywords(array)、gl(string)、data_type(string) | Import from sample → APIレスポンスのJSONを貼り付け |
| POST /intent_finder/keyword_list | keywords(array)、gl(string)、limit(integer) | Import from sample → APIレスポンスのJSONを貼り付け |
| POST /path_finder | keyword(string)、gl(string)、limit(integer) | Import from sample → APIレスポンスのJSONを貼り付け |
| POST /cluster_finder | keyword(string)、gl(string)、data_type(string) | Import from sample → APIレスポンスのJSONを貼り付け |
Step 6. Connectionの作成 & エージェントへの追加
REST APIタイプで新しく作成されたツールを選択
Create new connection → 認証情報を入力 → Create
Add and configure → 完了
Custom Connectorの作成
| 項目 | 設定値 |
|---|---|
| パス | Settings → Connectors → Custom Connectors → New |
| Host | listeningmind-data-api.ascentlab.io |
| Base URL | / |
| 認証方式(Security) | API Key |
| Parameter name | LM-API-KEY |
| Parameter location | Header |
| Value | 環境変数 LM-API-KEY を参照 |
Topicでの活用とテスト
| 段階 | 内容 |
|---|---|
| Topicの作成 | Topics → New Topicを作成 |
| Triggerの設定 | トリガー入力:「キーワード分析」 |
| Actionノード | Actionノードを追加 → 作成したConnector Actionを選択 |
| テスト | Test → 「冷蔵庫キーワードを分析して」と入力して確認 |
Copilot StudioでNew Tool(MCP Server)を追加する方法
【参照】Microsoftの公式ガイドドキュメントをご参照ください。
MCPオンボーディングウィザードを使用してエージェントを既存のMCPサーバーに接続します。MCPサーバーがまだない場合はMCPサーバーを作成します。Copilot Studioエージェントが使用できるようにエージェントにMCPサーバーのツールとリソースを追加します。(オプション)MCPコネクターを公開して複数のテナントでコネクターを使用できるようにします。
STEP 0. Generative Orchestrationの有効化
MCPを使用するための必須の事前作業です。
- copilotstudio.microsoft.com にアクセス
- 連携するエージェントを選択 → Settingsタブ
- Generative AIセクション → Generative orchestrationをONに切り替え
- Saveをクリック
STEP 1. MCP Serverの接続
エージェントを選択 → Toolsタブ → Add a toolをクリック → New tool → Model Context Protocolを選択

STEP 2. 基本サーバー情報の入力
| 設定項目 | 値 |
|---|---|
| パス | Copilot Studio → Settings → Plugins → MCP Servers → Add Server |
| Server Name | ListeningMind-DaaS(識別用の名前) |
| Server description | ListeningMind DaaS APIを通じてキーワード検索量、関連キーワード、検索経路、消費者認識クラスターを照会する検索インテリジェンスサーバーです。韓国/日本/米国市場の実際の消費者検索行動データを提供します。 |
| Server URL | https://listeningmind-daas-mcp.ascentlab.io |
| Authentication | OAuth 2.0 |
| 完了確認 | 接続テスト後、トピックで活用 |
⚠️ DescriptionはAIオーケストレーターがこのMCPサーバーをいつ呼び出すかを判断する基準です。具体的かつ詳細に記載するほど正確に呼び出されます。
STEP 3. 認証方式の設定(OAuth 2.0)
MCP Onboarding WizardでAuthentication type → OAuth 2.0を選択後、→ Dynamic Discoveryを選択
Createをクリック
STEP 4. Connectionの作成 & エージェントへの追加
MCPサーバーをエージェントのツールとして追加するには:
- 左側メニューからAgentsを選択
- Create blank agentをクリック
- エージェントの基本情報を登録
- Tools → Add tool → Model Context Protocol
- Create new connection → Create
- ListeningMind DaaSから提供されたID/Passwordを入力 → ログイン
STEP 5. ツール構成の確認
MCPサーバーがエージェントに追加されると、サーバーが提供するすべてのツールがデフォルトでON状態になります。

Toolsタブ → ListeningMind DaaSサーバーを選択
Toolsセクションで提供ツールリストを確認:
- keyword_info — キーワードの検索量/広告指標/SERP/意図
- intent_finder — 関連キーワードの抽出
- path_finder — 検索経路の分析
- cluster_finder — 消費者認識および関係ネットワークの分析
STEP 6. エージェントDescriptionの最適化
各ツールのTool descriptionフィールドを更新するとオーケストレーターの精度が向上します。
Toolsタブ → 各ツールを選択 → Details > Descriptionを編集
ListeningMind DaaS is a search intelligence API providing real-time consumer search behavior data for Korea (kr), Japan (jp), and the US (us). Use this API to retrieve, analyze, and explore:
– Keyword search volume, CPC, ad competition, SERP features, and search intent (I/N/C/T) (keyword_info)
– Related keyword lists from 1–100 seed keywords (intent_finder/keyword_list)
– Consumer search journey sequences and funnel paths (path_finder / path_finder/keyword_list)
– Consumer perception clusters and keyword relationship networks (cluster_finder / cluster_finder/keyword_list)
Invoke when the user asks about: キーワード検索量、関連キーワード、検索経路、消費者ジャーニー、消費者認識グループ、市場分析、SEO、広告競合度、keyword research, search trend, consumer journey, keyword cluster, ad competition, market analysis, search funnel, brand positioning, demographic analysis, CEP, related keywords, long-tail keywords.
Do NOT invoke for general web search or questions unrelated to Korean/Japanese/US search behavior data
STEP 7. 動作テストの確認
右側のTest your agentパネルを開く
以下のサンプル質問でテスト:
- 「〇〇〇」キーワードの日本の月別検索量の推移を教えて
- 「〇〇〇」に関する関連キーワードを100個抽出して
- 「〇〇〇」キーワードを中心に消費者の検索経路を分析して
エージェントが自動的に適切なツール(keyword_info、intent_finder、path_finder)を選択して呼び出せば、正常な連携完了です。