Magic Insights

Magic Insights MCP サーバー

任意の MCP クライアントを Magic Insights のワークスペースに接続して、顧客フィードバックの 調査 とチャットできます。調査の一覧表示、フィードバックの検索と絞り込み、AI が生成したテーマ、トピック、提案、タグ、センチメントの傾向の確認が可能です。

これは リモートのホステッド型 MCP サーバーです。インストールは不要です。クライアントを以下の URL に接続し、ワークスペースの API キーで認証してください。

• サーバー URL： https://app.magicinsights.ai/api/mcp
• トランスポート： Streamable HTTP
• 認証： API キー（ベアラートークン）
• 公式 MCP レジストリ： ai.magicinsights/insights

API キーを取得する

アプリの 設定 → API キー（https://app.magicinsights.ai → ワークスペース → 設定 → API キー）でキーを作成し、Authorization: Bearer <key> ヘッダーとして送信します。

接続

Claude Code

claude mcp add --transport http magic-insights https://app.magicinsights.ai/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に追加し、Cursor の設定でサーバーを有効にします。

{
  "mcpServers": {
    "magic-insights": {
      "url": "https://app.magicinsights.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

その他のクライアント（Claude Desktop、Windsurf、MCP Inspector、…）

ほとんどのクライアントでは、上記と同じ mcpServers ブロックを使用します。設定ファイルの場所については、お使いのクライアントのドキュメントを確認してください。Claude API MCP コネクターでは、authorization_token を指定して同じ URL を使用できます。

ツール

すべてのツールは 読み取り専用 で、API キーを所有するワークスペースに限定されます。

ツール	機能
get_workspace	1 回の呼び出しで概要を取得します：プラン、調査件数、接続済みプラットフォーム、タグ、フィードバックの合計件数、日付範囲、全体的なセンチメント。
list_studies	説明と日付範囲を含むすべての調査を一覧表示します。
get_study	調査の概要、生成されたレポート、上位のテーマ（センチメント、ID、フィードバック例を含む）を取得します。
list_topics	調査のトピックと、それぞれに分類されたテーマを取得します。
get_theme_feedback	1 つのテーマに属するすべてのフィードバックを、関連性の高い順に取得します。
list_suggestions	調査に対して AI が統合した推奨アクション（問題、解決策、優先度）を一覧表示します。
get_suggestion_feedback	1 つの提案の根拠となった個々のフィードバックを取得します。
search_feedback	キーワード、センチメント、プラットフォーム、タグ、日付範囲でフィードバックを検索・絞り込みます。
get_feedback	1 件のフィードバックの全情報（内容、翻訳、AI による要約、ソースメタデータ）を取得します。
get_stats	集計統計を取得します：合計件数、センチメントの内訳、日付範囲。
get_trends	フィードバックの量とセンチメントの経時的な推移を、週または月単位で集計して取得します。
list_tags	ワークスペースのカスタムタグと、それぞれが付与されている項目数を一覧表示します。
list_platforms	ワークスペースにフィードバックを提供するソースプラットフォームと、それぞれのフィードバック件数を一覧表示します。

概要

Magic Insights は、AI を活用した顧客フィードバック分析プラットフォームです。詳しくは magicinsights.ai をご覧ください。

サーバーのメタデータは公式 MCP レジストリで公開されています。このリポジトリでは、公開されている server.json と接続ドキュメントを提供しています。アプリケーションのソースコードは非公開です。