studio.soluta

먼저 볼 카드 — Notion 연결 — MCP

설치 MCP

Claude에 Higgsfield 연결하기

이 카드를 다루는 수업 좋은 프롬프트로 이미지와 영상 만들기 파리 거리에서 자전거 타기

연결 뒤 첫 요청은 생성이 아닙니다

Higgsfield를 Claude에 연결하면 이미지와 영상 생성 도구를 대화 안에서 부를 수 있습니다. 이때 첫 요청은 결과물 생성이 아니라 연결 상태와 잔여 크레딧 확인입니다.

Higgsfield는 모델과 해상도 같은 설정에 따라 크레딧을 차감합니다. 따라서 모델을 고른 뒤 higgsfield generate cost로 한 번 만들 때 필요한 크레딧을 먼저 확인합니다.

생성 전에 네 가지가 있어야 합니다

  • 승인된 콘티
  • 사용할 입력 이미지
  • 모델과 설정
  • 예상 크레딧과 생성 횟수

네 항목 중 하나라도 비어 있으면 생성하지 않습니다. 여러 테이크가 필요해도 한 장 또는 한 숏으로 방향을 확인한 뒤 다음 생성을 승인받습니다.

이미지가 없으면 Codex에서 먼저 만듭니다

기존에 사용할 이미지가 없으면 Codex의 이미지 생성으로 시작 프레임을 만듭니다. 사람이 제품 형태, 글자, 구도, 브랜드 기준을 확인해 승인한 이미지 한 장만 Higgsfield 영상 입력으로 넘깁니다.

이미지와 영상을 같은 유료 도구에서 연속으로 만들면 어느 단계에서 어긋났는지 찾기 어렵고 크레딧도 두 번 씁니다. 정지 이미지에서 방향을 먼저 고정하면 영상 단계에서는 움직임만 검수할 수 있습니다.

승인 문장에는 범위를 적습니다

아래 네 항목을 한 줄에 적습니다.

승인: SHOT-01 · 영상 1회 · 예상 24cr · 입력 이미지 approved-frame.png

이 문장은 SHOT-01 한 건과 1회 생성만 승인합니다. 모델, 길이, 해상도, 생성 횟수가 바뀌면 비용을 다시 확인하고 새 승인을 받습니다.

예시 화면 Claude 커스텀 커넥터 입력창에 Higgsfield 이름과 MCP 주소를 적은 화면
Claude의 커스텀 커넥터 입력창에 이름과 공식 MCP 주소를 적은 화면입니다.
  1. Claude 웹이나 데스크톱 앱에서 사용자 지정 커넥터를 엽니다. 아래 공식 연결 페이지의 버튼을 누르면 입력창까지 바로 이동합니다.

    Claude 커넥터 추가 화면 열기
    https://claude.ai/customize/connectors?modal=add-custom-connector

    확인이름과 원격 MCP 서버 URL을 적는 커스텀 커넥터 추가 창이 열립니다.

  2. 이름에는 Higgsfield를, 주소에는 아래 공식 MCP 주소를 붙여넣습니다. OAuth 클라이언트 ID와 시크릿은 비워 둡니다.

    명령어로 직접 하기

    연결 주소입니다. 터미널에서 실행하는 명령이 아닙니다. Claude의 원격 MCP 서버 URL 칸에 붙여넣습니다.

    https://mcp.higgsfield.ai/mcp
  3. 추가를 누른 뒤 Higgsfield 계정으로 로그인하고 연결을 승인합니다. 연결 뒤에는 생성하지 말고 도구와 잔액부터 확인합니다.

    Higgsfield 연결 상태를 확인해 주세요. 이미지나 영상은 생성하지 마세요. 사용할 수 있는 도구 이름, 현재 잔여 크레딧, 비용을 생성 전에 확인할 수 있는 방법만 알려 주세요.

    확인연결 상태와 잔여 크레딧이 나오고, 생성 작업은 시작되지 않습니다.

    이 단계의 실제 화면
    Claude 커스텀 커넥터 입력창에 Higgsfield 이름과 MCP 주소를 적은 화면
    화면에서 확인할 것 공식 MCP 주소를 넣고 연결한 뒤 생성 전에 잔여 크레딧을 확인합니다. Claude custom connectors · 2026-08-03
  4. Claude Code에서 쓸 사람은 공식 설치 문장을 Claude Code 채팅창에 그대로 붙여넣습니다. 브라우저 로그인은 본인이 완료합니다.

    Higgsfield 공식 설치 페이지 열기
    Set up Higgsfield for me so I can generate images and videos from here.
    1. Install the CLI: run `npm i -g @higgsfield/cli`.
    2. Authenticate: run `higgsfield auth login` and complete the sign-in in the browser it opens.
    3. Install the companion skills: run `npx skills add higgsfield-ai/skills`.
    Once that's done, let me know when it's ready.

    확인Higgsfield CLI와 보조 스킬이 설치되고, 브라우저에서 로그인을 마치면 준비됐다는 답이 나옵니다.

  5. 생성 전에는 계정 잔액과 사용할 영상 모델을 확인합니다.

    명령어로 직접 하기

    두 명령은 조회만 합니다. 계정의 잔여 크레딧과 사용할 수 있는 영상 모델 목록이 나오면 성공입니다.

    higgsfield account status
    higgsfield model list --video
  6. 콘티가 확정되면 선택한 모델과 설정으로 예상 크레딧을 계산합니다. 이 명령은 결과물을 만들지 않습니다.

    명령어로 직접 하기

    <video_model>은 앞 단계에서 확인한 실제 모델 이름으로 바꿉니다. 시작 이미지가 없는 모델이라면 --image 항목을 빼고, 모델별 입력값은 `higgsfield model get <video_model>`로 확인합니다.

    higgsfield generate cost <video_model> --prompt "승인된 한 숏 프롬프트" --image ./_assets/generated/images/codex/approved-frame.png

직접 해보기

내 상황에 맞춰
내 프로젝트에서 Higgsfield를 사용하기 전에 확인할 항목을 연결 상태, 잔액, 콘티, 입력 이미지, 모델, 예상 크레딧, 승인 문장 순서로 체크리스트로 만들어 주세요. 생성은 하지 마세요.

대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.

한 단계 더
아래 한 숏의 모델과 설정을 읽고 Higgsfield 예상 비용 확인 명령만 만들어 주세요. 실행하거나 생성하지 마세요.
모델: [모델 이름]
프롬프트: [한 숏 프롬프트]
입력 이미지: [파일 경로 또는 없음]

Higgsfield를 연결한 뒤 생성하지 않은 상태에서 잔여 크레딧과 예상 크레딧 확인 명령을 각각 한 번 확인합니다.

헷갈리기 쉬운 것

Higgsfield 공식 페이지는 Claude 웹·데스크톱 앱에는 MCP 연결을, Claude Code에는 CLI 설치를 안내합니다. 둘을 한꺼번에 설치할 필요는 없습니다. 사용자 지정 커넥터에 API 키나 OAuth 시크릿을 직접 적지 않습니다. `generate cost`와 `generate create`는 이름이 비슷하지만, 앞의 명령은 예상 비용만 계산하고 뒤의 명령은 실제 크레딧을 씁니다.

왜 이렇게 작동하나요

결제 전에 장바구니 금액을 확인하는 것처럼, 영상 생성 전에 한 숏의 예상 크레딧을 확인합니다.

연결 확인, 잔액 확인, 비용 계산은 크레딧을 쓰지 않습니다. 모델과 입력 이미지가 확정된 뒤 횟수까지 적어야 승인 범위를 계산할 수 있습니다.

더 알고 싶다면

MCP와 CLI를 모두 설치해야 합니까?
  • Claude 웹·데스크톱 앱은 MCP를 사용하고 Claude Code는 CLI를 사용합니다. 실제로 쓸 경로 하나만 연결합니다.
  • 어느 쪽인지는 생성 요청을 어디에서 보낼지로 정합니다. 대화하면서 한 장씩 확인할 계획이면 앱의 MCP가, 프로젝트 폴더 안에서 파일로 받으며 작업할 계획이면 Claude Code의 CLI가 맞습니다.
  • 두 경로를 다 연결하더라도 크레딧은 같은 Higgsfield 계정에서 차감되므로, 생성 전 잔액·예상 크레딧 확인 습관은 어느 경로에서든 동일하게 적용합니다.
왜 입력 이미지를 먼저 승인합니까?
  • 정지 이미지의 제품 형태와 구도가 틀리면 영상에서도 같은 문제가 움직입니다. 영상 단계에서는 움직임만 검수할 수 있게 시작 프레임을 먼저 고정합니다.
  • 비용 순서 문제이기도 합니다. 이미지 단계에서 잡을 결함을 영상까지 만들고 나서 발견하면 이미지와 영상 두 단계의 크레딧을 다시 씁니다.
  • 승인 문장에 입력 이미지 파일명이 들어가는 이유도 여기 있습니다. approved-frame.png처럼 확정본에 이름을 붙여 두면 어떤 이미지가 영상으로 넘어갔는지 나중에 추적할 수 있습니다.

새 상황에 적용

한 숏 비용만 계산하기

모델, 프롬프트, 입력 이미지, 생성 횟수를 적고 cost 명령으로 예상 크레딧만 확인합니다.

확인할 결과

생성 작업이 0건이고 예상 크레딧과 잔여 크레딧이 함께 기록됩니다.

막혔을 때 확인할 순서

모델 입력값 오류가 나오면 `higgsfield model get <video_model>`로 허용 항목을 확인합니다.

용어 풀이

전체 용어집 →
MCP
Model Context Protocol의 줄임말입니다. Claude가 외부 서비스의 도구를 사용할 수 있게 연결하는 규격입니다.
크레딧
Higgsfield에서 이미지나 영상을 만들 때 차감되는 사용량입니다. 모델과 설정에 따라 필요한 양이 달라집니다.

2026-08-08 기준 · 출처 · Higgsfield MCP & CLI for any AI, Higgsfield CLI for Claude Code, Higgsfield CLI