Skillget

meta-ads-mcp

mcp
Guvenlik Denetimi
Basarisiz
Health Gecti
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 17 GitHub stars
Code Basarisiz
  • spawnSync — Synchronous process spawning in src/install.js
  • spawnSync — Synchronous process spawning in test/bin.test.js
  • spawnSync — Synchronous process spawning in test/public-content.test.js
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Ask Claude Code or Codex CLI to launch and manage your Meta ads in plain language. This repo is the small MIT installer: one npx command connects your agent to Nerdboard's hosted MCP server, so there is no Meta developer token, no self-hosting, and no API keys on your machine.

README.md

한국어 | English

너드보드 Meta 광고 MCP

광고 성과 조회부터 캠페인 운영까지, AI와 대화하며 처리하세요.

npm 버전
npm 다운로드
CI
Node.js 20 이상
라이선스: MIT

Claude Code 지원
OpenAI 지원
Model Context Protocol 기반

데모 - 소재를 올리고 광고 생성을 요청하면 Meta 광고 관리자에 바로 반영돼요

Meta 광고를 하나 집행하려면 광고 관리자에서 캠페인, 광고 세트, 광고를 차례로 만들어야 해요. 너드보드 원격 MCP를 연결하면 이 과정을 Claude Code나 Codex CLI에서 대화로 처리할 수 있어요. Meta 개발자 토큰을 발급받거나 서버를 직접 띄울 필요도, API 키를 PC에 저장할 필요도 없어요.

이 저장소에는 너드보드 원격 MCP를 연결하는 가벼운 설치 도구만 공개되어 있어요. 실제 광고 작업은 너드보드 서버에서 처리해요.

무엇을 할 수 있나요?

  • 캠페인을 바로 시작해요 - “새 소재로 일 예산 3만 원짜리 Meta 리타게팅 광고를 만들어 줘.”라고 요청하면 캠페인부터 광고까지 한 번에 만들어요.
  • 성과를 한눈에 살펴봐요 - 광고비, ROAS, 구매 수는 물론 인구 통계와 노출 위치별 성과도 대화로 확인해요.
  • 소재를 올리고 다시 써요 - 이미지와 동영상을 업로드한 뒤 여러 광고에 활용해요.
  • 알맞은 타겟을 찾아요 - 관심사, 행동, 지역 조건을 터미널에서 바로 검색해요.
  • 운영 중인 광고를 조정해요 - 광고를 잠시 멈추거나 다시 시작하고, 예산도 대화로 바꿔요.

빠른 시작

준비물은 Node.js 20 이상과 Claude Code 또는 Codex CLI예요. 설치는 보통 2분이면 끝나요.

너드보드가 처음이라면 너드보드 MCP 설치 가이드(PDF)를 먼저 읽어 보세요. 회원가입부터 광고 채널 연결, 데이터 수집, MCP 승인까지 화면을 보며 따라갈 수 있어요.

npx -y @nerdlab-dev/meta-ads-mcp@latest install

Claude Code와 Codex CLI가 모두 설치되어 있다면 연결할 제품을 하나 골라 주세요.

npx -y @nerdlab-dev/meta-ads-mcp@latest install --client claude
npx -y @nerdlab-dev/meta-ads-mcp@latest install --client codex

연결이 끝나면 로그인해요.

  • Claude Code - /mcp를 실행한 뒤 브라우저에서 로그인해요.

  • Codex CLI - 아래 명령을 실행해요.

    codex mcp login \
  --scopes ad-channel:meta:read,ad-channel:meta:campaign:read,ad-channel:meta:creative:read,ad-channel:meta:campaign:write,ad-channel:meta:creative:write \
  nerdboard-meta-ads

로그인할 때 사용할 너드보드 작업공간과 AI가 사용할 권한을 고르게 돼요. 아직 구독을 시작하지 않았거나 Meta 광고 계정을 연결하지 않았다면 화면 안내에 따라 먼저 준비해 주세요.

여기까지 했다면 준비 끝이에요. 이제 원하는 광고 작업을 에이전트에게 말해 보세요.

어떻게 연결되나요?

flowchart LR
    installer["설치 도구<br/>(MIT 라이선스)"] -. 연결 등록 .-> client
    client["Claude Code / Codex CLI"] -- "HTTPS MCP + OAuth" --> server["너드보드 원격 MCP"]
    server -- "Meta Marketing API" --> meta["Meta 광고"]

설치 도구는 각 제품이 제공하는 mcp add 명령으로 nerdboard-meta-ads 연결을 등록해요. 광고 관련 요청은 너드보드 서버에서 처리하고, 서버가 사용자 대신 Meta Marketing API와 통신해요. 너드보드 구독이 활성 상태여야 하고 Meta 광고 계정도 연결되어 있어야 해요.

설치 도구는 어디까지 바꾸나요?

설치 도구는 MCP 연결에 꼭 필요한 설정만 확인하고 바꿔요.

  • Codex CLI와 Claude Code가 설치되어 있는지 확인해요.
  • nerdboard-meta-ads 연결이 이미 있는지 살펴봐요.
  • 제품의 공식 mcp add 명령으로 연결을 등록해요.
  • 같은 연결이 이미 있으면 아무것도 바꾸지 않아요.
  • 같은 이름이 다른 URL을 가리키면 기존 설정을 덮어쓰지 않고 멈춰요.

다음 정보나 설정에는 손대지 않아요.

  • Meta 액세스 토큰을 읽거나 저장하지 않아요.
  • 사용자 PC에서 광고 요청을 중계하거나 처리하지 않아요.
  • 너드보드 서버 코드나 광고 생성 로직을 내려받지 않아요.
  • 기존 MCP 설정을 삭제하거나 덮어쓰지 않아요.

푸시나 풀 리퀘스트가 올라올 때마다 공개 파일 허용 목록, 인증정보 패턴, 금지 용어를 자동으로 검사해요.

직접 연결하고 싶다면

Claude Code:

claude mcp add --transport http --scope user nerdboard-meta-ads https://nerdboard.kr/mcp

Codex CLI:

codex mcp add nerdboard-meta-ads --url https://nerdboard.kr/mcp

Cursor처럼 원격 MCP를 지원하는 다른 클라이언트에서는 아래 주소를 직접 등록하면 돼요.

https://nerdboard.kr/mcp

개발 명령어

npm test
npm run check
npm run check:public
npm pack --dry-run

라이선스

이 저장소에 공개된 CLI 소스에는 MIT 라이선스가 적용돼요. 너드보드 서비스와 원격 MCP 서버는 별도의 서비스 이용약관을 따라요.

상표

OpenAI와 Codex는 OpenAI의 상표예요. Claude와 Claude Code는 Anthropic, PBC의 상표이고, Meta는 Meta Platforms, Inc.의 상표예요. 각 상표는 호환성을 설명하기 위해서만 사용해요. 이 프로젝트는 해당 회사들과 별개로 운영하며, 제휴나 보증, 후원을 받지 않아요.

Nerdboard가 만들었어요.

Yorumlar (0)

Sonuc bulunamadi