apple-ads — MCP-сервер для Claude Code: что делает и установка
MCP-сервер управляет кампаниями Apple Search Ads через API v5: меняет бюджеты и ключевые слова, запускает отчёты. Подойдёт для работы из чата.
claude mcp add --env ASA_CLIENT_ID=<ASA_CLIENT_ID> --env ASA_TEAM_ID=<ASA_TEAM_ID> --env ASA_KEY_ID=<ASA_KEY_ID> --env ASA_PRIVATE_KEY_PATH=<ASA_PRIVATE_KEY_PATH> --env ASA_ORG_ID=<ASA_ORG_ID> --transport stdio apple-ads -- npx -y apple-ads-mcpЧто делает apple-ads
apple-ads подключает Apple Search Ads API v5 к MCP-клиенту. Через него можно создавать, менять, приостанавливать и удалять кампании и группы объявлений, редактировать ставки, целевые и минус-слова, управлять креативами и бюджетами.
Сервер даёт инструменты для отчётов по кампаниям, группам, ключевым словам, объявлениям и географии, а также для анализа поисковых запросов и доли показов. Доступны переключение между организациями и работа через естественные запросы.
Для подключения нужны ASA_CLIENT_ID, ASA_TEAM_ID, ASA_KEY_ID и путь к приватному ключу ASA_PRIVATE_KEY_PATH; их выдаёт Apple Search Ads API. Без этих учётных данных сервер не подключится, а для API-администратора нужен отдельный Apple ID от учётной записи администратора.
Какие задачи решает
- управлять кампаниями Apple Search Ads
- менять ставки и минус-слова
- собирать отчёты по рекламе
- анализировать поисковые запросы
- переключаться между организациями
Примеры запросов агенту
- Покажи отчёт по кампаниям и группам объявлений за прошлую неделю.
- Приостанови кампанию бренда и увеличь её бюджет до указанного значения.
- Найди поисковые запросы с хорошими результатами и добавь подходящие как точные ключевые слова.
Как установить apple-ads
Командой платформы
claude mcp add --env ASA_CLIENT_ID=<ASA_CLIENT_ID> --env ASA_TEAM_ID=<ASA_TEAM_ID> --env ASA_KEY_ID=<ASA_KEY_ID> --env ASA_PRIVATE_KEY_PATH=<ASA_PRIVATE_KEY_PATH> --env ASA_ORG_ID=<ASA_ORG_ID> --transport stdio apple-ads -- npx -y apple-ads-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add apple-ads --env ASA_CLIENT_ID=<ASA_CLIENT_ID> --env ASA_TEAM_ID=<ASA_TEAM_ID> --env ASA_KEY_ID=<ASA_KEY_ID> --env ASA_PRIVATE_KEY_PATH=<ASA_PRIVATE_KEY_PATH> --env ASA_ORG_ID=<ASA_ORG_ID> -- npx -y apple-ads-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"apple-ads": {
"command": "npx",
"args": [
"-y",
"apple-ads-mcp"
],
"env": {
"ASA_CLIENT_ID": "<ASA_CLIENT_ID>",
"ASA_TEAM_ID": "<ASA_TEAM_ID>",
"ASA_KEY_ID": "<ASA_KEY_ID>",
"ASA_PRIVATE_KEY_PATH": "<ASA_PRIVATE_KEY_PATH>",
"ASA_ORG_ID": "<ASA_ORG_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"apple-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"apple-ads-mcp"
],
"env": {
"ASA_CLIENT_ID": "<ASA_CLIENT_ID>",
"ASA_TEAM_ID": "<ASA_TEAM_ID>",
"ASA_KEY_ID": "<ASA_KEY_ID>",
"ASA_PRIVATE_KEY_PATH": "<ASA_PRIVATE_KEY_PATH>",
"ASA_ORG_ID": "<ASA_ORG_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ASA_CLIENT_ID=<ASA_CLIENT_ID> -e ASA_TEAM_ID=<ASA_TEAM_ID> -e ASA_KEY_ID=<ASA_KEY_ID> -e ASA_PRIVATE_KEY_PATH=<ASA_PRIVATE_KEY_PATH> -e ASA_ORG_ID=<ASA_ORG_ID> apple-ads npx -y apple-ads-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о apple-ads
Как установить apple-ads в Claude Code?
Выполните `claude mcp add apple-ads -e ASA_CLIENT_ID=<ASA_CLIENT_ID> -e ASA_TEAM_ID=<ASA_TEAM_ID> -e ASA_KEY_ID=<ASA_KEY_ID> -e ASA_PRIVATE_KEY_PATH=<ASA_PRIVATE_KEY_PATH> -- npx -y apple-ads-mcp`.
Что делает apple-ads?
Он подключает Claude Code и другие MCP-клиенты к Apple Search Ads API v5. Сервер управляет кампаниями, ключевыми словами, бюджетами и отчётами.
Что нужно для работы apple-ads?
Нужны идентификаторы Apple Search Ads API и приватный ключ в формате PEM. Для нескольких организаций можно использовать ASA_ORG_ID или переключать организацию во время работы.
