> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizmori.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 커넥터

> 코드도 API 키도 없이, Claude에서 대화만으로 BIZ MORI 사용하기

**BIZ MORI MCP 커넥터**를 쓰면 Claude 같은 AI 어시스턴트 안에서 바로 BIZ MORI를 사용할 수 있습니다. BIZ MORI 계정으로 한 번만 연결해두면, 이후에는 평소 말하듯 요청하면 됩니다.

> "이 이미지가 AI로 생성된 건지 확인해줘: `<이미지 주소>`"

Claude가 BIZ MORI에서 작업을 실행하고 결과를 대화창에 알려줍니다. 코드도, API 키도, 대시보드도 필요 없습니다.

<Note>
  **MCP**(Model Context Protocol)는 AI 어시스턴트를 외부 서비스와 연결하는 공개
  표준입니다. 사용하는 데 이 개념을 이해할 필요는 없습니다.
</Note>

## 무엇을 할 수 있나요

<Columns cols={2}>
  <Card title="AI 이미지 검사" icon="robot">
    이미지가 AI로 생성됐는지 물어보세요. 확률과 판정 결과, 히트맵 이미지를
    알려줍니다.
  </Card>

  <Card title="Anti-AI 보호 적용" icon="shield">
    이미지가 AI 학습 데이터로 쓰이지 않도록 보호합니다. 한 번에 최대 100장.
  </Card>

  <Card title="워터마크 삽입" icon="stamp">
    원하는 문구를 담은 비가시성 소유권 워터마크를 넣습니다.
  </Card>

  <Card title="워터마크 검출" icon="magnifying-glass">
    파일에 BIZ MORI 워터마크가 있는지 확인하고 그 문구를 읽어냅니다.
  </Card>

  <Card title="작업 기록 확인" icon="clock-rotate-left">
    "이번 주 작업 목록 보여줘" — 지난 작업과 결과를 조회합니다.
  </Card>

  <Card title="청구 계정 선택" icon="building">
    개인 계정 또는 소속 조직 계정 중 어디로 청구할지 고릅니다.
  </Card>
</Columns>

## 커넥터 연결하기

<Steps>
  <Step title="커넥터 설정 열기">
    Claude 앱(웹 또는 데스크톱)에서 **설정 → 커넥터 → 사용자 지정 커넥터 추가**로 이동합니다.
  </Step>

  <Step title="커넥터 URL 입력">
    ```
    https://mcp.bizmori.com/mcp
    ```

    이름은 알아보기 쉽게 `BIZ MORI` 정도로 지정하세요.
  </Step>

  <Step title="BIZ MORI 계정으로 로그인">
    BIZ MORI 로그인 창이 열립니다. [app.bizmori.com](https://app.bizmori.com)에서 쓰는 것과 같은 계정으로 로그인하고 연결을 승인하세요.

    <Check>
      API 키는 **필요하지 않습니다.**
    </Check>
  </Step>

  <Step title="요청해보기">
    새 대화를 열고 이렇게 입력해보세요.

    ```text theme={null}
    BIZ MORI로 이 이미지가 AI 생성인지 확인해줘:
    <이미지 주소>
    ```
  </Step>
</Steps>

## 이미지 업로드 방식

**어떤 도구를 쓰느냐에 따라 가능한 이미지 업로드 방법이 다릅니다.**

|                             | 대화창에 첨부한 이미지 | 내 컴퓨터의 파일 | 이미지 주소(URL) |
| --------------------------- | :----------: | :-------: | :---------: |
| **Claude 앱** (웹 / 데스크톱)     |       X      |     X     |      ✓      |
| **Claude Code** (터미널 / IDE) |       —      |     ✓     |      ✓      |
| **Codex**                   |       —      |     ✓     |      ✓      |

<AccordionGroup>
  <Accordion title="Claude 앱 — 반드시 이미지 주소를 써야 합니다" icon="browser">
    대화창에 **첨부한 이미지는 사용할 수 없습니다.** 첨부 파일은 Claude가 눈으로 보는 용도로만 들어가고, 커넥터에는 실제 파일이 전달되지 않습니다. BIZ MORI 쪽에서 해결할 수 없는 플랫폼 한계입니다. 앱은 내 컴퓨터의 파일에도 접근할 수 없습니다.

    따라서 이미지를 링크가 생기는 곳에 먼저 올리고 — Google Drive, Dropbox, Notion에서 링크 공유를 켜고 — 그 링크를 대화창에 붙여넣으세요.

    <Warning>
      사진을 첨부해놓고 Anti-AI 처리를 요청하면 동작하지 않습니다. Claude가 대신 링크를 달라고 요청할 것입니다.
    </Warning>
  </Accordion>

  <Accordion title="Claude Code — 로컬 파일 업로드가 가능합니다" icon="terminal">
    Claude Code는 파일을 읽을 수 있으므로 이미지 위치만 알려주면 됩니다.

    ```text theme={null}
    ~/Pictures/artwork.png 에 Anti-AI 보호 적용해줘
    ```

    파일 업로드까지 알아서 처리합니다. 이미지 주소를 써도 됩니다.
  </Accordion>

  <Accordion title="Codex CLI — 로컬 파일 업로드가 가능합니다" icon="terminal">
    Claude Code와 동일하게 파일 경로만 주면 업로드까지 처리합니다.
  </Accordion>
</AccordionGroup>

## 결과 받기

Claude가 작업이 끝날 때까지 기다렸다가 대화창으로 결과를 알려줍니다.

| 서비스         | 받는 결과                                   |
| ----------- | --------------------------------------- |
| **AI 검사**   | 확률과 판정 결과, 그리고 히트맵·오버레이·썸네일 이미지         |
| **워터마크 검출** | 검출된 워터마크 문구                             |
| **Anti-AI** | 보호 처리된 이미지의 다운로드 링크. 여러 장이면 ZIP 하나로 옵니다 |
| **워터마크 삽입** | 결과 ZIP의 다운로드 링크                         |

모든 결과에는 해당 작업을 [대시보드](https://app.bizmori.com)에서 열어보는 링크와, 어느 계정으로 청구됐는지가 함께 표시됩니다.

AI 검사는 세 가지 이미지를 기본으로 만듭니다. 추가 비용은 없습니다 — 이미지가 몇 장이든 검사 1회로 계산됩니다.

<Warning>
  **오래 걸리는 작업은 "처리 중" 상태로 돌아올 수 있습니다.** Claude는 약 2분까지만 기다리는데, 장수가 많은 Anti-AI나 무거운 워터마크 작업은 그보다 오래 걸릴 수 있습니다.

  실패가 아니라 작업은 계속 진행 중입니다. 결과는 이렇게 받으세요.

  * [대시보드](https://app.bizmori.com)에서 내려받기. 완료된 작업이 모두 여기 있습니다.
  * 또는 몇 분 뒤 대화창으로 돌아와 Claude에게 그 작업을 다시 확인해달라고 하기.
</Warning>

<Note>
  다운로드 링크는 일정 시간이 지나면 만료됩니다. 링크가 열리지 않으면 Claude에게
  해당 작업의 새 링크를 받거나, 대시보드에서 내려받으세요.
</Note>

## 이렇게 물어보세요

`<이미지 주소>` 에 이미지 링크를 넣으세요. Claude Code나 Codex CLI를 쓴다면 파일 경로를 넣어도 됩니다.

```text theme={null}
이 이미지 AI 생성인지 검사해줘:
<이미지 주소>
```

```text theme={null}
이 ZIP 안의 이미지 전부에 Anti-AI 보호를 high 강도로 적용해줘:
<ZIP 파일 주소>
```

```text theme={null}
이 이미지에 "© 2026 MORI Corp" 워터마크 삽입해줘:
<이미지 주소>
```

```text theme={null}
이 파일에 BIZ MORI 워터마크가 들어있어?
<이미지 주소>
```

```text theme={null}
지난 일주일 BIZ MORI 작업 목록 보여주고, 실패한 게 있으면 알려줘.
```

## 청구 계정 설정

BIZ MORI에서 조직에 소속되어 있다면, 작업을 개인 계정으로도 조직 계정으로도 청구할 수 있습니다. 커넥터는 임의로 고르지 않고 **반드시 물어봅니다.**

계정 이름으로 답하면 작업이 진행됩니다. **한 번만 물어봅니다** — 선택한 계정을 기억해서 이후 작업에는 다시 묻지 않습니다. 다른 계정 이름을 말하면 그때 바뀝니다. 모든 결과에 어느 계정으로 청구됐는지 표시됩니다.

처음부터 지정해도 됩니다.

```text theme={null}
이 이미지들에 Anti-AI 보호 적용해줘. 청구는 MORI Corp으로:
<이미지 주소 1>
<이미지 주소 2>
```

개인 계정 하나뿐이라면 묻지 않고 자동으로 사용합니다.

## 문제 해결

<AccordionGroup>
  <Accordion title="첨부한 이미지를 읽을 수 없다고 나옵니다">
    위에서 설명한 플랫폼 한계이며 오류가 아닙니다. 이미지를 공유 링크가 생기는
    곳에 올린 뒤 그 링크를 붙여넣으세요.
  </Accordion>

  <Accordion title="작업이 &#x22;처리 중&#x22;으로만 돌아오고 다운로드 링크가 없습니다">
    Claude가 기다리는 시간을 넘긴 것으로, 장수가 많은 작업에서 생깁니다. 실패가
    아니라 계속 진행 중입니다. [대시보드](https://app.bizmori.com)에서 결과를
    내려받거나, 몇 분 뒤 Claude에게 그 작업을 다시 확인해달라고 하세요.
  </Accordion>

  <Accordion title="커넥터 기능이 보이지 않거나, Claude가 이상한 우회를 시도합니다">
    **설정 → 커넥터**에서 연결을 끊었다가 다시 연결하세요. Claude가 기능 목록을
    캐싱하기 때문에 새로 추가된 기능은 재연결 후에 나타납니다. 그 전에는 여러
    장을 개별 작업으로 쪼개 보내거나 브라우저를 이용한 우회를 시도할 수
    있습니다.
  </Accordion>

  <Accordion title="시작하자마자 사용량 한도에 걸립니다">
    조직 계정이 아니라 개인 무료 계정으로 작업이 실행되고 있을 수 있습니다.
    Claude에게 사용 가능한 계정을 물어본 뒤, 작업할 때 조직 이름을 지정하세요.
  </Accordion>

  <Accordion title="다운로드 링크에서 오류가 납니다">
    링크가 만료된 것입니다. Claude에게 해당 작업을 다시 조회해달라고 해서 새
    링크를 받거나, 대시보드에서 내려받으세요.
  </Accordion>

  <Accordion title="그 밖의 문제">
    [support@bizmori.com](mailto:support@bizmori.com)으로 문의해주세요.
  </Accordion>
</AccordionGroup>

## 코드로 직접 만들고 싶다면

커넥터는 일상적인 사용을 위한 것입니다. BIZ MORI를 제품에 직접 넣으려면 REST API를 사용하세요.

<Columns cols={2}>
  <Card title="빠른 시작" icon="rocket" href="/ko/quickstart">
    단계별로 첫 API 호출을 해봅니다.
  </Card>

  <Card title="AI 에이전트 연동" icon="robot" href="/ko/ai-agents">
    프롬프트 하나로 코딩 에이전트에 연동 규칙 전체를 전달합니다.
  </Card>
</Columns>