AI导哈

Google Ads管理服务器

Google Ads MCP Server (Cloud)是一个用于全面管理Google Ads的服务器解决方案，提供40种工具（20种读取和20种写入）用于广告账户、广告系列、广告组等的管理和优化。

  • by manak-debug
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 manak-debug/google-ads-mcp-cloud

使用说明

谷歌广告MCP服务器（云）

部署到任何Node.js主机（Railway、Render、Fly.io等），并通过以下方式连接 claude.ai.

40个工具：20个读+20个写，用于完整的谷歌广告管理。

快速开始

1.获取Google Ads API证书

  1. 谷歌云项目 启用了Google Ads API
  2. OAuth 2.0客户端ID （Web应用程序类型）
  3. 开发者令牌 来自MCC>工具>API中心
  4. 刷新令牌 -在本地运行以获取它：
git clone <this-repo>
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 deploy

3.连接claude.ai

  1. 首选 claude.ai>设置>MCP服务器
  2. 点击 添加MCP服务器
  3. 输入URL: https://YOUR_APP.HOST/sse
  4. 完成！克劳德现在可以管理你的谷歌广告了。

环境变量

变量 必填 描述
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}

相关 MCP