터미널에서 실행:
claude mcp add --transport http goai-chat http://127.0.0.1:8722/mcp --header "Authorization: Bearer <YOUR_TOKEN>"
Mac용 GO AI Chat에서 온디바이스 MCP 서버를 켜면, Claude Code, Cursor, Claude Desktop이 이미지·동영상·미디어 도구를 직접 호출할 수 있습니다 — 모든 생성은 로그인한 계정의 Lab 토큰 잔액에서 차감됩니다.
서버 실행 중 · 127.0.0.1:8722
$ claude mcp add --transport http goai-chat \ http://127.0.0.1:8722/mcp \ --header "Authorization: Bearer goai_…" ✓ Added MCP server goai-chat 13 tools · images · video · media · studio
MCP 서버는 Mac용 GO AI Chat(Mac Catalyst)에 내장되어 있습니다. 기기에서 실행되고, localhost에만 바인딩되며, Bearer 토큰으로 인증하므로 — 통제권은 사용자에게 있습니다.
앱에 표시된 엔드포인트와 페어링 토큰으로 호환 클라이언트를 추가하세요.
Mac에서 GO AI Chat을 열고 설정 → MCP Server로 이동해 MCP 서버 활성화를 켜세요. 상태 표시등이 초록색으로 바뀌며 현재 엔드포인트 http://127.0.0.1:8722/mcp가 표시됩니다. 8722 포트가 사용 중이면 언제든 변경할 수 있습니다.
페어링 토큰 섹션에서 복사를 누르세요. 이 토큰은 모든 요청을 인증합니다 — 비밀번호처럼 다루세요. 다시 생성을 누르면 토큰이 교체되고, 이전 토큰을 쓰던 클라이언트는 즉시 차단됩니다.
아래 연결 스니펫을 MCP 클라이언트에 붙여 넣으세요. <YOUR_TOKEN>을 방금 복사한 토큰으로 바꾸면 됩니다 (앱의 스니펫에는 이미 포함되어 있습니다).
터미널에서 실행:
claude mcp add --transport http goai-chat http://127.0.0.1:8722/mcp --header "Authorization: Bearer <YOUR_TOKEN>"
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>" }
}
}
}
Grok으로 구동되는 이미지·동영상·미디어 생성에 더해, 기기에서 동작하는 Studio 색보정과 무료 읽기 전용 도구까지. 전체 기계 판독용 카탈로그는 list_generation_options를 호출하세요.
generate_image
선택한 스타일 프리셋으로 텍스트에서 이미지를 생성합니다.
1토큰transform_image
PNG 마스크를 이용한 인페인팅을 포함한 이미지 간 스타일 변환.
1토큰generate_video
텍스트로 동영상 클립을 생성합니다. 폴링용 작업 ID를 반환합니다.
초당summarize_media
YouTube URL 또는 PDF/MP4 파일(50MB 이하)을 요약합니다.
5토큰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_image | 1토큰 |
studio_edit_image | 2토큰 |
studio_adjust_image_colors | 1토큰 |
studio_adjust_video_colors | 3토큰 |
summarize_media | 5토큰 |
동영상 — generate_video, studio_image_to_video, studio_edit_video | max(10, round(seconds × 2.5)) — 예: 8초 클립 = 20토큰 |
get_token_balance, get_job_status, list_generation_options | 무료 |
720p 동영상은 유효한 구독이 필요합니다. 잔액은 get_token_balance로 언제든 확인할 수 있습니다.
서버는 127.0.0.1에 바인딩됩니다. 네트워크나 인터넷에는 전혀 공개되지 않으며 — 클라이언트는 같은 Mac에서 연결합니다.
모든 요청에는 페어링 토큰이 포함됩니다. 토큰을 다시 생성하면 접근 권한이 즉시 해제되며 — 이전 클라이언트는 그 순간부터 작동을 멈춥니다.
생성은 로그인한 계정의 Lab 토큰 잔액에서 차감되며 — 앱에서 쓰는 잔액과 같습니다. 읽기 전용 도구는 토큰을 쓰지 않습니다.
동영상 도구는 작업 ID를 즉시 반환합니다. 클립이 준비될 때까지 get_job_status로 확인하세요 — 대기 호출은 없습니다.
호환 MCP 클라이언트는 Bearer Authorization 헤더를 사용하는 스트리밍 HTTP 전송을 지원합니다. Claude Code, Cursor, Claude Desktop에서 검증했습니다.
네. 서버는 Mac용 GO AI Chat 안에서 기기 자체로 동작합니다. 클라이언트가 연결된 동안에는 앱을 열어 두세요. 앱을 닫으면 서버도 멈춥니다.
아직은 아닙니다 — 현재 MCP 서버는 Mac 전용입니다. 같은 계정과 Lab 토큰 잔액을 쓰므로, 생성한 결과는 모든 기기의 기록에도 함께 남습니다.
연결은 무료입니다. 생성 도구는 Lab 토큰에서 차감됩니다(이미지 1, Studio 이미지 편집 2, 미디어 요약 5, 동영상은 초당). 읽기 전용 도구 — 잔액, 작업 상태, 옵션 카탈로그 — 는 무료입니다.
설정 → MCP Server를 열고 페어링 토큰의 다시 생성을 누르거나, 서버를 끄세요. 둘 중 어느 쪽이든 기존 클라이언트는 즉시 차단됩니다.
네. MCP Server 설정에서 1024 이상의 포트를 지정할 수 있습니다. 선택한 포트가 사용 중이면 서버가 다음 포트를 차례로 시도해 비어 있는 포트를 찾은 뒤 현재 URL을 보여 줍니다.
Mac용 GO AI Chat을 받아 MCP 서버를 켜고, 즐겨 쓰는 클라이언트에서 호출하세요.
궁금한 점이 있으신가요? support@goaichats.com