English Français العربية

Magic Insights

السجل الرسمي أخرى

Query your customer feedback: studies, themes, suggestions, tags, and sentiment trends.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http magic-insights 'https://app.magicinsights.ai/api/mcp' --header 'Authorization: <Bearer <your Magic Insights API key>. Create one at app.magicinsights.ai → Settings → API keys, then send it as: Authorization: Bearer mi_...>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "magic-insights": {
            "type": "http",
            "url": "https://app.magicinsights.ai/api/mcp",
            "headers": {
                "Authorization": "<Bearer <your Magic Insights API key>. Create one at app.magicinsights.ai → Settings → API keys, then send it as: Authorization: Bearer mi_...>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Magic Insights MCP server
  2. Get an API key
  3. Connect
  4. Tools
  5. About

Magic Insights MCP server

Connect any MCP client to your Magic Insights workspace and chat with your customer-feedback studies — list studies, search and filter feedback, and read AI-generated themes, topics, suggestions, tags, and sentiment trends.

This is a remote, hosted MCP server. There's nothing to install — point your client at the URL below and authenticate with a workspace API key.

  • Server URL: https://app.magicinsights.ai/api/mcp
  • Transport: Streamable HTTP
  • Auth: API key (bearer token)
  • Official MCP registry: ai.magicinsights/insights

Get an API key

Create one in the app at Settings → API keys (https://app.magicinsights.ai → your workspace → Settings → API keys), then send it as the Authorization: Bearer <key> header.

Connect

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

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project), then enable the server in Cursor settings:

{
  "mcpServers": {
    "magic-insights": {
      "url": "https://app.magicinsights.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Other clients (Claude Desktop, Windsurf, MCP Inspector, …)

Most clients use the same mcpServers block above — check your client's docs for where its config file lives. The Claude API MCP connector accepts the same URL with an authorization_token.

Tools

All tools are read-only and scoped to the workspace that owns the API key.

ToolWhat it does
get_workspaceOne-call overview: plan, study count, connected platforms, tags, total feedback, date range, overall sentiment.
list_studiesList all studies with description and date range.
get_studyA study's summary, generated report, and top themes (with sentiment, ids, and example feedback).
list_topicsA study's topics and the themes grouped under each.
get_theme_feedbackAll feedback under one theme, most relevant first.
list_suggestionsA study's AI-synthesized recommended actions (problem, solution, priority).
get_suggestion_feedbackThe individual feedback behind a single suggestion.
search_feedbackSearch and filter feedback by keyword, sentiment, platform, tag, or date range.
get_feedbackOne feedback item in full — content, translation, AI summary, and source metadata.
get_statsAggregate stats: total count, sentiment breakdown, date range.
get_trendsFeedback volume and sentiment over time, bucketed by week or month.
list_tagsThe workspace's custom tags and how many items carry each.
list_platformsThe source platforms feeding the workspace, each with its feedback count.

About

Magic Insights is an AI-driven customer-feedback analytics platform. Learn more at magicinsights.ai.

The server's metadata is published in the official MCP registry; this repository hosts the public server.json and connection docs. The application source is closed.

الأسئلة الشائعة

ما هو Magic Insights؟

Query your customer feedback: studies, themes, suggestions, tags, and sentiment trends.

كيف أثبّت Magic Insights؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http magic-insights 'https://app.magicinsights.ai/api/mcp' --header 'Authorization: <Bearer <your Magic Insights API key>. Create one at app.magicinsights.ai → Settings → API keys, then send it as: Authorization: Bearer mi_...>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Magic Insights إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Magic Insights مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Magic Insights؟

ينشره andrewchmr. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.