Mamezu · MCP

AI로 비즈 도안 만들기

ChatGPT나 Claude에 보드 크기와 사용할 비즈 색상을 알려 도안을 만드세요. 미리보기와 색상 교체로 조정한 뒤 Mamezu에서 마무리할 수 있습니다.

이미지

보드 크기

비즈 색상

미리보기·조정

시작 전 준비

Mamezu 계정, 이미지, 보드 칸 수, 브랜드 팔레트 또는 보유 색상 코드를 준비하세요. OAuth로 권한을 허용하므로 AI에 비밀번호나 Firebase 키를 전달할 필요가 없습니다.

https://mamezu.torai.dev/mcp

로컬 프로젝트는 먼저 Mamezu에서 클라우드로 저장하세요. 연결하면 해당 계정의 클라우드 프로젝트에 접근할 수 있으니 계정을 확인하세요.

ChatGPT

데스크톱 앱에 연결 설정이 없다면 브라우저에서 ChatGPT 설정을 여세요. 메뉴와 편집 권한은 버전, 요금제, 워크스페이스 정책에 따라 다릅니다.

1
Settings → Security and login에서 Developer mode를 켜세요. 일부 버전에서는 Apps → Advanced settings에 있습니다.
2
Plugins에서 연결을 추가하세요. Apps로 표시되는 버전에서는 사용자 지정 앱 만들기를 사용하세요.
3
아래 MCP URL을 입력하고 OAuth를 선택하세요. Client ID와 Client Secret은 비워 두세요. DCR이 자동으로 등록합니다.
4
Mamezu에 로그인하고 계정과 읽기·편집 권한을 확인한 뒤 연결을 허용하세요.
5
새 대화에서 도구 메뉴의 Mamezu를 활성화하고 클라우드 프로젝트 목록을 요청해 연결을 확인하세요.

https://mamezu.torai.dev/mcp

ChatGPT 공식 MCP 연결 추가 예시 — OpenAI 공식 화면 예시이며 Mamezu 연결 화면은 아닙니다. 데스크톱 및 최신 버전의 메뉴는 다를 수 있습니다.

공식 안내 ↗

Claude · Desktop / Web

1
Claude Desktop 또는 웹에서 Customize → Connectors를 여세요. 일부 버전은 Settings → Connectors로 표시됩니다.
2
+ → Add custom connector를 선택하고 이름을 Mamezu로 지정한 뒤 아래 MCP URL을 붙여 넣으세요.
3
Client ID와 Client Secret을 비워 두고 커넥터를 추가하세요. Mamezu는 DCR 자동 등록을 지원합니다.
4
Connect를 누르고 Mamezu에 로그인해 클라우드 접근 권한을 허용하세요.
5
새 대화의 + → Connectors에서 Mamezu를 켜세요. 팀 계정은 관리자가 먼저 추가해야 할 수 있습니다.

https://mamezu.torai.dev/mcp

원격 연결이므로 claude_desktop_config.json 수정은 필요 없습니다. 첨부 이미지를 도구로 전달할 수 없다면 Mamezu에서 가져와 클라우드에 저장한 뒤 Claude에 해당 프로젝트를 열어 달라고 하세요.

공식 안내 ↗

Codex · CLI / Desktop

1
Codex CLI를 설치하거나 업데이트하고 아래 add 명령을 실행하세요. 사용자 설정에 저장하고 브라우저 인증을 시작합니다.
2
Mamezu에 로그인하고 계정과 읽기/편집 권한을 확인하세요. 인증이 자동으로 시작되지 않으면 login을 실행하세요. 이미 완료했다면 생략합니다.
3
get으로 설정을 확인하세요. 새 Codex 대화를 열고 /mcp 또는 Desktop MCP 설정에서 연결을 확인한 뒤 클라우드 프로젝트 목록을 요청하세요.

codex mcp add mamezu --url https://mamezu.torai.dev/mcp
codex mcp login mamezu
codex mcp get mamezu

공식 안내 ↗

Claude Code

1
Claude Code를 설치하거나 업데이트한 후 아래 명령으로 사용자 범위에 Mamezu를 추가하세요.
2
login을 실행하고 브라우저에서 Mamezu에 로그인하여 권한을 승인하세요. Claude Code에서 /mcp를 입력하고 Mamezu를 선택하여 인증할 수도 있습니다.
3
새 대화에서 Mamezu 클라우드 프로젝트 목록을 요청하여 도구 연결을 확인하세요.

claude mcp add --transport http --scope user mamezu https://mamezu.torai.dev/mcp
claude mcp login mamezu

API 키나 Client Secret은 필요하지 않습니다. 원격 터미널에서는 --no-browser를 사용할 수 있습니다. login 하위 명령이 없는 버전은 업데이트하거나 /mcp를 사용하세요. 연결은 Mamezu AI 연결 페이지에서 철회할 수 있습니다.

공식 안내 ↗

첫 도안 만들기

1
이미지와 정확한 크기(예: 52 × 52 또는 104 × 104)를 알려 주세요. 첨부 파일에 접근할 수 없다면 편집기에서 가져와 클라우드에 저장하세요.
2
브랜드와 시리즈를 지정하세요. 보유 색상이 제한되어 있다면 코드 목록을 함께 제공하고 사용 가능한 색상을 먼저 확인하도록 하세요.
3
초안과 미리보기를 요청하세요. 결과를 보고 구도나 대비를 조정하거나 사용 가능한 다른 비즈 색상으로 교체하세요.
4
Mamezu의 프로젝트 목록에서 클라우드로 전환해 결과를 여세요. 이미 열려 있었다면 다시 열어야 합니다. 원격 편집의 실시간 동기화는 아직 연결되지 않았습니다.

이 이미지를 52 × 52 비즈 도안으로 만들어 주세요. MARD의 A1, A2, B1, C1, H1만 사용하세요. 먼저 코드를 확인하고 이미지 전체가 보이게 맞춘 뒤 미리보기와 색상별 개수를 보여 주세요. 색상을 추가하지 않고 개선할 방법도 제안해 주세요.

사용 가능한 코드는 색상 종류만 제한하며 남은 비즈 개수는 반영하지 않습니다. 화면 색상은 근사값이므로 제작 전 실제 비즈를 확인하세요.

실제 클라우드 생성 결과입니다. 52 × 52칸에 MARD 색상 5개만 허용했고 결과에는 그중 3개가 사용되었습니다. 색상이 제한되면 사용 가능한 비즈 색상으로 이미지를 표현합니다.

도구 호출 예시

먼저 get_project로 프로젝트 ID와 최신 revision을 가져오세요. 아래는 A1을 A2로 모두 교체하는 예시입니다. A2는 현재 사용할 수 있는 색상이어야 합니다.

{
  "name": "apply_project_commands",
  "arguments": {
    "projectId": "YOUR_PROJECT_ID",
    "expectedRevision": 1,
    "commands": [
      {
        "type": "color.replace",
        "source": "A1",
        "destination": "A2"
      }
    ]
  }
}

개발자는 이 명령으로 공개 OAuth 메타데이터를 확인할 수 있습니다. 비공개 프로젝트는 읽지 않습니다.

curl https://mamezu.torai.dev/.well-known/oauth-protected-resource/mcp

문제 해결

설정 메뉴나 편집 권한이 없나요?

앱 버전, 요금제, 워크스페이스 권한을 확인하고 공식 웹 설정을 이용하세요. Mamezu가 AI 서비스 계정의 기능을 활성화할 수는 없습니다.

이미지를 가져오지 못했나요?

PNG, JPEG, WebP를 지원하며 다운로드는 10 MiB, 디코딩은 1,600만 픽셀까지입니다. 임시 URL이 만료되었다면 다시 첨부하거나 Mamezu 클라우드 프로젝트로 저장하세요.

REVISION_CONFLICT가 표시되나요?

다른 곳에서 프로젝트가 수정되었습니다. AI에 최신 버전을 다시 읽고 변경 내용을 확인한 뒤 재시도하도록 요청하세요.

글꼴을 사용할 수 없다고 나오나요?

서버는 사용자 컴퓨터에 설치된 글꼴에 접근할 수 없습니다. 이미지, 색상, 도형, 픽셀 숫자는 직접 렌더링하며 일반 텍스트 레이어는 편집기에서 확인하세요.

포인트와 연결 해제는 어떻게 하나요?

MCP 호출은 1회 1포인트, 이미지 변환 또는 미리보기는 1회 10포인트입니다. 사용자당 월 한도는 2,000포인트이며 매월 1일 00:00 UTC에 초기화됩니다. 잔여 포인트가 부족한 작업은 실행되거나 차감되지 않습니다. 시작 후 실패한 작업은 차감됩니다.

AI 연결 및 사용량