摘要
让你的 AI 以只读方式分析你的 Yandex Direct 广告：广告系列、广告组、广告、关键词和出价、附加链接和宣传信息、代理商客户、字典、变更跟踪，以及按日、广告系列、广告或搜索词划分的统计报告。
引导式设置
2 分钟将 Yandex Direct 连接到 Microsoft Copilot
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Yandex Direct，再把你的 MCP URL 添加到 Microsoft Copilot。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Yandex Direct 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Yandex Direct、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Yandex Direct + Microsoft Copilot
让你的 AI 以只读方式分析你的 Yandex Direct 广告：广告系列、广告组、广告、关键词和出价、附加链接和宣传信息、代理商客户、字典、变更跟踪，以及按日、广告系列、广告或搜索词划分的统计报告。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
YANDEX_DIRECT_TOKEN
步骤 1 — 获取凭证
设置大约需要 10 分钟，另外还要等待 Yandex 批准 API 访问（从一小时到几个工作日不等）。你需要一个至少有一个广告系列的 Yandex Direct 账号，以及一个在 oauth.yandex.ru 上注册的自有应用。
- 在 oauth.yandex.ru 注册一个应用：平台选择网页服务，权限选择 Yandex Direct API（
direct:api）。记下它的 ClientID。 - 在 Yandex Direct 网页界面中打开 Tools → API，为该 ClientID 提交 API 访问申请，并接受 API 用户协议。在 Yandex 批准申请之前，调用会以错误 58 失败。
- 用 Direct 账号登录后，打开填入你的 ClientID 的
https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>，把access_token（以 y0_ 开头）复制到YANDEX_DIRECT_TOKEN，前面不要加 Bearer 或 OAuth。令牌有效期约一年，持续使用时会自动延长。 - 仅限代理商：把
YANDEX_DIRECT_CLIENT_LOGIN设为要读取的广告主的 Yandex 登录名；yandex_direct_list_agency_clients会列出这些登录名。如果是你自己的账号，请留空。 - 安装连接器并运行
yandex_direct_get_client：它会显示账号、登录名和币种。
可读取的内容：广告系列的类型、状态、投放状态、日期、资金、累计点击和展示次数以及出价策略；广告组及其地区和否定关键词；广告的标题、正文和链接；关键词和自动定向及其出价和效果指数；关键词出价，包括搜索中每个位置所需的出价和流量；附加链接、宣传信息、共享否定关键词集和再营销列表；代理商客户；货币、地区等字典；自某一时刻以来发生变化的广告系列；以及按日、广告系列、广告或搜索词划分的统计报告。
报告：yandex_direct_get_report 返回以制表符分隔的文本，第一行是列名，金额为小数。小报告会立即返回。较大的报告在离线模式下生成：AI 会在 Yandex 给出的等待时间之后用相同参数再次请求。离线报告最多可排队 5 个，搜索词报告只能离线生成，且只覆盖最近 180 天。
金额和分页：出价、预算和资金以微单位整数返回（2500000 = 账号币种的 2.50）。列表默认最多返回 500 个对象，上限为 10,000 个；广告组、广告和关键词每次调用最多读取 10 个广告系列。
刻意设计为只读：所有工具都只读取。不会创建、修改、暂停或支付任何内容，因此没有需要确认的操作，安装时也没有被关闭的工具。
限制：每次调用都会消耗广告主每日额度中的 API 点数，失败的调用消耗 20 点。AI 会优先用一次调用带多个 ID，而不是多次单独调用，并且只请求需要的字段。错误 152 表示今天的点数已用完；506 表示同时进行的请求过多。
常见错误：53 表示令牌无效或已过期：请按第 3 步重新获取。58 表示应用的 API 访问尚未获批。54、3000 或 3001 表示没有 API 访问权限或没有权限，例如令牌无权读取某个客户登录名。513 表示该登录名未连接到 Direct。8000 以及 4000 到 4006 表示参数错误，8800 表示找不到对象，9300 表示单次调用中的 ID 过多。
该连接器不会创建或编辑广告系列、广告、关键词或出价，不处理审核、预算或付款，也不使用 Sandbox 或 Wordstat。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name（例如
AnythingMCP）、说明连接器用途的 Server description，以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key，把 Type 设为 Header，请求头名称填
X-API-Key，然后选择 Create。 - 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试：提出需要用到
Yandex Direct的工具的请求。 - 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
yandex_direct_get_client | Read the advertiser account the token acts for (or the Client-Login one): ClientId, Login, ClientInfo (name), Currency, CountryId, Type… |
yandex_direct_list_campaigns | List campaigns: Id, Name, Type (TEXT_CAMPAIGN, UNIFIED_CAMPAIGN, SMART_CAMPAIGN, MOBILE_APP_CAMPAIGN, CPM_BANNER_CAMPAIGN ...), Status… |
yandex_direct_list_ad_groups | List ad groups of up to 10 campaigns (or by id): Id, Name, CampaignId, Type, Status, ServingStatus, RegionIds, NegativeKeywords… |
yandex_direct_list_ads | List ads of up to 10 campaigns, up to 1000 ad groups, or by id: Id, CampaignId, AdGroupId, Type, Status, State, StatusClarification, and… |
yandex_direct_list_keywords | List keywords and autotargeting of up to 10 campaigns, up to 1000 ad groups, or by id: Id, Keyword, State, Status, ServingStatus… |
yandex_direct_list_keyword_bids | Read keyword bids with the auction picture: for each keyword the search and network bid and, on search, the bids and traffic volume needed… |
yandex_direct_list_sitelinks | Read sitelink sets by id (SitelinkSetId from yandex_direct_list_ads): each sitelink's Title, Href and Description |
yandex_direct_list_ad_extensions | List ad extensions (callouts) of the account: Id, Type, Status, Associated and the callout text |
yandex_direct_list_negative_keyword_sets | Read shared negative keyword sets by id (NegativeKeywordSharedSetIds of campaigns and ad groups): Id, Name, NegativeKeywords, Associated |
yandex_direct_list_retargeting_lists | List retargeting and audience lists: Id, Name, Type, Description, Rules (Metrica goals and segments), IsAvailable, Scope |
yandex_direct_list_agency_clients | For agency accounts: list the agency's advertisers with Login, ClientId, ClientInfo, Currency and Archived |
yandex_direct_get_dictionaries | Read reference dictionaries: Currencies (with bid limits), GeoRegions (region ids used in RegionIds), TimeZones, Constants, AdCategories… |
yandex_direct_check_campaign_changes | Which campaigns changed since a moment: for each changed campaign, whether the campaign itself (SELF), its groups, ads or keywords… |
yandex_direct_get_report | Run a statistics report (Reports service) and return it as tab-separated text: a column header row, one row per line, money as decimals in… |
示例提示
- “我的广告系列上周表现如何？按广告系列列出展示、点击、CTR、花费和转化。”
- “过去 30 天里，哪些搜索词花费最多却没有带来一次转化？”
- “列出‘冬季轮胎’广告系列的关键词及其出价，并告诉我要进入靠前位置需要出多少价。”
- “我的哪些广告目前被拒登或没有在展示？原因是什么？”
- “我们是代理商：列出我们的客户，并显示客户 romashka-shop 昨天的花费。”
FAQ
这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?