内容
# Magic Insights MCP 服务器
连接任意 [MCP](https://modelcontextprotocol.io) 客户端到您的 [Magic Insights](https://magicinsights.ai) 工作区，并与您的客户反馈 **研究报告** 进行聊天 — 列出研究报告，搜索和筛选反馈，并阅读 AI 生成的主题、话题、建议、标签和情感趋势。
这是一个 **远程、托管** 的 MCP 服务器。无需安装 — 将您的客户端指向下面的 URL，并使用工作区 API 密钥进行身份验证。
- **服务器 URL:** `https://app.magicinsights.ai/api/mcp`
- **传输:** 可流式 HTTP
- **身份验证:** API 密钥（Bearer Token）
- **官方 MCP 注册表:** [`ai.magicinsights/insights`](https://registry.modelcontextprotocol.io/v0/servers?search=ai.magicinsights)
## 获取 API 密钥
在应用中创建，位置在 **设置 → API 密钥** (`https://app.magicinsights.ai` → 您的 工作区 → 设置 → API 密钥)，然后将它作为 `Authorization: Bearer <key>` 头部发送。
## 连接
### Claude 代码
```bash
claude mcp add --transport http magic-insights https://app.magicinsights.ai/api/mcp \
--header "Authorization: Bearer 您的_API_密钥"
```
### Cursor
添加到 `~/.cursor/mcp.json`（所有项目）或 `.cursor/mcp.json`（单个项目），然后在 Cursor 设置中启用服务器：
```json
{
"mcpServers": {
"magic-insights": {
"url": "https://app.magicinsights.ai/api/mcp",
"headers": {
"Authorization": "Bearer 您的_API_密钥"
}
}
}
}
```
### 其他客户端（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](https://magicinsights.ai)。
服务器的元数据发布在 [官方 MCP 注册表](https://registry.modelcontextprotocol.io/v0/servers?search=ai.magicinsights) 中；本仓库托管公共的 `server.json` 和连接文档。应用程序源代码为闭源。
