# Spline MCP: AI 에이전트를 Spline에 연결하세요 (https://spline.design/ko/mcp)

> Claude, ChatGPT, Cursor, VS Code 등 MCP 클라이언트를 Spline에 연결하면, 에이전트가 열려 있는 에디터에서 3D 씬과 Hana 디자인을 만들고 편집합니다.

# 에이전트를 Spline에 연결하세요

Claude, ChatGPT, Cursor 등의 에이전트와 함께 **3D 씬과 Hana 디자인**을 만드세요.

1. ### 1Claude에 추가  
Spline 커넥터가 채워진 상태로 Claude가 열립니다.  
[Claude에 추가](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Spline&connectorUrl=https%3A%2F%2Fmcp.spline.design%2Fmcp)
2. ### 2연결하고 로그인하기  
Add, Connect를 차례로 선택하고 Spline 계정으로 로그인하세요.
3. ### 3마음껏 요청하세요  
프롬프트에 Spline(3D) 또는 Hana(2D)를 언급하면 알맞은 쪽을 선택합니다.

작동 방식

## 채팅에서 라이브 파일까지

모든 변경 사항이 직접 이어받을 수 있는 라이브 파일에 반영됩니다.

1. 나공중에 떠 있는 섬을 만들어 줘공중에 떠 있는 섬을 만들어 줘  
01 · 요청  
### 나  
하고 싶은 것을 설명합니다.
2. 씬 구상 중  
02 · 계획  
### 나의 에이전트  
호출할 Spline 도구를 고릅니다.
3. 03 · 전달  
### Spline MCP  
각 호출을 에디터로 전달합니다.
4. **에이전트** **Ana**  
04 · 제작  
### Spline 에디터  
라이브 파일에 변경 사항을 적용합니다.

브리프

## 브리프로 시작하세요

하나를 클릭하면 브리프가 채워진 상태로 에이전트에서 열립니다.

3D

### 제품 히어로

바로 임베드할 수 있는 조명이 갖춰진 제품 씬

### 공중에 떠 있는 섬

빛과 물이 있는 작은 세계

### 생성한 캐릭터

배치와 조명까지 마친 생성 모델

### 호버와 클릭

선택한 오브젝트에 상태와 이벤트 추가

### 작은 게임 레벨

물리가 적용된 플레이 가능한 레벨

Hana

### 요금제 페이지

편집 가능한 데스크톱 및 모바일 프레임

### 다크 테마로 바꿔 코드로

스타일을 바꿔 HTML로 내보낸 화면

### 내 코드에서 시작

편집 가능한 프레임이 된 내 컴포넌트

개인정보 보호 및 보안

## 내가 정한 방식대로 접근 권한 관리

01

### 내 계정, 내 권한

에이전트는 OAuth로 내 계정에 로그인합니다. 각 권한은 한 사람에게 속하며, 권한을 철회하면 해당 토큰은 작동을 멈춥니다.

02

### 호출은 해당 대화 안에서만

각 채팅의 호출은 그 채팅이 연 에디터에서만 실행되며, 다른 대화의 파일에서는 절대 실행되지 않습니다.

03

### 또는 로컬에서 실행

데스크톱 앱을 사용하면 서버가 출처 허용 목록 뒤에서 127.0.0.1에만 바인딩되어 네트워크에서 절대 접근할 수 없습니다.

자주 묻는 질문

## 궁금한 점을 모두 답해 드립니다

API 키가 필요한가요?

아니요. 에이전트가 처음 연결될 때 OAuth를 통해 Spline 계정으로 로그인합니다. 키를 만들거나, 붙여 넣거나, 보관할 필요가 없습니다.

Spline 플러그인이 있나요?

네, ChatGPT와 Codex용 플러그인이 있습니다. 페이지 상단에서 에이전트를 선택해 추가하거나, 다른 MCP 클라이언트에서는 URL로 Spline MCP 서버를 연결하세요.

Spline 데스크톱 앱이 필요한가요?

아니요. 에이전트에 원격 서버를 추가하고 로그인하면 호출이 브라우저의 Spline에서 실행됩니다. 서버를 로컬에서 실행하고 싶다면 데스크톱 앱을 대안으로 사용할 수 있으며, 지원되는 에이전트도 자동으로 설정해 줍니다.

에이전트의 변경 사항은 어디에 반영되나요?

실제 Spline 파일에 반영됩니다. ChatGPT에서는 대화 안의 패널에서 에디터가 열리고, 다른 에이전트는 브라우저에서 파일을 여는 링크를 제공하므로 작업을 지켜보거나, 이어받거나, 직접 편집을 계속할 수 있습니다.

어떤 에이전트와 함께 작동하나요?

OAuth 로그인을 지원하는 원격 서버(streamable HTTP)를 사용할 수 있는 모든 MCP 클라이언트에서 작동합니다. Claude Code, Claude Desktop, ChatGPT, Codex, Cursor, VS Code, Antigravity, Grok, Grok Build 등이 포함됩니다.

에이전트에 Spline 도구가 나타나지 않아요

서버 URL이 `https://mcp.spline.design/mcp`인지, 로그인을 완료했는지 확인하세요. 대부분의 에이전트는 서버 옆에 로그인 또는 인증 버튼을 표시합니다. 일부 에이전트는 시작할 때만 MCP 서버를 불러오므로, 추가한 뒤 에이전트를 다시 시작하세요.

에이전트 연결은 어떻게 해제하나요?

해당 에이전트의 MCP 설정에서 Spline 서버를 제거하세요. 권한은 내 계정에 연결되어 있으며, 권한을 철회하면 에이전트의 토큰은 즉시 작동을 멈춥니다.

## 지금 3D로 만들기 시작하세요

에이전트를 연결하고, 팀을 초대하고, 오늘 첫 3D 씬을 배포하세요.

[시작하기](https://app.spline.design/signin)[에이전트 연결하기](https://spline.design/ko/mcp)

[Spline](https://spline.design/ko)

팀과 AI 에이전트를 위한 3D·2D 에디터. 웹, iOS, Android에 바로 배포하세요.

#### AI에게 Spline에 대해 묻기

#### 제품

- [3D 디자인](https://spline.design/ko/3d-design)
- [Hana](https://spline.design/ko/hana)
- [Omma](https://omma.build)
- [AI 3D 생성](https://spline.design/ko/ai-generate)
- [Spline MCP](https://spline.design/ko/mcp)
- [Spline Arena](https://spline.design/ko/arena)
- [요금제](https://spline.design/ko/pricing)
- [엔터프라이즈](https://spline.design/ko/enterprise)

#### 런타임

- [Web](https://spline.design/ko/web)
- [iOS](https://spline.design/ko/ios)
- [Android](https://spline.design/ko/android)

#### 앱

- [다운로드](https://spline.design/ko/download)
- [Spline Mirror](https://spline.design/spline-mirror)
- [Spline Mirror 다운로드](https://spline.design/download-mirror)

#### 학습

- [Docs](https://docs.spline.design/)
- [Academy](https://spline.design/ko/academy)
- [Spline API](https://www.npmjs.com/package/@splinetool/runtime)
- [솔루션](https://spline.design/solutions)

#### 커뮤니티

- [Spline 커뮤니티](https://community.spline.design)
- [Blog](https://spline.design/ko/blog)
- [변경 로그](https://spline.design/ko/changelog)
- [교육](https://spline.design/ko/education)
- [Contra](https://spline.design/contra)
- [제휴 프로그램](https://spline.design/ko/affiliate)

#### 회사

- [고객 사례](https://spline.design/ko/customers)
- [채용](https://www.ycombinator.com/companies/spline/jobs)
- [보안](https://spline.design/ko/security)

#### 법적 고지

- [이용약관](https://spline.design/terms)
- [개인정보처리방침](https://spline.design/privacy)

#### 문의

- [help@spline.design](mailto:help@spline.design)
- [jobs@spline.design](mailto:jobs@spline.design)

© 2026 - Spline, Inc.
