AppLovin MCP

AppLovin MCP는 AI 도구가 외부 데이터에 안전하게 액세스하고 귀하를 대신하여 조치를 취할 수 있도록 하는 개방형 표준인 Model Context Protocol(MCP)을 사용하여 AppLovin Ads 플랫폼을 AI 어시스턴트(예: Claude Desktop, Claude Code, Cursor 등)에 연결합니다.

연결되면 dashboard를 클릭할 필요 없이 자연어로 원하는 내용을 설명하여 캠페인을 관리하고 리포팅을 추출할 수 있습니다.

제한적 베타. AppLovin MCP 및 Campaign Management API는 화이트리스트 전용입니다. 액세스를 요청하려면 AppLovin 담당 계정 팀에 문의하세요.

준비 사항

동일한 AppLovin Ads Manager 계정에 대한 AppLovin Campaign Management API key 및 Reporting API key
MCP 호환 어시스턴트 — Claude Desktop, Claude Code, Cursor 또는 MCP를 지원하는 기타 클라이언트

1단계 — API key 가져오기

AppLovin Ads Manager(ads.applovin.com)에 로그인하고 Account → API keys를 클릭합니다. Campaign Management API key와 Reporting API key가 모두 여기에 나열되어 있으므로 페이지에서 복사하세요.

info

Note

계정 관리자만 이 페이지에 액세스할 수 있습니다. 관리자 사용자가 아닌 경우 관리자에게 문의하여 키 액세스 권한을 요청하세요.

error

API key를 비밀로 유지하세요!

이 키를 가진 사람은 누구나 캠페인을 읽고 수정할 수 있습니다. 키가 유출된 경우 dashboard에서 즉시 취소하세요.

2단계 — 어시스턴트 연결하기

어시스턴트에 맞는 코드 스니펫을 선택하세요. 하나만 필요합니다.

다른 MCP 호환 클라이언트의 경우 동일한 실행 명령인 npx -y applovin-mcp@latest — 를 사용하고 두 개의 API key를 환경 변수로 전달하세요.

Claude Desktop

다음 파일을 편집합니다. ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "applovin-mcp": {
      "command": "npx",
      "args": ["-y", "applovin-mcp@latest"],
      "env": {
        "APPLOVIN_CAMPAIGN_MANAGEMENT_API_KEY": "«YOUR_MANAGEMENT_KEY»",
        "APPLOVIN_REPORTING_API_KEY": "«YOUR_REPORTING_KEY»"
      }
    }
  }
}

Claude Code

터미널에서 한 번 실행하세요:

claude mcp add applovin-mcp \
  --env APPLOVIN_CAMPAIGN_MANAGEMENT_API_KEY=«YOUR_MANAGEMENT_KEY» \
  --env APPLOVIN_REPORTING_API_KEY=«YOUR_REPORTING_KEY» \
  -- npx -y applovin-mcp@latest

Cursor

다음 파일을 편집합니다. ~/.cursor/mcp.json (전역) 또는 .cursor/mcp.json (프로젝트):

{
  "mcpServers": {
    "applovin-mcp": {
      "command": "npx",
      "args": ["-y", "applovin-mcp@latest"],
      "env": {
        "APPLOVIN_CAMPAIGN_MANAGEMENT_API_KEY": "«YOUR_MANAGEMENT_KEY»",
        "APPLOVIN_REPORTING_API_KEY": "«YOUR_REPORTING_KEY»"
      }
    }
  }
}

info

편집 후 다시 시작

설정을 저장한 후 어시스턴트를 다시 시작하여 새 MCP 서버를 가져오도록 하세요.

3단계 — 시도해 보기

평소 dashboard에서 수동으로 수행하던 모든 작업을 MCP에 요청해 보세요.

어디서부터 시작해야 할지 모르겠다면, 아래의 예시 명령어를 참고해 보세요.

“AppLovin Ads Manager에서 가장 최근 캠페인 5개를 나열해 줘.”
“가장 큰 캠페인의 예산을 하루 $5000로 조정해 줘.”
“지출이 가장 많은 캠페인을 복제하고 이 크리에이티브 세트 URL로 교체해 줘.”
“ROAS 100%의 디스커버리 캠페인을 생성해 줘. 지출이 가장 많은 캠페인과 동일한 광고 및 크리에이티브 세트 구조를 사용해 줘.”
“이 비디오 5개를 업로드하고 내 크리에이티브 세트에 첨부해 줘: [URL 삽입].”
“지난주 캠페인별 ROAS를 추출해 줘.”

위 명령어 중 하나라도 정상적으로 실행되면 연결이 완료된 것입니다. 만약 tool not found가 표시되거나 아무런 반응이 없다면, 아래의 문제 해결 방법을 참고해 주세요.

구성

APPLOVIN_CAMPAIGN_MANAGEMENT_API_KEY (필수) — 관리 API key입니다.
APPLOVIN_REPORTING_API_KEY (필수) — 동일한 계정의 리포팅 API key입니다.
APPLOVIN_READONLY (선택 사항, 기본값 false) — 모든 쓰기 도구를 비활성화하려면 true로 설정하세요. 어시스턴트가 캠페인을 읽기만 하고 수정하지 못하도록 하려는 경우에 유용합니다.

안전성

AppLovin MCP는 공개 AppLovin Axon API를 감싸는 타입화된 래퍼입니다. 데이터를 반환하고 쓰기 작업을 전달할 뿐, 캠페인 전략을 제공하지는 않습니다. 어시스턴트의 최적화 제안은 LLM의 해석일 뿐, AppLovin의 공식 권장 사항이 아닙니다.

이 도구를 통해 계정에 취해진 모든 조치에 대한 책임은 귀하에게 있습니다. 잠재적으로 중단될 수 있는 작업(일시 중지, 예산 변경, 삭제)을 승인하기 전에 어시스턴트가 제안하는 내용을 검토하세요.

문제 해결

어시스턴트가 서버를 인식하지 못함

설정을 편집한 후 어시스턴트를 다시 시작하세요.
Node 22 이상이 설치되어 있는지 확인하세요: node --version.

401 / 403 인증 오류

두 키 모두 동일한 AppLovin Ads Manager 계정에 속해야 합니다. 각 키를 완전히 복사했는지 다시 한번 확인하세요.

“Schema mismatch” 또는 “unrecognized key”

이는 일반적으로 AppLovin Axon API에 필드가 추가되었음을 의미합니다. @latest 고정은 실행할 때마다 강제로 업데이트를 수행하므로 어시스턴트를 다시 시작하세요.
문제가 지속되나요? npx clear-npx-cache를 실행하고 다시 시작하세요. 지원팀에 문의할 경우 오류에 표시된 Trace ID를 포함해 주세요.

도움 받기

AppLovin Axon API 또는 계정 관련 질문은 AppLovin 담당 계정 팀에 문의하세요. MCP 문제의 경우 오류에 표시된 Trace ID를 공유해 주시면 담당 팀에서 요청을 추적할 수 있습니다.

Asset Reporting API

FAQ

운영정책 이용약관 퍼블리셔 정책 디맨드 파트너 정책 플랫폼 규제 프라이버시 Your Privacy Choices

쿠키설정