Claude Code에서 Higgsfield MCP를 사용하려면 터미널에서 claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp를 실행하세요. Claude Code는 브라우저 OAuth를 통해 인증을 처리하며 API 키가 필요 없습니다. 이 서버는 5개의 도구(generate_image, generate_video, create_character, get_generation_status, list_characters)를 7개 모델에 걸쳐 제공합니다. 정상적인 연결 상태에서 설정은 60초 이내에 완료됩니다.
Higgsfield는 2026년 4월 30일, 지금 이 글을 쓰는 시점으로부터 8일 전에 호스팅되는 MCP 서버를 출시했습니다. Claude Code가 설치돼 있다면 한 줄의 명령어로 Higgsfield MCP를 워크플로우에 연결할 수 있으며, API 키도 npm 패키지도 필요 없습니다. 이 글을 다 읽으면 실제로 사용하는 모든 AI 클라이언트에 서버를 설치하게 될 것이고, 7개 모델 중 어느 것을 쓸지 알게 되며, 우리가 블로그 히어로 이미지에 활용하는 프롬프팅 레시피까지 얻게 됩니다.
techsy.io에서는 이미 4개의 Higgsfield 에이전트 스킬(higgsfield-generate, higgsfield-product-photoshoot, higgsfield-soul-id, higgsfield-marketplace-cards)을 커버 및 라이프스타일 이미지에 사용 중이며, MCP 서버를 함께 연결해 대화 중에 더 풍부한 생성 기능을 지원하고 있습니다. MCP는 컨텍스트 엔지니어링이 실제로 도구 레이어에서 어떻게 작동하는지 보여줍니다. URL과 프롬프트를 별도 UI에 붙여넣는 대신 모델이 같은 대화 안에서 어떤 모델을 사용할지, 어떤 파라미터를 쓸지 직접 선택합니다.
Higgsfield MCP가 실제로 하는 일
Higgsfield MCP는 https://mcp.higgsfield.ai/mcp 에 호스팅되는 Model Context Protocol(MCP) 서버로, MCP를 지원하는 모든 AI 클라이언트(Claude Code, Claude Desktop, Cursor, Windsurf, Cline, OpenCode)에서 OAuth 인증을 통해 5개의 도구로 7개 이미지 및 비디오 모델을 호출할 수 있게 해줍니다. API 키 없음, npm install 없음, 프록시 없음.
Higgsfield MCP 서버는 AI 클라이언트와 30개 이상의 생성형 모델 사이에 위치합니다. 호스팅되는 엔드포인트는 우리가 가장 자주 사용하는 7개 모델을 제공합니다. 캐릭터 일관성을 위한 Soul V2, 비디오용 Veo 3.1과 Kling 3.0, 사진적 현실감을 위한 GPT Image 2, 일러스트레이션용 Flux 2, 빠른 반복을 위한 Nano Banana Pro, 짧은 클립용 Seedance 2.0입니다. Claude Code 내에서 대화를 떠나지 않고도 다양한 모델을 서로 다른 모델로 호출할 수 있습니다.
무료 티어: 월 150크레딧, 2026년 5월 기준이며 변경될 수 있습니다.
서버가 제공하는 5개 도구가 전체 인터페이스입니다:
generate_image: 단일 이미지 생성generate_video: 비동기 비디오 생성, 작업 ID 반환create_character: 일관성을 위한 Soul 캐릭터 학습get_generation_status: 비동기 작업 폴링list_characters: 학습된 캐릭터 나열
이게 전부입니다. 5개 도구, API 키 없음, 외울 스코프 없음. 반면 여러 개의 벤더 API를 조각조각 패치해야 한다고 생각해보면 MCP 명세가 왜 널리 채택됐는지 알 수 있습니다. 정확한 모델 목록은 Higgsfield의 공식 MCP 페이지가 신뢰할 수 있는 출처입니다.
Higgsfield MCP를 Claude Code에 추가하려면?
Claude Code에 Higgsfield MCP를 설치하려면 claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp를 실행하세요. Claude Code는 처음 사용할 때 OAuth를 위해 브라우저를 열고, Higgsfield 계정으로 로그인한 후 터미널로 돌아가 claude mcp list 또는 /mcp 슬래시 명령어로 확인하면 됩니다. 이것이 전체 Higgsfield MCP 설정입니다.
기존 튜토리얼의 대부분이 이 부분을 잘못 설명합니다. 4월 30일 이전에는 호스팅되는 서버가 없었고, 저자들은 npm 패키지를 설치하고 HIGGSFIELD_API_KEY를 셸에 붙여넣을 거라고 가정했습니다. 그럴 필요 없습니다. 호스팅되는 MCP는 Higgsfield 인프라 위에서 실행되며 브라우저의 OAuth를 통해 인증됩니다.
설치 명령어입니다. 터미널에 붙여넣으세요:
claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp
알아두면 좋은 2가지 플래그가 있습니다. --transport http는 Claude Code에 이것이 로컬 stdio 프로세스가 아닌 HTTP 기반 호스팅 서버임을 알립니다. --scope user는 설정을 ~/.claude/mcp.json에 쓰므로 열수 있는 모든 프로젝트에서 서버를 사용할 수 있습니다. 한 저장소에서만 사용하고 싶으면 (팀이 git에 체크인해 받을 수 있도록) --scope project를 대신 사용하세요. 그러면 repo 루트의 .mcp.json에 씁니다.
작동하는지 확인하세요:
claude mcp list
Higgsfield 도구를 처음 호출할 때 Claude Code는 포트 8080에 로컬 OAuth 콜백을 생성하고 브라우저를 엽니다. Higgsfield 계정으로 로그인하고 터미널로 돌아가면 끝입니다. 모든 Claude Code 세션에서 /mcp를 실행해 패널을 볼 수 있습니다. Higgsfield가 5개의 도구 목록과 함께 나타나야 합니다.
제가 지금 사용 중인 M3 Pro에서는 설치 + OAuth 왕복이 47초 만에 완료됐습니다. 네트워크 상황에 따라 다르겠지만, 2분을 넘어가면 끝 부분의 함정(Gotchas) 섹션으로 바로 이동하세요.
한 가지 참고: 동일한 MCP를 Claude Code 스킬 뒤에 래핑하려면 robonuggets의 higgsfield-skill 저장소가 정확히 그것을 합니다. Claude Code 스킬 튜토리얼에서 그 패턴을 다뤘습니다. MCP 서버 주변의 자동화를 훅으로 실행할 수도 있습니다. 예를 들어, 블로그 히어로 생성 전에 자동으로 list_characters 호출을 실행합니다. 정규 설정 문법은 Anthropic의 Claude Code용 MCP 설정 문서에서 트랜스포트 타입, 스코프 플래그, 재인증 흐름을 완전히 다룹니다.
Claude Code 세션 내 generate_image 도구 호출.
Higgsfield MCP를 Claude Desktop에 추가하려면?
Claude Desktop은 claude mcp add CLI 대신 JSON 설정 파일(claude_desktop_config.json)을 사용합니다. 위치는 OS마다 다릅니다. 파일을 편집하고 higgsfield 블록을 추가한 후 Claude Desktop을 완전히 종료했다가 다시 시작하세요. OAuth는 설정 로드가 아닌 도구 호출 시에 실행됩니다.
다음을 추가하세요:
{
"mcpServers": {
"higgsfield": {
"url": "https://mcp.higgsfield.ai/mcp",
"transport": "http"
}
}
}
Claude Desktop이 서버는 나열됐지만 도구가 안 보인다고 하면, 완전히 종료하지 않은 것입니다. macOS에서는 Cmd-Q를 누르고, 빨간 신호등 버튼이 아닙니다. 창을 닫으면 프로세스는 계속 실행되고 구 설정이 메모리에 남아있습니다.
Higgsfield MCP Cursor 설정
Cursor에서 Higgsfield MCP를 사용하려면 ~/.cursor/mcp.json을 편집하고 HTTP 트랜스포트로 https://mcp.higgsfield.ai/mcp를 가리키는 higgsfield 서버를 추가하세요. Cursor를 재시작하면 서버가 Settings → MCP Servers 아래에 나타나고 첫 생성 요청 시 OAuth를 통해 인증됩니다. 동일한 JSON은 프로젝트 루트의 .cursor/mcp.json으로도 작동합니다.
Cursor는 URL 필드에서 HTTP 트랜스포트를 자동 감지하므로 명시적으로 선언할 필요가 없습니다. 설정은 다음과 같습니다:
{
"mcpServers": {
"higgsfield": {
"url": "https://mcp.higgsfield.ai/mcp"
}
}
}
파일을 저장하고 Cursor를 재시작한 후 Settings → MCP Servers를 열어보세요. 녹색 점과 함께 "higgsfield"가 보여야 합니다. Cursor에 "Generate a hero image of a fox at golden hour using Higgsfield"라고 요청하면 브라우저가 OAuth를 위해 열리고 로그인하는 즉시 생성이 실행됩니다.
이를 블로그 히어로 이미지에 항상 Higgsfield를 사용하도록 하는 Cursor 규칙과 짝지으세요. .cursor/rules/blog-images.mdc에 규칙을 드롭하고 "blog hero" 또는 "OG image" 요청을 기본 종횡비와 함께 generate_image에 매핑하세요. 팁: repo 루트에 .cursor/mcp.json을 체크인하는 대신 사용자 스코프 파일을 사용하면, 팀 전체가 풀할 때 서버를 받습니다. 개발자별 설정 없음, 도구가 왜 안 보이는지에 대한 Slack 스레드 없음.
Higgsfield 서버가 등록된 Cursor mcp.json.
Windsurf나 Cline에 Higgsfield MCP를 설치하려면?
두 클라이언트 모두 VS Code 스타일의 mcp.json 형식을 사용하므로 동일한 JSON이 둘 다에서 작동합니다. Windsurf는 ~/.codeium/windsurf/mcp_config.json을 읽고, Cline(VS Code 확장)은 Settings UI를 사용하거나 워크스페이스의 .vscode/mcp.json을 사용합니다.
Cline 팁으로 기억할 가치가 있는 것: "Auto-approve safe tools"를 list_characters와 get_generation_status에 대해서만 활성화하세요. generate_video는 자동 승인하지 마세요. 각 호출은 30~60크레딧을 소비하고, 루프에서 실행되는 자율 에이전트는 무료 티어를 5분 만에 전부 써버릴 수 있습니다. 읽기 도구는 네, 생성 도구는 아니요.
두 클라이언트가 일상에서 어떻게 비교되는지 궁금한가요? 우리의 Windsurf vs Cursor 분석이 트레이드오프를 다룹니다. Higgsfield 관련해서는 서버가 등록되면 경험이 동일합니다. 두 클라이언트 모두 동일한 MCP 와이어 프로토콜을 사용합니다.
Higgsfield MCP는 OpenCode에서 작동하나요?
...