LinkedIn Ads MCP 서버

Claude(Code 또는 Desktop)를 LinkedIn Ads API에 연결하여 캠페인 관리, 타겟팅, 광고 소재 업로드, 분석 및 계정 감사를 자연어로 제어할 수 있게 해주는 MCP 서버입니다.

주요 기능

모범 사례가 내장되어 있어, 모든 쓰기 작업 시 오디언스 확장 및 오디언스 네트워크가 기본적으로 비활성화됩니다.

Related MCP server: LinkedIn Profile MCP Server

사전 요구 사항

• Node.js 18 이상

• Advertising API 액세스 권한이 있는 LinkedIn 개발자 앱 (여기서 신청)

• OAuth 범위: r_ads, rw_ads, r_ads_reporting, r_basicprofile

• LinkedIn 광고 계정 ID

빠른 시작

git clone <this-repo-url>
cd linkedin-ads-mcp-server
npm install
cp .env.example .env
# Edit .env with your LinkedIn credentials
npm run build
npm start

LinkedIn Ads MCP server running — 34 tools registered라는 메시지가 표시되어야 합니다.

Claude에 연결하기

Claude Code (CLI)

~/.claude/settings.json에 다음을 추가하세요:

{
  "mcpServers": {
    "linkedin-ads": {
      "command": "node",
      "args": ["/path/to/linkedin-ads-mcp-server/dist/index.js"],
      "env": {
        "LINKEDIN_ACCESS_TOKEN": "your_token",
        "LINKEDIN_AD_ACCOUNT_ID": "urn:li:sponsoredAccount:123456789"
      }
    }
  }
}

Claude Desktop

%APPDATA%/Claude/claude_desktop_config.json(Windows) 또는 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS)에 동일한 mcpServers 블록을 추가하세요.

설정을 업데이트한 후 Claude를 다시 시작하세요.

사용법

연결이 완료되면 Claude에게 다음과 같이 요청하세요:

• "내 캠페인 그룹 목록을 보여줘"

• "Q3 브랜드 인지도라는 이름의 새 캠페인 그룹을 만들어줘"

• "전체 계정 감사를 실행해줘"

• "이번 달 상위 5개 캠페인에 대한 분석을 보여줘"

• "저장된 모든 타겟팅의 지역을 영국에서 미국으로 바꿔줘"

재시작 없이 다른 광고 계정을 타겟팅하려면 인라인으로 전달하세요:

• "계정 urn:li:sponsoredAccount:987654321의 캠페인 목록을 보여줘"

전체 설정 가이드

다음 내용을 포함한 자세한 지침은 SETUP.md를 참조하세요:

1. LinkedIn 개발자 앱 생성

2. OAuth 토큰 생성

3. 광고 계정 연결

4. Claude Code / Claude Desktop 구성

5. 프로덕션 환경을 위한 토큰 갱신

6. Standard API 티어로 업그레이드

토큰 만료

액세스 토큰은 60일 후에 만료됩니다. 갱신 절차는 SETUP.md 5부를 참조하세요.

라이선스

MIT