Higgsfield를 Claude에 연결하는 방법

Higgsfield MCP 서버란?

MCP(Model Context Protocol)는 AI 어시스턴트가 다른 서비스의 도구를 호출할 수 있게 하는 오픈 표준입니다. 플러그라고 생각하면 쉽습니다. Claude가 사용자 대신 누를 수 있는 Higgsfield 버튼 세트를 갖게 되는 셈입니다.

Higgsfield MCP 서버가 바로 그 플러그입니다. 도움말 센터는 이를 통해 “Claude 또는 MCP를 지원하는 다른 에이전트 안에서 바로 Higgsfield의 이미지, 영상, 캐릭터, 오디오를 생성”할 수 있다고 설명합니다(MCP 문서, 2026년 8월 1일 자).

기존 계정과 플랜을 그대로 씁니다. Higgsfield API는 별도 상품으로, 자체 키와 달러 잔액을 씁니다. 해당 경로는 Higgsfield API 가이드에서 다룹니다.

붙여넣기 전에 꼭 확인할 안전 수칙이 하나 있습니다. Higgsfield 플랫폼 안내 문서는 “공식 커넥터 URL은 mcp.higgsfield.ai/mcp뿐”이며 다른 주소의 커넥터는 “Higgsfield가 아니다”라고 밝힙니다(공식 플랫폼).

Higgsfield를 Claude에 연결하는 방법

아래 단계는 2026년 8월 1일 자 Higgsfield 연결 문서를 따랐습니다. claude.ai와 Claude Desktop에서 모두 같은 방식으로 작동합니다.

1. Settings, Connectors 순서로 엽니다. Higgsfield가 What is Higgsfield MCP? 문서에 커넥터를 설명해 두었으니 Claude 설정 옆에 열어 두고 참고하면 좋습니다.
2. Add custom connector를 클릭합니다.
3. 이름을 Higgsfield로 입력하고 https://mcp.higgsfield.ai/mcp를 붙여넣습니다.
4. Connect를 클릭하면 Higgsfield 인증 창이 열립니다.
5. Higgsfield에 로그인하고 승인합니다. higgsfield.ai에 이미 로그인된 상태라면 이 단계는 자동으로 넘어갑니다.
6. 다시 Claude로 돌아오면 활성 커넥터 목록에 Higgsfield가 표시됩니다.

작동 여부를 확인하려면 새 채팅에서 “내 Higgsfield 크레딧 잔액은?”이라고 물어보면 됩니다. 문서에 따르면 Claude가 Higgsfield 도구를 호출해 계정 데이터를 반환합니다. Claude가 도구 호출 없이 답하면 다시 연결해야 합니다.

Higgsfield 플랜은 유료여야 합니다. 문서에는 “활성 유료 구독이 필요합니다”라고 분명히 적혀 있습니다.

Generate Images and Videos Inside Claude (Higgsfield MCP Setup)Teacher's Tech

Claude Code와 Codex는 CLI로 연결

코딩 에이전트는 다른 길을 씁니다. Higgsfield CLI 문서는 CLI와 스킬이 “Claude Code, Cursor, Codex”용으로 만들어졌다고 밝힙니다. CLI(명령줄 도구)는 전체 MCP 연결보다 호출당 토큰을 덜 씁니다. CLI 문서에 따르면 각 스킬의 “정해진 구조가 토큰 부담을 줄여” 주기 때문입니다.

Claude Code의 경우, 도움말 센터가 에이전트에 붙여넣을 메시지 하나를 제공합니다. 에이전트는 이 메시지에 따라 명령 세 개를 실행합니다.

npm i -g @higgsfield/cli
higgsfield auth login
npx skills add higgsfield-ai/skills

로그인은 열리는 브라우저 창에서 마무리합니다.

How to Connect Higgsfield AI to Claude Code (Step by Step)MMX

Codex도 같은 절차입니다. CLI 문서에 호환 에이전트로 올라 있고, higgsfield.ai/mcp의 스킬에는 “Open in Codex” 버튼이 있습니다.

스킬을 설치하면 세 가지가 들어옵니다. 이미지·영상용 generate, 사진으로 Soul 캐릭터를 학습시키는 soul, “제품 링크나 이미지를 스튜디오급 제품 컷과 영상 광고로 바꿔 주는” product-photoshoot입니다. 코딩 에이전트에서는 /higgsfield:generate를 호출하거나 그냥 이미지를 요청하면 됩니다.

요청할 수 있는 작업

커넥터를 통해 Claude는 모든 Higgsfield 모델의 이미지·영상 생성, 업스케일, 배경 제거, 이미지 확장, 영상 리프레이밍, Kling 3.0 Motion Control을 쓸 수 있습니다. Soul 캐릭터, 저장한 Elements, 보이스오버·더빙 같은 오디오 작업도 처리하고 크레딧 잔액도 읽을 수 있습니다. 모든 결과물은 higgsfield.ai의 Assets에 MCP 태그가 붙어 저장됩니다. Resolve, Premiere, Photoshop에서 작업하는 편집자는 Higgsfield 플러그인을 대신 쓸 수 있습니다.

모델을 지정하지 않으면 에이전트가 고릅니다. 도움말 센터의 예시는 모델을 직접 지정합니다. “Generate a video using Seedance of a person walking through a forest at sunrise, realistic motion, camera tracking close.”

Higgsfield는 “스킬”도 제공합니다. 콘셉트, 스크립트, 각 생성 같은 중간 단계를 요청 하나로 처리하는 프리셋 워크플로이며, 플랜 크레딧으로 실행됩니다. 스킬 페이지에는 Paid Ads 카테고리에 8개가 있고, “영상 하나에 여러 오프닝 훅”을 만드는 Hook Multiplier와 새 노출 지면용 Ad Resizer 등이 포함됩니다. UGC 스타일 광고용으로는 Product review UGC, Unboxing UGC, Try-on UGC가 있습니다.

도움말 센터의 표현을 바탕으로 만든, 제품 클립 요청 예시입니다.

Before generating anything, tell me the credit cost and wait for my confirmation.
Open the Higgsfield upload window for my product photo.
Use the uploaded image as the start frame and generate a 5-second 9:16 video with Kling 3.0 at 720p: the bottle turns slowly on a kitchen counter, morning light from the window on the left.

첫 번째 줄은 고객센터가 안내하는 지출 한도 장치입니다. 두 번째 줄이 중요한 이유는 문서에 따르면 “에이전트는 채팅에 첨부된 이미지를 직접 읽을 수 없기” 때문입니다. 파일은 에이전트가 여는 업로드 창을 통해 Higgsfield로 전달됩니다. Higgsfield 가격 페이지에서 5초짜리 Kling 3.0 클립(해상도 720p)은 7크레딧입니다. Plus 플랜 기준으로 약 0.34달러이며, 가격은 2026년 11월 2일 확인 기준입니다.

MCP는 Unlimited일까, 크레딧일까?

모든 플랜에서 크레딧입니다. Higgsfield MCP 문서는 “MCP로 생성한 모든 결과물은 플랜과 관계없이 크레딧이 차감”되며 Unlimited 이용과 무료 생성은 “higgsfield.ai에서만 적용”된다고 밝힙니다. CLI, Canvas, Supercomputer에도 같은 규칙이 적용됩니다.

그래서 웹사이트에서는 무료인 모델도 Claude에서는 표준 요금이 나옵니다. 도움말 센터는 가장 흔한 불만에 직접 답합니다. Unlimited 모델이 MCP에서 과금되는 것은 “정상”이라는 것입니다. Unlimited 작업은 브라우저에서 한꺼번에 돌리고, 비용을 낼 가치가 있는 작업만 Claude로 보내는 편이 좋습니다. Unlimited에 포함되는 범위는 Higgsfield Unlimited 설명에서 다룹니다.

유일한 예외는 Higgsfield 요금 페이지의 1일 체험입니다. 이 체험의 무제한 이용은 “Higgsfield MCP와 higgsfield.ai에서 모두 작동”합니다.

지출 상한은 따로 없습니다. 도움말 센터는 채팅에서 정한 크레딧 한도를 “프롬프트 수준의 지시일 뿐, 강제 한도가 아니다”라고 설명합니다.

I Created This New Claude Skill To Stop Bleeding Credits With Higgsfield MCPCraig Does AI

사용자들도 같은 불만을 전합니다. 공개 출처 52곳 중 8곳이 생성이 느리거나 실패해도 크레딧이 소진된다고 말합니다. API와 MCP 실행이 실패하거나 지시를 무시한다는 사례도 있습니다(YouTube, Reddit).

커넥터가 안 될 때 해결법

도움말 센터가 꼽는 흔한 오류는 세 가지입니다.

• “Authorization with the MCP server failed.” 로그인 토큰이 만료된 경우입니다. Settings → Connectors에서 Higgsfield 연결을 해제한 뒤 다시 연결합니다.
• 연결은 됐는데 Claude가 Higgsfield를 호출하지 않는 경우. 새 채팅을 열고 요청에 Higgsfield를 명시한 뒤, 해당 채팅에서 커넥터 토글이 켜져 있는지 확인합니다.
• Cursor 등 다른 클라이언트에서 “MCP HTTP exchange failed”가 뜨는 경우. 요청을 다시 시도하고, 오류가 반복되면 서버를 삭제한 뒤 다시 추가합니다.

연결 문서에 따르면 완료된 작업이 Assets에 나타나기까지 최대 60초 걸릴 수 있습니다. 크레딧이 차감됐는데 결과물이 오지 않았다면, 문서는 생성 ID와 시간을 적어 고객지원에 문의하라고 안내합니다. 플랜, 크레딧, 환불 규정은 Higgsfield 가격에서, 플랫폼 전반의 사용자 평가와 불만은 Higgsfield 후기에서 볼 수 있습니다.

용도별로 정리한 Higgsfield 가이드 전체는 Higgsfield 허브에서 볼 수 있습니다 →