Magic Insights

Magic Insights MCP 服务

将任意 MCP 客户端连接到你的 Magic Insights 工作区，并与客户反馈研究对话——列出研究、搜索和筛选反馈，并查看 AI 生成的主题、话题、建议、标签和情感趋势。

这是一个远程托管的 MCP 服务。无需安装任何内容——将客户端指向下方的 URL，并使用工作区 API 密钥进行身份验证。

• 服务 URL： https://app.magicinsights.ai/api/mcp
• 传输方式： Streamable HTTP
• 身份验证： API 密钥（bearer token）
• 官方 MCP 注册表： ai.magicinsights/insights

获取 API 密钥

在应用中通过 Settings → API keys 创建密钥（https://app.magicinsights.ai → 你的工作区 → Settings → API keys），然后将其作为 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（单个项目），然后在 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 连接器接受相同的 URL，并使用 authorization_token。

工具

所有工具均为只读，且仅限于拥有该 API 密钥的工作区。

工具	功能
get_workspace	一次调用即可概览：套餐、研究数量、已连接平台、标签、反馈总数、日期范围和整体情感。
list_studies	列出所有研究及其描述和日期范围。
get_study	查看某项研究的摘要、生成的报告和热门主题（含情感、ID 和反馈示例）。
list_topics	列出某项研究的话题及归入各话题的主题。
get_theme_feedback	查看某个主题下的所有反馈，并按相关性从高到低排列。
list_suggestions	查看某项研究中由 AI 综合生成的推荐操作（问题、解决方案、优先级）。
get_suggestion_feedback	查看单条建议背后的具体反馈。
search_feedback	按关键词、情感、平台、标签或日期范围搜索和筛选反馈。
get_feedback	查看一条完整的反馈——内容、译文、AI 摘要和来源元数据。
get_stats	汇总统计数据：总数、情感分布和日期范围。
get_trends	按周或月汇总反馈量和情感变化趋势。
list_tags	列出工作区的自定义标签及每个标签对应的条目数。
list_platforms	列出向工作区提供数据的来源平台及各自的反馈数量。

关于

Magic Insights 是一个由 AI 驱动的客户反馈分析平台。访问 magicinsights.ai 了解详情。

该服务的元数据已发布在官方 MCP 注册表；本仓库提供公开的 server.json 和连接文档。应用程序源代码不开源。