内容
# 直接管理器 — MCP 用于 Yandex 直接
[](https://www.npmjs.com/package/marketscore-direct-mcp)
[](./LICENSE)
[](https://glama.ai/mcp/servers/marketscore/marketscore-direct-mcp)
> 将 **Claude** 或 **ChatGPT** 连接到 Yandex 直接并在对话中管理广告：「哪里浪费了钱？」→ 助手会找到ROAS < 1的活动并建议关闭哪些活动。
>
> 将 Claude 或 ChatGPT 连接到 Yandex 直接并在聊天中管理广告活动：分析，浪费支出检测，出价，预算，否定关键词。
**[免费试用 — 7 天「专业」套餐 →](https://app.marketscore.ru/register)**
**网站：** https://app.marketscore.ru
<!-- TODO(所有者)：添加与 Claude 的对话截图或 GIF — 主要优点 -->
---
## 什么是
`marketscore-direct-mcp` — 连接到托管的直接管理器 MCP 服务器的薄连接器。服务器本身，Direct API 访问权限和所有逻辑都位于服务侧 — 此包仅连接您的 AI 助手。
工作方式如下：
> **您：** 最近 14 天我在哪里浪费了钱？
>
> **Claude：** 找到了 3 个问题，价值 12,400 ₽：活动「装修 - РСЯ」花费了 4,210 ₽ 没有转化；平台 dsp.example 的 ROAS 为 0.2；6 个关键词有花费但没有转化。是否关闭该平台并将关键词添加到否定词库？
## 功能
**77 种工具** 基于 Direct API v5 和 Reports API（在「助手」和「专业」套餐中为 76 种，在「机构」套餐中为 77 种，包括投资组合 `accounts_overview`）：
- **分析和统计** — 活动在不同时间段和维度下的指标：设备，性别，年龄，РСЯ 平台，地理位置；搜索查询；展示份额。
- **无效支出检测** — ROAS < 1 的活动，无转化支出的活动，多余的平台和关键词。
- **管理** — 暂停/恢复，日预算和周预算，策略（包括目标转化和 CPA/ROAS 目标），否定关键词，关键词，出价和调整。
- **从零开始创建活动** — 活动 → 分组 → 广告，快速链接和 UTM 参数。
- **AI 推理** — 未来 30 天的支出和转化预测，流量/转化率/CPC 下降诊断，周期变化解释，驱动因素排名，价值最高的发现，准备好的每周报告。
- **Wordstat** — 关键词选择与频率分析。
- **机构** — 账户投资组合概览：所有客户的支出，利润，多余支出和预算余额。
所有写入操作均带有注释 — 助手和客户可以看到具体更改内容，并在应用更改前确认。Direct API 错误被正确处理，包括「静默」错误（API 返回 200 但更改未应用）。
## 安装
### Claude（桌面版，网页版，Code）和 ChatGPT — 通过链接
添加远程 MCP 连接器：
```
https://app.marketscore.ru/api/mcp
```
助手将打开登录页面 — 通过 OAuth 登录。您的 Yandex 令牌不会传递给助手。
### 本地 MCP 客户端（Cursor，VS Code，Cline，Zed）— 通过桥梁
```bash
npx -y marketscore-direct-mcp
```
MCP 客户端配置示例：
```json
{
"mcpServers": {
"direct-manager": {
"command": "npx",
"args": ["-y", "marketscore-direct-mcp"]
}
}
}
```
## 套餐和访问权限
连接器需要一个 **直接管理器** 账户。注册后提供 **7 天「专业」套餐免费试用**（包括 Claude/ChatGPT 中的 AI 助手）。之后：
- **「助手」 — 990 ₽/月：** 完整的 MCP 工具包（76 种工具）用于从聊天中工作，支持最多 3 个直接账户。无网页仪表盘 — 仅限助手。
- **「专业」 — 1,990 ₽/月：** 76 种工具 **加上** 网页仪表盘和分析，支持最多 5 个直接账户。
- **「机构」 — 9,900 ₽/月：** 77 种工具（包括投资组合概览 `accounts_overview`），支持最多 20 个直接账户。
无有效套餐时，服务器提供 0 种工具。注册：https://app.marketscore.ru/register · 套餐：https://app.marketscore.ru/pricing
## 与开放源代码 Direct API 封装器的区别
存在自托管的 Direct API 封装器（例如 mcp-yandex-direct）。诚实的比较：
| | 直接管理器（此连接器） | 自托管封装器 |
|---|---|---|
| 安装 | OAuth 登录链接 | 获取直接令牌并将其写入配置文件 |
| AI 推理，审计，自动驾驶 | 有（预测，诊断，报告，最高发现） | 无 — 仅原始 API 调用 |
| 网页仪表盘和 Telegram 机器人 | 有 | 无 |
| 账户投资组合 | 有（所有客户概览） | 无 |
| 价格 | 订阅（7 天免费） | 免费，但需要自行配置和托管 |
| Yandex 令牌存储位置 | 在服务侧，客户端配置文件中没有 | 在客户端配置文件中 |
## 安全性
- 授权 — **OAuth 2.1**：Yandex 令牌不会传递给助手或存储在客户端配置文件中，它存储在服务侧。
- 更改直接管理器账户密码会撤销所有已颁发的 MCP 访问权限。
- 所有写入操作均带有注释，并在 MCP 客户端侧确认。
- 个人数据存储在俄罗斯联邦的服务器上（根据 152-FZ 法规）。
## 常见问题
**这是免费的吗？** 前 7 天是（注册时的「专业」套餐试用）。之后 — 从「助手」（990 ₽/月，MCP-only）及更高套餐。
**直接令牌去哪了？** 它由直接管理器服务在 OAuth 登录过程中颁发并存储在其服务器上。助手和 MCP 客户端看不到令牌。
**助手会破坏我的账户吗？** 写入工具单独注释，MCP 客户端在运行它们之前请求确认。自动驾驶不会单独暂停活动或预算 — 仅按您的命令。
**与 ChatGPT，Cursor，VS Code 兼容吗？** 是的：Claude 和 ChatGPT 直接通过 URL 连接，Cursor/VS Code/Cline/Zed 通过此软件包（`npx -y marketscore-direct-mcp`）。
**与免费的 MCP 封装器有什么区别？** 除了 API 访问权限 — AI 推理层，审计，仪表盘，Telegram 机器人和账户投资组合；Yandex 令牌不存储在配置文件中。更多信息请参见上面的表格。
**无订阅的情况下是否有效？** 否 — 无有效套餐时，服务器提供 0 种工具。
## Docker
```bash
docker build -t marketscore-direct-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-direct-mcp
```
OAuth-URL 在 stdout 中打印 — 容器内的浏览器不会打开，请手动跳转到链接。`mcp-remote` 令牌存储在 `~/.mcp-auth` 中 — 请安装 volume 以避免每次启动都重新授权。
## 有用的链接
- 什么是直接的 MCP 服务器：https://app.marketscore.ru/blog/mcp-server-yandex-direct
- 2026 年 Yandex 直接的 AI 工具：https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026
- 通过 Claude 和 ChatGPT 管理直接：https://app.marketscore.ru/blog/upravlenie-yandex-direct-cherez-claude-chatgpt
---
## 许可
MIT — 见 [LICENSE](./LICENSE)。连接器开源；直接管理器服务是付费 SaaS。 / 连接器开源；直接管理器服务是付费 SaaS。
