개발자 가이드

플랫폼 MCP 서버 연결

운영자가 쓰는 AI(Claude Desktop·Cursor 등)에 크렘포올 CRM을 붙여 자연어로 운전하게 하는 원격 MCP 서버예요. 콘솔 코파일럿과 동일한 도구를 노출합니다.

※ 이건 데이터 수집용 커넥터(자체 DB 연동)와 다른 서버예요. 여기 MCP 서버는 플랫폼운영 기능(조회·초안 생성)을 외부 AI에 노출합니다.

커넥터(자체 DB, 브라우저 로그인)와 이 플랫폼 MCP(토큰)의 차이가 헷갈리면 → 연동 구조 한눈에 보기. 이 페이지는 그중 플랫폼 MCP(cfmcp_ 토큰)를 다룹니다.

1) 토큰 발급

콘솔에서 발급

운영 → AI 연결 (MCP)에서 이름을 적고 토큰을 발급해요. 토큰 원문은 발급 직후 한 번만 보이고, 저장은 해시로만 됩니다(분실 시 재발급).

2) 연결 정보

서버 URL	`https://<콘솔주소>/api/mcp`
인증	`Authorization: Bearer <발급 토큰>`
전송	Streamable HTTP (JSON-RPC 2.0)
메서드	`initialize` · `tools/list` · `tools/call` · `ping`

3) Claude Desktop 설정 (mcp.json)

실제 화면 컴포넌트 — 콘솔과 항상 동일

{
  "mcpServers": {
    "crmforall": {
      "transport": {
        "type": "http",
        "url": "https://<콘솔주소>/api/mcp",
        "headers": { "Authorization": "Bearer <발급 토큰>" }
      }
    }
  }
}

토큰을 헤더에 넣어 원격 HTTP로 연결.

4) 노출 도구

도구	권한	설명
`get_overview`	읽기	고객·동의·매출·전환 종합 현황
`preview_segment`	읽기	세그먼트 규칙으로 인원 미리 계산
`get_conversion`	읽기	전환 이벤트·기여 기간 기준 전환·매출
`list_segments / list_campaigns / list_tags`	읽기	그룹·캠페인·태그 목록
`add_tag`	초안	커스텀 태그 추가
`create_segment_group`	초안	고객 그룹 저장(발송 아님)
`draft_campaign`	초안	캠페인 초안 생성
`issue_install_token`	초안	자체 DB 커넥터 설치 토큰(cfit_) 발급 — 콘솔 로그인 없이 MCP로

발송 도구는 없습니다(fail-closed). AI는 절대 직접 메시지를 보내지 않아요 — 캠페인은 초안까지만 만들고, 발송은 콘솔에서 사람이 검토·승인해야 나갑니다. 토큰은 운영 → AI 연결 (MCP)에서 언제든 폐기할 수 있어요.

한 번만: 부트스트랩 (이 플랫폼 MCP 연결)

이 원격 MCP 서버는 보안상 콘솔 로그인 1회로 발급한 토큰(cfmcp_)으로 인증해요 — 원격 HTTP라 헤더에 Bearer 토큰을 넣는 방식입니다(브라우저 로그인 아님). 발급·등록은 위 1~3단계 그대로예요.

콘솔에서 MCP 토큰 발급 (1회)

운영 → AI 연결 (MCP) → 토큰 발급 → cfmcp_… 복사(위 mcp.json의 Bearer에 사용).

AI에 등록 (위 3단계)

Claude Desktop·Code의 MCP에 서버 URL + Bearer cfmcp_… 등록.

커넥터(자체 DB)는 다른 서버 — 브라우저 로그인이 기본이에요. 고객 DB에 붙는 커넥터는 토큰 복붙이 아니라 브라우저 디바이스 로그인으로 연결합니다. 터미널 npx @crmforall/connect login(또는 Claude 세션 안에서 setup_login)이 코드를 띄우면, 운영자가 브라우저에서 승인해요. 승인은 머신당 1회면 되고, 도중에 끊겨도 재승인 없이 이어집니다(resume).

브라우저 디바이스 승인 화면 — 터미널이 띄운 기기 코드를 확인하고 '이 기기 승인'을 누른다 — 커넥터 브라우저 로그인: `connect login`/`setup_login`이 띄운 코드를 콘솔의 `/device` 화면에서 승인. 재현 데모 — 실제 코드·계정 미사용.

커넥터 설치·온보딩 전체는 커넥터 설치·운영을 보세요. 전산담당자가 분리됐다면, 이 MCP의 issue_install_token으로 cfit_…를 발급해 전달하는 보조(수동) 경로도 있어요(connect init --token=cfit_…).

두 서버 모두 “최초 1회 인증”이라는 보안 하한은 동일합니다 — 플랫폼 MCP는 콘솔 토큰으로, 커넥터는 브라우저 승인으로. 커넥터가 고객 DB에 접근하기 때문이에요.