# 파일에서 컬렉션 가져오기
다른 사람이 만든 컬렉션이나 AI가 작성한 JSON 파일을 기기에 추가할 수 있습니다.

## 가져오는 순서
1. 컬렉션 JSON 파일을 기기에 저장합니다.
2. Graph Card의 **내 컬렉션**을 엽니다.
3. **가져오기 → 파일**을 누르고 저장한 파일을 선택합니다.
4. 저장 완료 안내가 나타나면 목록에서 컬렉션을 엽니다.

[바로 가져올 수 있는 예제 다운로드](/downloads/collection.json)

## Google Drive 파일 링크에서 가져오기
Google Drive에서 컬렉션 JSON 파일의 공유 범위를 **링크가 있는 모든 사용자**로 바꾸고 다운로드를 허용하세요. 앱에서 **내 컬렉션 → 가져오기 → 링크**를 열어 파일 링크를 붙여 넣습니다.

이미지가 있는 컬렉션은 앱에서 내보낸 이미지 포함 JSON 파일을 Drive에 올려 주세요. 같은 Drive 파일의 내용을 교체한 뒤 링크를 다시 가져오면 아래와 같은 갱신 규칙이 적용됩니다. 브라우저나 Drive의 다운로드 제한으로 링크를 읽을 수 없는 경우에는 Drive에서 JSON을 내려받아 **파일**로 가져올 수 있습니다.

## 어떤 파일을 지원하나요?
- **컬렉션 JSON:** protocolVersion이 2인 컬렉션입니다. 이미지 없는 예제를 만들 때 가장 간단합니다.
- **이미지를 포함한 내보내기 JSON:** 앱에서 내보낸 `graph-card/v1` 패키지입니다. `collection`과 `images`가 함께 들어 있습니다.

```json
{
  "format": "graph-card/v1",
  "collection": { "protocolVersion": 2, "...": "전체 컬렉션" },
  "images": {}
}
```

위 코드는 구조 설명용이며 그대로 가져오는 파일은 아닙니다. `graph-card/v1`은 포장 형식이고 내부 컬렉션의 프로토콜 버전은 2입니다.

## 이미지가 있다면
로컬 파일에 이미지 경로만 적어두면 다른 파일을 자동으로 찾아 읽지 못합니다. 이미지가 든 컬렉션은 앱에서 내보낸 이미지 포함 JSON을 쓰거나, JSON과 이미지가 함께 있는 [공개 GitHub 주소](/ko/docs/import/github/)를 이용하세요.

## 가져오지 못했을 때
파일 선택은 JSON을 대상으로 하며 파일 크기는 최대 64 MiB입니다. JSON 문법, 프로토콜 버전, 카드 ID와 관계 대상이 맞는지 확인하세요. 이 크기는 MCP 서버의 요청·저장 한도와 다릅니다.

같은 ID로 파일을 다시 가져오면 원본의 카드 추가·수정·삭제를 반영합니다. 원본과 기기에서 같은 부분을 다르게 수정했거나 비교할 이전 원본을 확인할 수 없으면 **내 컬렉션 → … → 원본 변경 검토**에서 차이를 확인한 뒤 적용할 수 있습니다. 별개 컬렉션으로 추가하려면 새 collectionId를 사용하세요.

[컬렉션 구조 보기](/ko/docs/protocol/)