Instagram Ads MCP Server

Meta Marketing API를 래핑하여 Instagram 광고를 생성/수정/조회/삭제할 수 있는 MCP 서버입니다.

사용 방법

Cursor에서 로컬 실행 (권장)

.cursor/mcp.json (또는 전역 ~/.cursor/mcp.json)에 추가:

{
  "mcpServers": {
    "instagram-ads": {
      "command": "node",
      "args": ["/절대경로/meta-mcp/dist/stdio.js"],
      "env": {
        "META_ACCESS_TOKEN": "내_Meta_System_User_토큰"
      }
    }
  }
}

각 사용자가 자기 토큰을 설정하면 됩니다. 서버 공유 불필요.

Claude Desktop

claude_desktop_config.json에 동일 형식으로 추가.

HTTP 서버 (원격/공유 용도)

여러 사용자가 하나의 서버를 공유할 때 사용합니다:

MCP_AUTH_TOKEN="서버_인증_토큰" npm start

각 사용자는 X-Meta-Access-Token 헤더로 자기 Meta 토큰을 전달합니다:

{
  "mcpServers": {
    "instagram-ads": {
      "url": "https://서버주소/mcp",
      "headers": {
        "Authorization": "Bearer 서버_인증_토큰",
        "X-Meta-Access-Token": "내_Meta_토큰"
      }
    }
  }
}

Related MCP server: ,

설치

git clone https://github.com/hjsh200219/meta-mcp.git
cd meta-mcp
npm install
npm run build

MCP 도구 목록 (22개)

환경변수

Meta Access Token 발급

1. Meta Business Suite → 비즈니스 설정

2. 시스템 사용자 생성 → 토큰 발급

3. 권한: ads_management, ads_read, business_management

테스트

npm test

기술 스택

Node.js 20, TypeScript (strict), @modelcontextprotocol/sdk, Express 5, Zod 4, pino, Vitest, Docker