GO AI Chat으로 돌아가기 GO AI Chat · Model Context Protocol

GO AI Chat의 이미지 및 동영상
도구를 호환 MCP 클라이언트로.

Mac용 GO AI Chat에서 온디바이스 MCP 서버를 켜면, Claude Code, Cursor, Claude Desktop이 이미지·동영상·미디어 도구를 직접 호출할 수 있습니다 — 모든 생성은 로그인한 계정의 Lab 토큰 잔액에서 차감됩니다.

MCP 서버는 Mac용 GO AI Chat(Mac Catalyst)에 내장되어 있습니다. 기기에서 실행되고, localhost에만 바인딩되며, Bearer 토큰으로 인증하므로 — 통제권은 사용자에게 있습니다.

설정

단계로 연결합니다.

앱에 표시된 엔드포인트와 페어링 토큰으로 호환 클라이언트를 추가하세요.

  1. 1

    서버를 활성화하세요

    Mac에서 GO AI Chat을 열고 설정 → MCP Server로 이동해 MCP 서버 활성화를 켜세요. 상태 표시등이 초록색으로 바뀌며 현재 엔드포인트 http://127.0.0.1:8722/mcp가 표시됩니다. 8722 포트가 사용 중이면 언제든 변경할 수 있습니다.

  2. 2

    페어링 토큰을 복사하세요

    페어링 토큰 섹션에서 복사를 누르세요. 이 토큰은 모든 요청을 인증합니다 — 비밀번호처럼 다루세요. 다시 생성을 누르면 토큰이 교체되고, 이전 토큰을 쓰던 클라이언트는 즉시 차단됩니다.

  3. 3

    클라이언트에 추가하세요

    아래 연결 스니펫을 MCP 클라이언트에 붙여 넣으세요. <YOUR_TOKEN>을 방금 복사한 토큰으로 바꾸면 됩니다 (앱의 스니펫에는 이미 포함되어 있습니다).

    Claude Code

    터미널에서 실행:

    claude mcp add --transport http goai-chat http://127.0.0.1:8722/mcp --header "Authorization: Bearer <YOUR_TOKEN>"
    Cursor & JSON-config clients

    mcp.json (Cursor) 또는 claude_desktop_config.json (Claude Desktop)에 추가하세요:

    {
      "mcpServers": {
        "goai-chat": {
          "type": "http",
          "url": "http://127.0.0.1:8722/mcp",
          "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
        }
      }
    }
기능

13가지 도구를 서버 하나로

Grok으로 구동되는 이미지·동영상·미디어 생성에 더해, 기기에서 동작하는 Studio 색보정과 무료 읽기 전용 도구까지. 전체 기계 판독용 카탈로그는 list_generation_options를 호출하세요.

생성

generate_image

선택한 스타일 프리셋으로 텍스트에서 이미지를 생성합니다.

1토큰
transform_image

PNG 마스크를 이용한 인페인팅을 포함한 이미지 간 스타일 변환.

1토큰
generate_video

텍스트로 동영상 클립을 생성합니다. 폴링용 작업 ID를 반환합니다.

초당
summarize_media

YouTube URL 또는 PDF/MP4 파일(50MB 이하)을 요약합니다.

5토큰

Studio

studio_create_image

스타일 프리셋 없이 프롬프트만으로 이미지를 만듭니다.

1토큰
studio_edit_image

텍스트 프롬프트로 참조 이미지를 편집합니다.

2토큰
studio_image_to_video

참조 이미지를 움직여 동영상 클립으로 만듭니다.

초당
studio_edit_video

프롬프트로 기존 동영상(15초 이하)을 편집합니다.

초당
studio_adjust_image_colors

기기에서 이미지에 전문가급 색보정을 적용합니다.

1토큰
studio_adjust_video_colors

기기에서 동영상에 전문가급 색보정을 적용합니다.

3토큰

유틸리티는 무료

get_token_balance

Lab 및 채팅 토큰 잔액, 등급, 720p 사용 가능 여부를 확인합니다.

무료
get_job_status

비동기 작업의 상태, 진행률, 결과를 확인합니다.

무료
list_generation_options

전체 카탈로그: 스타일, 화면 비율, 길이, 요금.

무료
요금제

호출별 요금

모든 생성은 앱에서 쓰는 것과 같은 Lab 토큰 잔액에서 차감됩니다. 읽기 전용 도구는 언제나 무료입니다.

도구요금
generate_image, transform_image, studio_create_image1토큰
studio_edit_image2토큰
studio_adjust_image_colors1토큰
studio_adjust_video_colors3토큰
summarize_media5토큰
동영상 — generate_video, studio_image_to_video, studio_edit_videomax(10, round(seconds × 2.5)) — 예: 8초 클립 = 20토큰
get_token_balance, get_job_status, list_generation_options무료

720p 동영상은 유효한 구독이 필요합니다. 잔액은 get_token_balance로 언제든 확인할 있습니다.

작동 방식

로컬에서, 사용량이 보이고, 온전히 내 것

localhost 전용

서버는 127.0.0.1에 바인딩됩니다. 네트워크나 인터넷에는 전혀 공개되지 않으며 — 클라이언트는 같은 Mac에서 연결합니다.

Bearer 토큰 인증

모든 요청에는 페어링 토큰이 포함됩니다. 토큰을 다시 생성하면 접근 권한이 즉시 해제되며 — 이전 클라이언트는 그 순간부터 작동을 멈춥니다.

토큰 단위 사용량 기반

생성은 로그인한 계정의 Lab 토큰 잔액에서 차감되며 — 앱에서 쓰는 잔액과 같습니다. 읽기 전용 도구는 토큰을 쓰지 않습니다.

비동기 동영상 작업

동영상 도구는 작업 ID를 즉시 반환합니다. 클립이 준비될 때까지 get_job_status로 확인하세요 — 대기 호출은 없습니다.

자주 묻는 질문

자주 묻는 질문

어떤 클라이언트를 연결할 수 있나요?

호환 MCP 클라이언트는 Bearer Authorization 헤더를 사용하는 스트리밍 HTTP 전송을 지원합니다. Claude Code, Cursor, Claude Desktop에서 검증했습니다.

GO AI Chat Mac 앱이 꼭 필요한가요?

네. 서버는 Mac용 GO AI Chat 안에서 기기 자체로 동작합니다. 클라이언트가 연결된 동안에는 앱을 열어 두세요. 앱을 닫으면 서버도 멈춥니다.

iPhone이나 iPad에서도 사용할 수 있나요?

아직은 아닙니다 — 현재 MCP 서버는 Mac 전용입니다. 같은 계정과 Lab 토큰 잔액을 쓰므로, 생성한 결과는 모든 기기의 기록에도 함께 남습니다.

요금은 얼마인가요?

연결은 무료입니다. 생성 도구는 Lab 토큰에서 차감됩니다(이미지 1, Studio 이미지 편집 2, 미디어 요약 5, 동영상은 초당). 읽기 전용 도구 — 잔액, 작업 상태, 옵션 카탈로그 — 는 무료입니다.

클라이언트 접근 권한은 어떻게 해제하나요?

설정 → MCP Server를 열고 페어링 토큰의 다시 생성을 누르거나, 서버를 끄세요. 둘 중 어느 쪽이든 기존 클라이언트는 즉시 차단됩니다.

기본 포트가 사용 중입니다 — 변경할 수 있나요?

네. MCP Server 설정에서 1024 이상의 포트를 지정할 수 있습니다. 선택한 포트가 사용 중이면 서버가 다음 포트를 차례로 시도해 비어 있는 포트를 찾은 뒤 현재 URL을 보여 줍니다.

연결을 시작해 볼까요?

Mac용 GO AI Chat을 받아 MCP 서버를 켜고, 즐겨 쓰는 클라이언트에서 호출하세요.

궁금한 점이 있으신가요? support@goaichats.com