谷歌广告MCP服务器（云）
部署到任何Node.js主机（Railway、Render、Fly.io等），并通过以下方式连接 claude.ai.
40个工具：20个读+20个写，用于完整的谷歌广告管理。
快速开始
1.获取Google Ads API证书
- 谷歌云项目 启用了Google Ads API
- OAuth 2.0客户端ID （Web应用程序类型）
- 开发者令牌 来自MCC>工具>API中心
- 刷新令牌 -在本地运行以获取它：
git clone
cd google-ads-mcp-cloud
npm install
# Add http://localhost:8765/callback as redirect URI in Google Cloud Console
# Then get refresh token:
node -e "
const http = require('http');
const CLIENT_ID = 'YOUR_CLIENT_ID';
const CLIENT_SECRET = 'YOUR_CLIENT_SECRET';
const REDIRECT = 'http://localhost:8765/callback';
const server = http.createServer(async (req, res) => {
const url = new URL(req.url, 'http://localhost:8765');
if (url.pathname === '/callback') {
const code = url.searchParams.get('code');
const r = await fetch('https://oauth2.googleapis.com/token', {
method: 'POST',
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
body: new URLSearchParams({ code, client_id: CLIENT_ID, client_secret: CLIENT_SECRET, redirect_uri: REDIRECT, grant_type: 'authorization_code' })
});
const data = await r.json();
res.end('Done! Check terminal.');
console.log('REFRESH TOKEN:', data.refresh_token);
server.close();
}
});
server.listen(8765, () => {
console.log('Open this URL:');
console.log(\`https://accounts.google.com/o/oauth2/v2/auth?client_id=\${CLIENT_ID}&redirect_uri=\${REDIRECT}&response_type=code&scope=https://www.googleapis.com/auth/adwords&access_type=offline&prompt=consent\`);
});
"2.部署
铁路：
railway init
railway variables set GOOGLE_ADS_CLIENT_ID=xxx
railway variables set GOOGLE_ADS_CLIENT_SECRET=xxx
railway variables set GOOGLE_ADS_DEVELOPER_TOKEN=xxx
railway variables set GOOGLE_ADS_REFRESH_TOKEN=xxx
railway variables set GOOGLE_ADS_MCC_ID=1234567890
railway up提供：
- 创建Web服务，连接此仓库
- 从以下位置添加环境变量
.env.example - 构建：
npm install|开始：npm start
Fly.io：
fly launch
fly secrets set GOOGLE_ADS_CLIENT_ID=xxx GOOGLE_ADS_CLIENT_SECRET=xxx GOOGLE_ADS_DEVELOPER_TOKEN=xxx GOOGLE_ADS_REFRESH_TOKEN=xxx GOOGLE_ADS_MCC_ID=1234567890
fly deploy3.连接claude.ai
- 首选 claude.ai>设置>MCP服务器
- 点击 添加MCP服务器
- 输入URL:
https://YOUR_APP.HOST/sse - 完成！克劳德现在可以管理你的谷歌广告了。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
GOOGLE_ADS_CLIENT_ID | 是 | OAuth客户端ID |
GOOGLE_ADS_CLIENT_SECRET | 是 | OAuth客户端密码 |
GOOGLE_ADS_DEVELOPER_TOKEN | 是 | 开发者令牌 |
GOOGLE_ADS_REFRESH_TOKEN | 是 | OAuth刷新令牌 |
GOOGLE_ADS_MCC_ID | 是 | MCC帐户ID |
PORT | 否 | 服务器端口（默认值：8765） |
端点
| 端点 | 描述 |
|---|---|
/sse | MCP客户端的SSE连接（claude.ai） |
/messages | JSON-RPC消息处理程序 |
/health | 健康检查 |
/ | 服务器信息 |
40工具
读（20）： list_accounts、list_campaigns、campaign_performance、ad_group_performance、关键字_performility、ad_performances、search_terms_report、get_ampaign_structure、get_ad_group_ads、get_geo_performability、get_device_performity、get_age_gender_performance、get_quality_scores、get_conversion_actions、get_campaign_budget_tails、get_bidding_strategy_tails、get_change_history、run_gaql_query、get_location_targets、search_geo_targets
写（20）： create_search_campign、create_pmax_campaign、create_ad_group、create_responsive_search_ad、add_keywords、add_negative_key words、remove_key wordes、remove_negative\_ key words和update_campaign_status、update_campign_budget、update_camp ign_name、update_bidding_strategy、update_ad_group_bid、update_key word_status、update_keyword_bid、remove_ad、add sitelinks、set_location_targets和remove_location_ttargets
健康检查
curl https://YOUR_APP.HOST/health
# {"status":"ok","tools":40,"sessions":0}