MCP Ads

오픈소스 마케팅 MCP 서버. Google Ads, Meta Ads, GA4, Search Console, Tag Manager, WordPress 등을 Claude, ChatGPT, Cursor, 또는 모든 MCP 클라이언트에서 실행하세요 — 성과를 읽고, 낭비된 지출을 감사하고, 리포트를 만들고, 캠페인을 시작하세요(명시적으로 요청하기 전까지는 일시중지 상태로 생성됩니다).

약 3,100개의 등록된 액션이 12개 이상의 플랫폼에 걸쳐 있으며, 17개의 카테고리 디스패처를 통해 제공되므로 에이전트는 수천 개 대신 약 20개의 도구 정의만 로드합니다.

원하는 경로를 선택하세요

☁️ 클라우드 — 2분 안에 연결, 무료 티어

mcp-ads.com 으로 이동해 로그인하고, 브라우저에서 광고 계정을 OAuth로 연결한 다음, Claude에 URL 하나를 붙여넣으세요. 완료입니다.

• API 신청, 개발자 토큰, 앱 리뷰가 필요 없습니다 — 플랫폼 승인(Google Ads 개발자 토큰, Meta App Review 등)은 이미 완료되어 있습니다.

• 무료 티어: 모든 플랫폼에서 월 30회 도구 호출. 무제한 사용을 위한 유료 플랜

• 자격 증명은 암호화되어 저장됩니다. 대시보드에서 언제든지 해지할 수 있습니다.

도구를 호스팅하는 대신 사용하려는 거의 모든 사람에게 이것이 올바른 선택입니다.

🔧 셀프호스팅 — 평생 무료, 당신의 키, 당신의 머신

이 저장소를 클론하고 자신의 플랫폼 자격 증명으로 실행하세요. MIT 라이선스, 조건 없음, 전화 집 없음. 토큰은 당신의 머신을 절대 떠나지 않습니다.

솔직한 비용: 여러 광고 플랫폼은 API 접근을 신청하게 합니다(아래 표 참조). 이미 해당 자격 증명이 있다면 — Google Ads 개발자 토큰을 보유한 에이전시, 리뷰를 통과한 Meta 앱을 가진 개발자 — 셀프호스팅은 몇 분이면 충분합니다. 그렇지 않다면 플랫폼 자체 승인 대기열에 며칠에서 몇 주를 예상하거나, 그냥 클라우드를 사용하세요.

어느 쪽이든 같은 코드, 같은 액션. 호스팅 제품은 바로 이 서버에 다중 사용자 인증과 이미 완료된 승인을 더한 것뿐입니다.

Related MCP server: AdLoop: Google Ads, Reddit Ads & GA4

셀프호스팅 퀵 스타트

git clone https://github.com/RoyAzran/mcp-ads.git
cd mcp-ads
pip install -r requirements.txt
cp .env.example .env      # fill in the platforms you use
python server.py doctor   # shows what's connected

그런 다음 Claude Desktop(claude_desktop_config.json) 또는 Claude Code(.mcp.json)에 추가하세요:

{
  "mcpServers": {
    "mcp-ads": {
      "command": "python",
      "args": ["/absolute/path/to/mcp-ads/server.py"]
    }
  }
}

설치는 이것으로 완료입니다. 에이전트에게 *"내 Google Ads 낭비된 지출 감사해 줘"*라고 요청하고 지켜보세요.

Docker를 사용하려면:

cp .env.example .env
docker compose up -d      # HTTP server on 127.0.0.1:8000, MCP endpoint at /mcp

Docker 없이 HTTP 모드: python server.py serve --transport http

Bearer 토큰 플랫폼용 OAuth 도우미(브라우저를 열고 토큰을 저장/자동 갱신):

python server.py auth snapchat_ads

진솔하게, 즉시 사용 가능한 것들

셀프호스팅은 각 플랫폼에 대한 스스로의 키를 보유하는 것을 의미입니다. 어떤 것들은 몇 분이면 내주고, 어떤 것들은 신청하도록 합니다. 실제 그림은 다음과 같습니다 :

만약 저 표가 당신을 지치게 한다면, 클라우드 버전 이 그 위함입니다 — 승인이 완료가 되어 있으니 계좌만 연결하면 됩니다.

도구의 웹 표면이 작동하는 방식

에이전트는 list_actions 기에 더하여 플랫폼마다 하나의 다패처를 확인합니다:

1. list_actions(category="meta_ads_action", search="budget")
2. meta_ads_action(action="<name from step 1>", params={...})

• 쓰기 액션은 명시적으로 실행하라고 하지 않은 이상 항상 일시중지 상태로 생성합니다

• 역할 게이팅 (permissions.py)은 이름으로 읽기 도구와 쓰기 도구를 분리합니다

• --surface full 이러한 모든 모든 액션을 개별 MCP 도구로 등록합니다 — 프로그래밍 방식의 클라이언트에는 유용하지만, чат 클라이언트에는 도구가 너무 많은 방식입니다

NPX CLI

클라이언트 컴퓨터에 Python이 없나요? CLI는 cli/ 있는, 어떤 MCP Ads 서버로 전달하는 약 300줄의 stdio 프록시입니다:

# against your self-hosted server
MCP_ADS_BASE_URL=http://127.0.0.1:8000 npx -y @marketingmcp/cli

# against the cloud (API key from mcp-ads.com/manage)
MCP_ADS_API_KEY=mcp_live_xxx npx -y @marketingmcp/cli

Google Ads Transparency 참고

tools/google_ads_transparency.py는 Google의 공개 Ads Transparency Center를 웹사이트 자체가 사용하는 엔드포인트를 호출해서 읽어들었습니다. Google은 이 데이터에 API를 문서기화하지 않았습니다. 엔드포인트는 사려 통지 없이 변경되거나 거부할 수 있습니다. 그리고 지능적으로 접근하는 것은 Google이 승인하지 않는 것입니다. 이 제품군은 기본적으로 비활성화되어 있습니다 — 해당 모듈의 docstring을 읽은 후에만 GOOGLE_ADS_TRANSPARENCY_ENABLED=true 설정하세요. Meta Ad Library 도구는 Meta의 공식 API를 사용하므로 이런 주의 사항이 없습니다.

보안 자세

• 자격 증명은 .env와 선택적으로 Fernet 암호화 로컬 저장소 (MCP_ADS_SECRET_KEY)에 있습니다. 외부로 전송되는 것 없음: 텔레메트리는 전적으로 옵트인이고, 직접 애널리국 프로젝트를 구성하지 않는 권한 때문에 끄져 있습니다.

• HTTP 모드는 디자인상 인증이 없 동작합니다 (루트백에서 당신만 존재합니다). 서버는 실제 돈을 쓸 수 있는 자격 증명을 들고 있기 때문에, MCP_ADS_ALLOW_PUBLIC_BIND=true를 설정했다가 않는 한 공개 인터페이스에 양도하는 것을 거부합니다.

• CI는 비밀 구조로 트리에 들어오는 것을 실행 실패하는 경계 게이트(tests/test_no_private_imports.py)를 실행합니다.

보고 방법은 SECURITY.md 참조하세요.

기여

이슈와 PR을 환영합니다 — CONTRIBUTING.md를 참조하세요. scripts/에 있는 검사 스크립트가 리뷰 기준입니다: 각 스크립트는 실제 프로덕션에서 발생한 오류를 고정시킵니다. 그리고 PR 전에 코드는 python scripts/check_tools_execute.py 실행하면 리뷰에서 대부분의 인터랙턴 문제를 잡을 수 있습니다.

우리가 도와드릴 수 없는 것은: 플랫폼 API 접근 권한 획득입니다. 그 승인 큐는 Google, Meta, LinkedIn, TikTok, Microsoft의 것입니다.

License

MIT.