crm

CRM 캠페인 하나를 보내려면 세그먼트·쿠폰·메시지를 관리자 화면에서 일일이 클릭해야 해요. 너드보드의 호스팅 원격 MCP를 연결하면 AI 에이전트가 대신 해줘요 — 서버 설치도, 내 컴퓨터에 API 키를 둘 일도 없어요.

이 저장소는 CRM 사용 안내를 제공해요. 설치는 광고·CRM 공통 패키지 @nerdlab-dev/meta-ads-mcp로 진행해요. 모든 CRM 기능은 너드보드 서버에서 실행돼요. 별도 CRM npm 패키지는 설치하거나 배포하지 않아요.

무엇을 할 수 있나요

• 카카오 브랜드메시지 발송 — 예약 발송, A/B 테스트, 그리고 장바구니 리마인드·리필 리마인드·가입 환영 같은 상시 자동화 캠페인까지 만들 수 있어요.
• 정밀 타겟팅 — 구매 이력·가입일·장바구니 행동 등으로 고객 세그먼트를 만들고, 발송 전에 대상 모수를 미리 확인해요.
• 카페24 쿠폰 생성 — 쿠폰을 카페24에 바로 발급해요. 과도한 할인을 막는 가드레일이 내장돼 있고, 기존 쿠폰을 연결해 성과만 추적할 수도 있어요.
• UTM 자동 세팅 — 캠페인 링크에 UTM이 자동으로 붙어서, 발송이 만든 주문까지 추적돼요.
• 소재 이미지 저장소 — 메시지에 쓸 이미지를 업로드해 저장소에 보관하고, 여러 캠페인에서 재사용해요.
• 성과 확인 — 발송·클릭·기여 주문을 대화로 물어보면 돼요.
• 전략 상담 — 우리 몰의 CRM 현황을 불러와서 다음 캠페인을 제안받아요.

빠른 시작

**Node.js 20+**와 Claude Code 또는 Codex CLI가 필요해요. 설정은 2분이면 끝나요.

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

두 클라이언트가 모두 설치되어 있다면 하나를 골라 주세요:

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 nerdboard-meta-ads
  

로그인 과정에서 너드보드 워크스페이스를 고르고 광고·CRM·소재 전체 권한을 한 번에 승인해요. 구독이나 쇼핑몰 연동이 아직 없다면 너드보드가 화면에서 안내해 줘요.

이게 전부예요 — 이제 에이전트에게 캠페인을 부탁해 보세요.

전체 권한 연결

이미 배포된 공통 패키지를 그대로 사용해요. 기존 버전이 출력하는 --scopes 포함 로그인 예시 대신, 위의 codex mcp login nerdboard-meta-ads 명령을 사용해요. 일부 기능으로 권한을 제한하지 않아요.

Meta 광고와 CRM은 같은 MCP 서버를 사용해요. 기본 로그인은 서버가 지원하는 광고·CRM·소재 전체 권한을 한 번에 요청해요. 설치 명령에 일부 권한을 고정하지 않아요. 실제 작업에는 계정·몰·구독 권한 검사가 적용돼요.

기존에 일부 권한만 승인했다면 아래 명령으로 다시 로그인해요.

codex mcp logout nerdboard-meta-ads
codex mcp login nerdboard-meta-ads

Claude Code는 /mcp에서 재인증해요. invalid_scope 오류가 계속되면 기존 OAuth 클라이언트 등록정보가 남아 있는 상태예요. 기존 연결 주소를 확인한 뒤 연결을 제거하고 아래 공통 설치 명령으로 재등록해요. Claude Code는 /mcp의 인증 초기화도 함께 진행해요.

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

기존 nerdboard-crm 연결이 있다면 같은 서버를 가리키는 공통 연결을 사용하고, 기존 설정을 자동 삭제하지 않아요.

동작 방식

flowchart LR
    installer["이 CLI<br/>(얇은 설치기, MIT)"] -. 등록 .-> client
    client["Claude Code / Codex CLI"] -- "MCP over HTTPS + OAuth" --> server["너드보드 원격 MCP"]
    server -- "카페24 API + 카카오 브랜드메시지" --> store["내 쇼핑몰 · 고객"]

설치기는 각 제품의 공식 mcp add 명령으로 MCP 클라이언트에 nerdboard-meta-ads을 등록해요. 모든 CRM 동작은 너드보드가 운영하는 서버에서 실행되고, 서버가 카페24 쇼핑몰과 카카오 브랜드메시지 채널을 대신 다뤄요. 사용하려면 너드보드 계정, 활성 구독, 연동된 카페24 쇼핑몰이 필요해요.

보안과 투명성

설치기가 하는 일:

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

설치기가 절대 하지 않는 일:

• 쇼핑몰 자격 증명이나 접근 토큰을 읽거나 저장하지 않아요.
• CRM 요청을 로컬에서 중계하거나 처리하지 않아요.
• 너드보드 서버 코드나 캠페인 로직을 포함하지 않아요.
• 기존 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

원격 MCP를 지원하는 다른 클라이언트(Cursor 등)는 URL을 직접 등록하면 돼요:

https://nerdboard.kr/mcp

개발

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

라이선스

기존 CRM CLI 소스는 공통 설치 패키지 실행만 위임해요. 이 소스는 MIT 라이선스예요. 너드보드 서비스와 원격 MCP 서버는 별도의 서비스 약관을 따라요.

상표

OpenAI와 Codex는 OpenAI의 상표예요. Claude와 Claude Code는 Anthropic, PBC의 상표예요. 카페24(Cafe24)는 카페24 주식회사의 상표예요. 카카오(Kakao)는 주식회사 카카오의 상표예요. 모든 상표는 호환성을 설명하기 위해서만 사용했어요. 이 프로젝트는 독립 프로젝트이며 위 회사들과 제휴·보증·후원 관계가 없어요.

너드보드가 만들었어요

npm 설치가 실패할 때

CRM도 @nerdlab-dev/meta-ads-mcp를 설치해요. 별도 @nerdlab-dev/crm-mcp 패키지는 사용하지 않아요. 공통 npm 패키지를 받을 수 없는 환경에서는 같은 공개 저장소로 설치할 수 있어요. Git이 설치되어 있어야 해요.

npx -y github:nerdlab-dev/meta-ads-mcp install --client codex
# Claude Code를 사용하면 마지막 인자를 claude로 바꿔 주세요.

npm 없이 직접 연결하려면 위의 수동 설치 명령을 사용해요. 어느 방식이든 같은 서버에서 전체 권한을 한 번에 요청해요.