메인 콘텐츠로 건너뛰기
Krea는 에이전트와 코딩 어시스턴트를 위해 호스팅형 Model Context Protocol (MCP) 서버를 제공합니다. API 요청을 직접 작성하는 대신 MCP 호환 클라이언트에서 Krea를 바로 호출하고 싶을 때 사용하세요.
연결에 API 키가 필요하지 않습니다. MCP 서버 URL로 https://api.krea.ai/mcp를 추가한 다음, 클라이언트의 OAuth 흐름을 통해 Krea 계정으로 로그인하세요.

​
서버 세부 정보

설정값
전송 방식Streamable HTTP
URLhttps://api.krea.ai/mcp
인증OAuth
청구는 인증 방식에 따라 달라집니다:
인증 방식청구 출처
OAuth로그인된 Krea 계정의 컴퓨트 유닛
API 토큰워크스페이스의 별도 API 잔액

​
인증

대부분의 MCP 클라이언트는 OAuth를 자동으로 사용합니다. 클라이언트가 연결을 요청하면 브라우저 로그인 흐름을 따라 Krea를 승인하세요. OAuth 사용량은 로그인된 Krea 계정의 컴퓨트 유닛으로 청구됩니다. MCP 클라이언트가 OAuth를 지원하지 않는 경우, API 토큰으로 대신 인증할 수 있습니다:
헤더 키헤더 값
AuthorizationBearer KREA_API_TOKEN
KREA_API_TOKEN을 krea.ai/app/api/tokens에서 발급받은 토큰으로 교체하세요. 워크스페이스 소유자와 관리자만 API 토큰을 만들 수 있습니다. API 토큰 사용량은 직접 API 호출과 동일하게 워크스페이스의 API 잔액으로 청구됩니다. API 잔액에 대한 자세한 내용은 API 키 및 청구를 참조하세요.
API 토큰 MCP 자격 증명은 API 키와 동일한 방식으로 보관하세요. 실제 토큰이 포함된 MCP 구성 파일을 커밋하지 마세요.

​
Claude Code

터미널에서 다음 명령을 실행하세요: 
claude mcp add --transport http krea-ai https://api.krea.ai/mcp
Claude Code가 연결을 요청하면 Krea 계정으로 로그인하세요. 서버를 추가한 후 Claude Code를 재시작하거나 MCP 서버를 다시 로드하세요.

​
Codex

  1. Codex에서 Settings > MCP servers를 엽니다.
  2. 새 서버를 추가합니다.
  3. 전송 방식으로 Streamable HTTP를 선택합니다.
  4. 서버 URL을 붙여넣습니다:
https://api.krea.ai/mcp
  1. 서버를 저장하고, Codex가 연결을 요청하면 Krea 계정으로 로그인하세요.

​
Cursor

명령 팔레트를 열고 Open MCP settings를 검색한 후, mcp.json에 다음 항목을 추가하세요: 
{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}
파일을 저장한 후 Cursor를 재시작하고, Cursor가 연결을 요청하면 Krea 계정으로 로그인하세요.

​
MCP를 통한 Krea 사용

연결되면 에이전트에게 Krea 모델을 나열하거나 생성하기 전에 모델 스키마를 확인하도록 요청하세요. 모델 ID는 개발자 문서의 다른 부분에서 사용하는 API 경로와 일치합니다. 예: image/krea/krea-2/medium 또는 video/google/veo-3.1. 예시: 
List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.
모델이 더 이상 사용되지 않는 경우, Krea는 MCP 모델 검색을 통해 지원 중단 메타데이터를 반환합니다. 마이그레이션 안내는 지원 중단을 참조하세요.

​
문제 해결

문제해결 방법
인증 실패MCP 서버를 다시 연결하고 브라우저에서 Krea OAuth 흐름을 완료하세요. API 토큰을 사용하는 경우, 헤더가 정확히 Authorization: Bearer KREA_API_TOKEN인지, 토큰이 취소되지 않았는지 확인하세요.
클라이언트 연결 불가클라이언트가 Streamable HTTP로 구성되어 있고 https://api.krea.ai/mcp를 사용하는지 확인하세요.
청구 문제로 생성 거부됨OAuth로 연결한 경우, 로그인된 Krea 계정의 컴퓨트 유닛을 확인하세요. API 토큰으로 연결한 경우, krea.ai/app/api에서 API 잔액을 충전하세요.
모델 호출 실패다시 시도하기 전에 에이전트에게 모델 스키마를 확인하도록 요청하세요. MCP 요청은 API와 동일한 모델 입력값을 사용합니다.

​
다음 단계

API 키 및 청구

API 토큰을 만들고 토큰 인증 요청에 사용할 API 잔액을 관리하세요.

인터랙티브 플레이그라운드

에이전트에게 요청을 실행하도록 요청하기 전에 Krea 앱에서 직접 요청을 시도해 보세요.

지원 중단

MCP가 모델 마이그레이션 메타데이터를 어떻게 노출하는지 확인하세요.

모델 API

엔드포인트 스키마와 모델 파라미터를 살펴보세요.