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

> 명령어 하나로 Higgsfield MCP를 Claude Code에 연결하고, 에이전트에게 이미지나 동영상 제작을 맡기는 방법과 사용 한도를 소모하지 않도록 서버를 언제 끄면 되는지 알아봅니다.

Source: https://ailoot.ai/blog/ko/higgsfield-mcp-claude-code/
Canonical: https://ailoot.ai/blog/ko/higgsfield-mcp-claude-code/
Language: ko
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-120
Revision: sha256-05150959751be5e6b3296376bfb8cc43a5b303a4283d259c64fe7e45a809d422


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

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

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway">

핵심 요점

터미널 명령어 하나로 연결하세요: `claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp`. 그런 다음 Claude Code에서 `/mcp`를 입력하고 higgsfield를 선택한 뒤 브라우저에서 Higgsfield 계정으로 로그인하세요. API 키는 필요하지 않습니다. `claude mcp list`로 확인하면 서버 상태가 ✔ Connected로 표시되어야 합니다. 생성에는 Higgsfield 계정의 크레딧이 사용되므로, 각 작업에서 비용을 표시하고 시도 횟수를 합의하도록 요청하세요. 생성할 일이 없을 때는 `/mcp`의 토글로 서버를 꺼 두세요. 서버는 컨텍스트를 차지하고 Claude Code 사용 한도를 소모합니다.

</div>

## 1단계. Claude Code MCP 설정: claude mcp add로 Higgsfield 서버 추가하기 {#1단계-claude-mcp-add-명령어로-higgsfield-서버-추가하기}

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

```bash
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의 다른 서버는 [별도의 글](https://ailoot.ai/blog/ko/mcp-servers-claude-code/)에서 다뤘습니다.



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

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

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

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

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

```bash
claude mcp list
```

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

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

```bash
claude mcp get higgsfield
```

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

```bash
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 토큰이 어디에 쓰이는지](https://ailoot.ai/blog/ko/where-claude-code-tokens-go/) 설명했습니다.

| 사용 항목 | 사용 용도 | 확인 위치 | 사용량 줄이는 방법 |
|----|----|----|----|
| Claude Code 사용 한도 | 컨텍스트에 들어가는 도구 이름과 서버 안내, 사용자 메시지, 에이전트 작업 | Claude Code 구독 한도 | 생성하는 프로젝트에만 서버를 두고, 생성할 일이 없을 때는 끄기 |
| Higgsfield 크레딧 | 이미지나 동영상 생성 건별 사용 | Higgsfield 계정 또는 에이전트에게 문의 | 비용을 표시하고 작업마다 시도 횟수를 합의하도록 요청하기 |



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

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

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

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

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

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

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

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

<figure>
스크롤을 내리면 동영상이 로드됩니다
<figcaption>전체 가이드 - 첫 Hermes Agent 설정</figcaption>
</figure>

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

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

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

| 방법 | 설치 방법 | 유의할 점 |
|----|----|----|
| Higgsfield MCP 서버 | 주소 `https://mcp.higgsfield.ai/mcp`를 사용해 `claude mcp add`를 실행한 다음 브라우저에서 계정에 로그인 | 설치할 것은 없습니다. 서버가 켜져 있는 동안 컨텍스트 공간을 차지합니다 |
| Higgsfield 프로그램과 스킬 | `npm i -g @higgsfield/cli`를 실행한 다음 `higgsfield auth login`을 실행해 브라우저에서 로그인하고, 이어서 `npx skills add higgsfield-ai/skills`를 실행 | Higgsfield가 Claude Code와 Codex에 직접 권장하는 방법입니다. 컨텍스트를 차지하는 상시 실행 MCP 서버가 없습니다 |
| GitHub의 비공식 서버 | 제3자가 만든 빌드로, 브라우저에서 Higgsfield 로그인 정보를 가져옵니다 | 제3자 코드에 계정 접근 권한을 주게 됩니다. Higgsfield 서버 대신 설치하지 마세요 |

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

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

<div class="section">

### 자주 묻는 질문

Higgsfield MCP를 사용하려면 API 키가 필요한가요?

아니요. 브라우저에서 Higgsfield 계정에 로그인하세요. Claude Code에서 /mcp를 입력하고 higgsfield를 선택한 다음 로그인하면 됩니다.

Higgsfield MCP로 동영상 하나를 만드는 데 얼마가 드나요?

모델에 따라 다르며, 크레딧은 Higgsfield 계정에 청구됩니다. 생성 전에 에이전트에게 비용을 알려 달라고 요청하고 승인을 기다리세요.

</div>

<div class="section" role="doc-bibliography" aria-label="Sources">

### 출처

- [Higgsfield: MCP 페이지](https://higgsfield.ai/mcp) - 서버 주소 mcp.higgsfield.ai/mcp, 계정을 통한 로그인, Claude Code와 Codex용 Higgsfield 프로그램 및 스킬 사용 방법
- [Anthropic: Claude Code와 MCP](https://code.claude.com/docs/en/mcp) - claude mcp add, list, get, remove 명령어, --scope 플래그, /mcp 토글, 도구 검색, 컨텍스트에 로드되는 항목

</div>



<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Ailoot Guides">

[Ailoot 가이드](https://ailoot.ai/docs/)

</div>

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Go to Ailoot">

[Ailoot로 이동](https://ailoot.ai/)

</div>

## Claude Code의 Higgsfield MCP: 작업을 맡기고 동영상 받기: 자주 묻는 질문

### 첫 유료 Higgsfield 생성 전에 무엇을 해야 하나요?

생성하지 않은 상태로 사용 가능한 도구, 모델, 크레딧 비용을 나열하도록 요청하세요. 실제 작업에 쓸 모델, 비용 상한, 시도 횟수를 합의한 뒤 유료 생성을 승인하세요.

### Connected가 표시되면 동영상 생성도 성공한 건가요?

아닙니다. 계정 로그인 후 MCP 연결이 됐다는 뜻입니다. 생성에는 승인된 작업과 계정 크레딧이 필요하고 반환된 이미지나 동영상을 직접 확인해야 합니다. 해당 작업을 하지 않을 때는 MCP 서버를 끄세요.


## Ailoot · 회사와 그 프로젝트 포트폴리오

Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.