bbotn 가이드
botn 앱 → KOENJA
통합 · MCP 연결

MCP 연결 (외부 LLM)

Claude·Cursor 같은 LLM에서 botn 데이터를 직접 조회하고 관리하세요. botn은 MCP(Model Context Protocol) 서버를 제공합니다.

무엇을 할 수 있나

연결하면 LLM이 이 워크스페이스의 데이터를 조회하고 영업 작업을 실행합니다. 단순 조회를 넘어 고객·딜·할 일은 물론 리드 폼·자동 팔로업 시퀀스·캠페인까지 만들고, 이메일 캠페인 발송 같은 실제 작업도 지시할 수 있습니다. 예: “오늘 연락할 핫 리드 정리해줘”, “이 고객에게 통화 완료 노트 남기고 내일 팔로업 할 일 만들어줘”, “견적 후속 시퀀스 만들고 이 고객 등록해줘”.

쓸 수 있는 도구

botn은 55개의 도구를 제공합니다 — 앱에서 직접 하던 핵심 작업을 거의 그대로 LLM에서 처리할 수 있는 풀 컨트롤 수준입니다. 조회 도구는 안전하게 데이터를 읽고, 작업 도구는 실제로 레코드를 만들고·바꾸고·삭제합니다.

조회 (22)

작업 (33)

작업 도구는 실제로 데이터를 바꿉니다. 특히 삭제(연락처·딜·할 일·노트)와 발송(시퀀스 등록·이메일 캠페인 발송)은 되돌리기 어렵거나 외부로 메시지가 나갑니다. LLM에게 시킬 때는 명시적으로 요청할 때만 실행되도록 하고, 대상·내용을 먼저 확인하세요. 모든 발송은 마케팅 동의·수신거부 정책을 자동으로 따르고, 삭제는 soft delete(휴지통)로 처리됩니다.

1. 토큰 발급

설정 → MCP 연결에서 토큰 발급을 누르면 botn_pat_… 토큰이 한 번만 표시됩니다. 복사해 두세요(다시 볼 수 없습니다). 토큰은 발급한 워크스페이스로 스코프됩니다.

2. LLM에 연결

대부분의 MCP 클라이언트는 mcp-remote 브리지로 원격 서버에 붙습니다. Claude Desktop이면 설정의 MCP 구성(JSON)에 아래를 추가하고 botn_pat_여기에_토큰을 발급한 토큰으로 바꾸세요. Node.js가 설치돼 있어야 합니다.

{
  "mcpServers": {
    "botn": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://botn.app/mcp",
        "--header", "Authorization: Bearer botn_pat_여기에_토큰"
      ]
    }
  }
}

저장 후 클라이언트를 재시작하면 botn 도구가 나타납니다. Cursor·기타 클라이언트도 같은 URL(https://botn.app/mcp)과 Authorization: Bearer 헤더 방식을 씁니다.

보안

토큰은 발급한 사람·워크스페이스 권한으로만 동작하고, 서버에는 해시만 저장됩니다. 더 이상 쓰지 않으면 설정 → MCP 연결에서 폐기하세요. 폐기 즉시 그 토큰의 모든 접근이 차단됩니다.

토큰은 비밀번호처럼 다루세요. 코드 저장소·채팅에 붙여넣지 말고, 의심되면 폐기 후 재발급하세요. 모든 작업은 토큰이 속한 한 워크스페이스에만 적용됩니다.