페이스북 광고 MCP 서버

이 프로젝트는 Facebook 광고에 대한 인터페이스 역할을 하는 MCP 서버를 제공하여 Facebook 광고 데이터와 관리 기능에 대한 프로그래밍 방식 액세스를 가능하게 합니다.

귀하의 브라우저는 비디오 태그를 지원하지 않습니다.

간편한 원클릭 설정

더욱 간편한 설정을 위해 바로 사용 가능한 설치 프로그램을 제공합니다.

⊞ Windows: 👉 gomarble_mcp_tools.exe 다운로드
 MacOS: 👉 gomarble_mcp_tools.pkg 다운로드

그것이 하는 일

MCP 서버를 로컬로 설치하고 구성합니다.
환경 설정을 자동으로 처리합니다
프로세스 중에 Facebook 토큰 인증을 위한 프롬프트가 표시되며 이는 선택 사항입니다.
Facebook 액세스 토큰이 제공되지 않으면 GoMarble 서버에 연결하여 사용자를 대신하여 토큰을 생성하세요.

중요 면책 조항

이 설정에서는 Facebook 개발자 액세스 토큰을 수동으로 얻을 필요가 없습니다 .

대신, GoMarble 서버에 안전하게 연결하여 사용자를 대신하여 토큰을 생성합니다 . GoMarble은 토큰을 저장하지 않고 , MCP 서버에서 사용할 수 있도록 사용자 컴퓨터에 로컬로 저장합니다.

설정

필수 조건

파이썬 3.10+
requirements.txt 에 나열된 종속성

(선택 사항이지만 권장됨) 가상 환경 만들기 및 활성화:지엑스피1가상 환경을 사용하면 프로젝트 종속성을 깔끔하게 관리하는 데 도움이 됩니다. [출처]
종속성 설치:
pip install -r requirements.txt
Facebook 액세스 토큰 획득: 필요한 권한(예: ads_read )을 부여하여 Facebook 사용자 액세스 토큰을 확보하세요. Facebook 개발자 포털을 통해 생성할 수 있습니다. 다음 링크를 클릭하세요.

MCP 클라이언트(예: Cursor, Claude Desktop)와 함께 사용

이 서버를 MCP 호환 클라이언트와 통합하려면 다음과 유사한 구성( Claude )을 추가하세요. YOUR_FACEBOOK_ACCESS_TOKEN 실제 토큰으로 바꾸고, 필요한 경우 server.py 경로를 조정하세요.

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_FACEBOOK_ACCESS_TOKEN"
      ]
      // If using a virtual environment, you might need to specify the python executable within the venv:
      // "command": "/path/to/your/fb-ads-mcp-server/venv/bin/python",
      // "args": [
      //   "/path/to/your/fb-ads-mcp-server/server.py",
      //   "--fb-token",
      //   "YOUR_FACEBOOK_ACCESS_TOKEN"
      // ]
    }
  }
}

구성에서 업데이트를 한 후 MCP 클라이언트 앱을 다시 시작합니다.

(참고: Windows에서는 설정에 따라 명령 구조를 조정하거나 cmd /k 사용해야 할 수도 있습니다.)

서버 디버깅

--fb-token 인수를 통해 액세스 토큰을 제공하여 server.py 실행합니다.

python server.py --fb-token YOUR_FACEBOOK_ACCESS_TOKEN

사용 가능한 MCP 도구

이 MCP 서버는 Facebook 광고 개체 및 데이터와 상호 작용하기 위한 도구를 제공합니다.

도구 이름	설명
계정 및 개체 읽기
`list_ad_accounts`	토큰에 연결된 광고 계정을 나열합니다.
`get_details_of_ad_account`	특정 광고 계정에 대한 세부정보를 검색합니다.
`get_campaign_by_id`	특정 캠페인에 대한 세부정보를 검색합니다.
`get_adset_by_id`	특정 광고 세트에 대한 세부 정보를 검색합니다.
`get_ad_by_id`	특정 광고에 대한 세부 정보를 검색합니다.
`get_ad_creative_by_id`	특정 광고 크리에이티브에 대한 세부 정보를 검색합니다.
`get_adsets_by_ids`	ID별로 여러 광고 세트에 대한 세부 정보를 검색합니다.
컬렉션 가져오기
`get_campaigns_by_adaccount`	광고 계정 내의 캠페인을 검색합니다.
`get_adsets_by_adaccount`	광고 계정 내의 광고 세트를 검색합니다.
`get_ads_by_adaccount`	광고 계정 내에서 광고를 검색합니다.
`get_adsets_by_campaign`	캠페인 내의 광고 세트를 검색합니다.
`get_ads_by_campaign`	캠페인 내에서 광고를 검색합니다.
`get_ads_by_adset`	광고 세트 내의 광고를 검색합니다.
`get_ad_creatives_by_ad_id`	광고와 관련된 크리에이티브를 검색합니다.
통찰력 및 성과 데이터
`get_adaccount_insights`	광고 계정에 대한 성과 통찰력을 검색합니다.
`get_campaign_insights`	캠페인에 대한 성과 통찰력을 검색합니다.
`get_adset_insights`	광고 세트에 대한 성과 통찰력을 검색합니다.
`get_ad_insights`	광고에 대한 성과 통찰력을 검색합니다.
`fetch_pagination_url`	페이지 번호 URL(예: 인사이트)에서 데이터를 가져옵니다.
활동/변경 내역
`get_activities_by_adaccount`	광고 계정의 변경 내역을 검색합니다.
`get_activities_by_adset`	광고 세트의 변경 내역을 검색합니다.

(참고: 대부분 도구는 fields , filtering , limit , pagination, date ranges 등의 추가 매개변수를 지원합니다. 각 도구의 인수에 대한 전체 목록과 설명은 server.py 내의 자세한 docstring을 참조하세요.)

(참고: Facebook 액세스 토큰이 만료되면 새 토큰을 생성하고 MCP 클라이언트의 구성 파일을 새 토큰으로 업데이트해야 도구를 계속 사용할 수 있습니다.)

종속성

mcp (>=1.6.0)
요청 (>=2.32.3)

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Facebook 광고 서버를 자동으로 설치하는 방법:

npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude

Facebook-Ads-MCP-Server

Integrations