TM

tisik79/mcp-facebook

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

13 stars 7 forks 품질 62 트렌드 24

MCP 서버 프로 zadávání vyhodnocování reklamních kampaní na Facebooku pomocí 클로드 AI

개요

Claude AI에서 Facebook 광고를 관리하는 MCP 서버. 수동 토큰 사냥이 없습니다. Facebook과 한 번 로그인하면됩니다. - 캠페인 관리 (창조, 업데이트, 삭제) - 광고 세트 및 개별 광고 - 분석 및 통찰력 - 사용자 정의 및 통계 - 페이지 게시물 - 자동 토큰 관리 (페이지 토큰은 영구) Claude Desktop config 파일을 엽니다. - : ~/Library/Application Support/Claude/claude desktop config.json - : %APPDATA%\Claude\claude desktop config.json 처음 시작하면 마법사가 Facebook 앱을 만들 수 있습니다. 앱 ID와 비밀을 입력한 후, 브라우저는 자동으로 → Facebook →로 로그인합니다. 타겟팅 / 변환 도구 세트의 범위는 Draivix / aidvertaiser (David Strejc, MIT)의 영감을 받았습니다. 감사합니다!

개요(AI 번역)

Česká 버즈

Claude AI에서 Facebook 광고를 관리하는 MCP 서버. 수동 토큰 사냥이 없습니다. Facebook과 한 번 로그인하면됩니다.

특징

  • 캠페인 관리 (create, update, delete)
  • 광고 세트 및 개별 광고
  • 분석 및 통찰력
  • 사용자 정의 및 청중
  • 페이지 게시물
  • 자동 토큰 관리 (페이지 토큰은 영구적입니다)

설치

요구 사항

  • 노드.js 18+
  • Claude 데스크탑

##1. 저장소를 복제

##2. Claude 데스크탑에 추가

Claude Desktop config 파일을 엽니다:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

추가 :

##3. 첫 번째 실행 — 5분 설정

처음 시작하면 마법사가 Facebook 앱을 만들 수 있습니다.

앱 ID와 비밀을 입력한 후, 브라우저는 자동으로 → Facebook →로 로그인합니다.

Re-login / 페이지 추가

Claude의 사용

사용 가능한 도구

도구 설명
connect_facebook_account / set_facebook_token OAuth를 통해 로그인/Graph API Explorer에서 토큰을 저장

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Facebook Ads MCP Server

🇨🇿 Česká verze

MCP server for managing Facebook ads straight from Claude AI. No manual token hunting — sign in with Facebook once and you’re done.

Features

  • Campaign management (create, update, delete)
  • Ad sets and individual ads
  • Analytics and insights
  • Custom and lookalike audiences
  • Page posts
  • Automatic token management (page tokens are permanent)

Installation

Requirements

  • Node.js 18+
  • Claude Desktop

1. Clone the repository

git clone https://github.com/Tisik79/MCP-Facebook.git
cd MCP-Facebook
npm install
npm run build

2. Add to Claude Desktop

Open the Claude Desktop config file:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add:

{
  "mcpServers": {
    "facebook-ads": {
      "command": "node",
      "args": ["/PATH/TO/MCP-Facebook/dist/index.js"]
    }
  }
}

3. First run — 5-minute setup

On first start, a wizard walks you through creating your own Facebook App:

Steps:
  1. Click "Create App"
  2. Choose type: "Business"
  3. Enter any name (e.g. "My Ads")
  4. After creation, go to Settings → Basic
  5. Copy the App ID and App Secret
  6. Add the "Facebook Login" product and set:
     Valid OAuth Redirect URIs: http://localhost:3456/auth/callback
  7. In Basic settings, add "localhost" to App Domains

After entering the App ID and Secret, a browser opens automatically → sign in with Facebook → done.

Re-login / adding pages

node dist/index.js login

Usage in Claude

"Show my active campaigns"
"Create a campaign for MyBrand with a $20 daily budget"
"How did my ads perform last month?"
"Post an update to page XY"

Available Tools

Tool Description
connect_facebook_account / set_facebook_token Sign in via OAuth / store a token from Graph API Explorer
list_connected_accounts / set_active_account Show connected pages & accounts / switch the active one
facebook_setup_help Step-by-step connection guide
get_campaigns List campaigns
create_campaign Create a new campaign
update_campaign Update a campaign (incl. bidStrategy) — read-after-write
get_campaign_details Campaign detail (budget, bid_strategy, spend today)
delete_campaign Delete a campaign
get_campaign_insights Campaign analytics
get_adset_insights / get_ad_insights Ad set / ad level analytics
get_adsets List ad sets
create_ad_set Create an ad set (incl. lead fields promotedObject / destinationType)
update_adset Update an ad set (name / status) — real write + read-after-write verification
get_ads List ads (filtered via adSetId/campaignId edge + status)
get_ad Ad detail incl. creative (link, CTA, copy, video/image)
upload_ad_media Upload an image (image_hash) or video (video_id)
GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "facebook-ads": { "command": "node", "args": ["/PATH/TO/MCP-Facebook/dist/index.js"] } } }