MCP server for Apple Search Ads API v5 — manage campaigns, keywords, budgets, and reports through AI assistants
接入配置
选择客户端,复制配置,再按项目文档补齐环境变量。
claude 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>' -- npx -y apple-ads-mcp~/.codex/config.toml
[mcp_servers.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>" }
# 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>' -- npx -y apple-ads-mcp~/.cursor/mcp.json
{
"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>"
}
}
}
}.vscode/mcp.json
{
"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>"
}
}
}
}~/.gemini/settings.json
{
"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>"
}
}
}
}claude_desktop_config.json
{
"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>"
}
}
}
}.trae/mcp.json
{
"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_CLIENT_IDASA_TEAM_IDASA_KEY_IDASA_PRIVATE_KEY_PATH
把占位值换成你自己的密钥;不要把密钥提交到代码仓库。