Claude Code의 Higgsfield MCP: 작업을 맡기고 동영상 받기

명령어 claude mcp add 하나와 주소 https://mcp.higgsfield.ai/mcp로 Higgsfield를 Claude Code에 연결할 수 있습니다. 그런 다음 자연어로 작업을 맡기면 에이전트가 알아서 Higgsfield에 접속해 이미지나 동영상을 생성한 뒤 바로 창에 결과를 돌려줍니다. 이때 두 가지를 사용합니다. 생성에는 Higgsfield 크레딧이 들고, 서버를 컨텍스트에 유지하는 데는 Claude Code 사용 한도가 듭니다. 그래서 제 규칙은 간단합니다. MCP를 사용하지 않을 때는 꺼 두세요.

예전에는 Higgsfield 웹사이트에 들어가 인터페이스를 파악하고, 프롬프트를 작성하고, 생성하고, 다운로드한 뒤 결과를 프로젝트에 업로드해야 했습니다. 이제 Higgsfield가 자체 MCP를 출시했으므로 Higgsfield에 직접 가거나 인터페이스를 익힐 필요가 없습니다.

이제 Claude Code만으로 모든 것을 생성할 수 있는데, 굳이 Higgsfield에 들어가 생성하는 사람이 있을지 상상하기 어렵습니다.

이 설정으로 전체 프레젠테이션을 만들었고, 프레젠테이션에 들어간 동영상도 모두 이 방식으로 제작했습니다. 전체 작업을 설명해 에이전트에게 맡겼습니다.

한 가지 위험이 있습니다. 에이전트가 이미지 100장을 만들어 낼 수도 있고, 그러면 한 장마다 비용을 내야 합니다. 따라서 모든 작업에 비용과 시도 횟수에 관한 조건을 포함하세요.

순서대로 살펴보겠습니다. 서버 연결 방법, 첫 작업을 맡기는 방법, 무엇을 사용하게 되는지, 서버를 언제 꺼야 하는지 알아봅니다.

1단계. Claude Code MCP 설정: claude mcp add로 Higgsfield 서버 추가하기#

이미지와 동영상을 생성할 프로젝트 폴더에서 터미널을 열고 다음을 실행하세요.

claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

주소는 공식 higgsfield.ai/mcp 페이지에 있습니다. Copy connector URL 버튼을 눌러 복사하세요.

--scope 플래그를 지정하지 않으면 서버는 현재 프로젝트에만 추가됩니다. --scope project를 지정하면 해당 프로젝트의 팀 전체에서 사용할 수 있고, --scope user를 지정하면 모든 프로젝트에서 사용할 수 있습니다.

Higgsfield를 실제로 사용하는 곳에 추가하세요. 코드나 글을 작성하는 프로젝트에서는 아무 일도 하지 않으면서 컨텍스트 공간만 차지합니다.

Claude Code의 다른 서버는 별도의 글에서 다뤘습니다.

2단계. /mcp에서 Higgsfield 계정에 로그인하기#

Claude Code를 실행하고 /mcp를 입력하세요. 목록에서 higgsfield를 선택하면 브라우저가 열립니다. Higgsfield 계정에 로그인하세요.

생성 비용은 이 계정에 청구됩니다. 로그인하기 전에는 서버가 401 오류를 반환합니다. Claude Code에서 서버를 볼 수는 있지만 사용할 수는 없습니다.

3단계. 서버 연결 상태 확인하기#

터미널에서 다음을 실행하세요.

claude mcp list

higgsfield 서버 상태가 ✔ Connected로 표시되어야 합니다.

상태가 다르면 주소, 범위, 서버 상태 등 세부 정보를 확인하세요.

claude mcp get higgsfield

그래도 해결되지 않으면 서버를 제거한 다음 다시 추가하세요.

claude mcp remove higgsfield
claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

그런 다음 /mcp에서 다시 로그인하세요. Claude Code는 서버를 제거할 때 저장된 로그인 정보도 삭제하므로 다시 로그인하지 않으면 같은 401 오류가 발생합니다.

이미지와 동영상 제작을 위한 첫 작업 맡기기#

아무것도 생성하지 않는 작업부터 맡겨 보세요. 비용을 쓰기 전에 서버가 할 수 있는 일을 에이전트에게 보여 달라고 하세요.

Higgsfield 서버에서 사용할 수 있는 도구와 모델, 각 모델로 생성할 때 필요한 크레딧을 알려줘. 아무것도 생성하지 마.

다음에는 실제 작업을 맡기세요. 각 작업 끝에 조건을 하나 추가하세요. 유료 생성 전에 비용을 표시하고 시도 횟수를 합의하라고 요청하면 됩니다.

시도 횟수 제한이 있는 /goal 프롬프트도 같은 원리로 작동합니다. 에이전트가 미리 정해진 제한 횟수 안에서 시도합니다.

웹사이트 히어로 섹션용 이미지 작업:

내 제품 웹사이트의 히어로 섹션에 사용할 이미지를 Higgsfield에서 준비해 줘. 제품: [link]. 제품을 설명하는 데 도움이 되는 피사체, 각도, 색상, 배경을 제안해 줘. 페이지 제목과 버튼을 넣을 공간을 프레임에 남겨 둬. 가로 형식으로 해 줘. 완성된 파일을 프로젝트의 images 폴더에 저장해 줘.
유료 생성을 하기 전에 비용을 알려 주고, 시도 횟수를 합의한 다음 내 “yes”를 기다려 줘.

이 이미지를 바탕으로 동영상 만들기:

이미지 images/hero.png를 바탕으로 Higgsfield에서 짧은 동영상을 만들어 줘. 카메라가 제품을 향해 천천히 이동하고 배경도 약간 움직이게 해 줘. 모델을 제안하고 동영상 길이를 물어봐 줘. 버전은 1개 만들어 줘.
유료 생성을 하기 전에 비용을 알려 주고, 시도 횟수를 합의한 다음 내 “yes”를 기다려 줘.

그러면 에이전트가 알아서 Higgsfield에 접속해 프롬프트를 작성하고 생성한 다음 이미지나 동영상을 가져와 Claude Code 창에서 전달합니다. 무엇을 바꾸고 싶은지도 자연어로 말하면 됩니다.

사용할 수 있는 모델과 생성 비용#

Higgsfield는 구독에 모든 AI 도구가 포함되어 있어 저에게 잘 맞습니다. 다만 크레딧을 사용합니다.

앞 절의 첫 작업으로 에이전트에게 모델 목록을 요청하세요. 그러면 오늘 기준으로 사용할 수 있는 모델과 크레딧 가격을 확인할 수 있습니다.

MCP를 통한 생성에는 Higgsfield 계정의 크레딧이 청구됩니다. 서버 자체는 Claude Code 사용 한도를 쓰므로 사용량 계량기가 두 개입니다. 별도의 글에서 Claude Code 토큰이 어디에 쓰이는지 설명했습니다.

MCP 서버가 사용하는 한도와 서버를 꺼야 할 때#

모든 MCP 서버는 사용 한도를 씁니다. 서버 도구의 설명이 모델 컨텍스트에 추가되기 때문입니다.

Claude Code에서는 도구 검색이 기본으로 활성화되어 있습니다. 세션을 시작할 때 서버의 도구 이름과 안내가 로드되고, 전체 설명은 필요할 때 로드됩니다. Claude Code가 사용자의 ANTHROPIC_BASE_URL을 통해 실행되면 검색이 비활성화되고 설명 전체가 로드됩니다. 두 경우 모두 서버는 모든 세션의 컨텍스트 공간을 차지합니다.

MCP 도구를 아주 많이 설치하면 별다른 이점 없이 사용 한도만 소모됩니다. 그러므로 중요한 규칙이 있습니다. MCP를 사용하지 않을 때는 꺼 두어 컨텍스트 창을 과부하시키지 마세요.

서버를 다음과 같이 껐다가 다시 켤 수 있습니다.

• 일시적으로 끄기. /mcp에서 higgsfield 옆의 토글을 사용하세요. Claude Code가 서버 연결을 중단하고 설정을 저장하며, 이 프로젝트에 해당 선택을 기억합니다.
• 완전히 제거하기. claude mcp remove higgsfield를 실행하세요. 서버와 함께 저장된 계정 로그인 정보도 삭제됩니다.
• 다시 켜기. /mcp에서 같은 토글을 사용하거나 claude mcp add를 다시 실행한 다음 /mcp에서 로그인하세요.

이미지와 동영상 작업을 하는 동안에는 서버를 켜 두세요. 코드나 글을 쓰고 생성할 일이 없다면 끄세요.

참고로 Hermes를 사용해 첫 에이전트를 설정하는 전체 가이드를 만들었습니다. 확인해 보세요.

가이드에서는 MCP가 무엇인지, 악성 MCP를 설치하지 않으려면 어떻게 해야 하는지, 비용은 얼마나 드는지 설명합니다. 시청하고 나면 에이전트에 실제로 어떤 연결이 필요한지 알게 될 것입니다.

MCP, Higgsfield 프로그램, 비공식 서버 중 어떤 방법을 선택할까#

Higgsfield를 에이전트에 연결하는 방법은 세 가지입니다.

MCP 서버부터 시작하세요. 명령어 하나로 설치하고 토글 하나로 끌 수 있습니다. 매일 생성하며 서버가 컨텍스트를 차지하지 않게 하고 싶다면 스킬을 포함한 Higgsfield 프로그램을 살펴보세요.

다음 단계: 연결된 Higgsfield 계정에서 위의 도구·모델·크레딧 비용을 생성 없이 확인하세요. 생성하기 전에 원하는 결과 하나와 시도 예산을 정하세요. 별도의 Ailoot API 경로를 쓰려면 이미지 요청 가이드 또는 동영상 작업과 결과 가이드를 따르세요. 이 문서는 Ailoot API 호출에 관한 것이며 이 Higgsfield MCP 계정의 절차가 아닙니다.