> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Craft API

> Craft를 외부 도구에 연결하고 워크플로를 자동화하며 Craft API로 맞춤형 통합을 구축하세요.

Craft는 API 도입으로 더 유연하고 강력해지고 있습니다. 이 새로운 기능을 통해 Craft를 외부 도구에 연결하고 워크플로를 자동화하며 Craft를 필요에 맞게 조정하는 맞춤형 통합을 만들 수 있습니다.

## API란 무엇인가요?

API(Application Programming Interface)는 서로 다른 애플리케이션이 안전하게 통신할 수 있게 해줍니다. 실제로 이는 Craft의 API를 사용하여 다음을 수행할 수 있다는 뜻입니다:

* 다른 서비스로부터 데이터를 보내거나 받기
* 다른 앱의 이벤트에 따라 Craft에서 작업을 트리거하기
* 맞춤형 도구, 대시보드 또는 자동화를 구축하기
* MCP 또는 기타 통합 방법을 통해 Claude나 ChatGPT 같은 AI 어시스턴트와 Craft를 연결하기

API는 수동 복사나 반복 작업 없이도 Craft가 이미 사용 중인 도구들과 원활하게 작동하도록 합니다.

## Craft의 API 작동 방식

sidebar의 Imagine 탭에서 **API 연결**을 생성하여 워크스페이스의 적절한 부분을 외부 도구와 공유할 수 있습니다.

다음 중 선택할 수 있습니다:

* 모든 **데일리 노트**를 연결하거나
* 하나 이상의 특정 **문서**를 선택해 포함하는 **맞춤 연결**을 생성하기

각 연결에 대해 접근 권한 및 공개 범위를 설정하여 무엇이 공유되는지를 직접 제어할 수 있습니다. 그런 다음 Craft는 해당 연결에 대한 **고유한 API 엔드포인트**를 생성하며, 이를 API 기반 도구나 워크플로에 연결하면 됩니다. 해당 도구들은 선택한 문서만 접근할 수 있으며 워크스페이스의 나머지 항목은 비공개로 유지됩니다.

모든 API 연결은 **Craft 설정 → API**에서 생성, 검토 및 관리할 수 있습니다.

<img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/integrate/api/en/content/api-settings.png?s=a581d87e3a5d721049c4feaf776146b1" alt="설정에서의 API 연결 관리" width="800" height="486" data-path="images/integrate/api/en/content/api-settings.png" />

Craft에서 API 연결을 만든 후에는 Imagine 탭에 표시된 API 엔드포인트와 자격 증명을 복사하세요.

그다음 이를 연결하려는 외부 앱이나 워크플로(예: AI 어시스턴트, 자동화 도구 또는 개발 환경)의 커넥터나 API 통합 설정에 추가하면 됩니다. 각 도구마다 처리 방식은 조금씩 다르지만 아이디어는 같습니다. Craft의 API 정보를 붙여넣으면 해당 도구는 그 연결에 대해 선택한 문서만 접근할 수 있습니다.

<Info title="스페이스 수준 API 액세스 (v3.3.5+)">
  Craft API는 이제 고급 기능을 갖춘 **스페이스 수준 액세스**를 지원합니다:

  * 폴더, 태그 및 날짜 필터링을 통한 **모든 문서 검색**
  * **데일리 노트**와 **할 일**을 API로 완전 접근 가능
  * 문서의 **생성, 업데이트, 삭제**를 프로그래밍 방식으로 수행
  * **컬렉션 관리**(스키마 생성 및 편집 포함)
  * 정규식 지원 및 시간대 인식 날짜 필터가 포함된 **고급 검색**

  자세한 엔드포인트 정보는 [공식 API 문서](https://www.craft.do/imagine/)를 참조하세요.
</Info>

## 사용 사례

다음은 API로 구축할 수 있는 예시들입니다:

* 자동으로 업데이트되는 개인 대시보드
* 다른 생산성 앱과 동기화되는 할 일 목록
* 외부 소스에서 데이터를 가져오는 독서 로그
* Craft 문서에 맞춘 맞춤형 AI 어시스턴트
* 템플릿을 기반으로 한 자동 문서 생성
* 예약된 백업 또는 내보내기
* 팀 커뮤니케이션 도구와의 통합

가능성은 광범위합니다 – API를 통해 Craft를 상상하는 방식대로 확장할 수 있습니다.

## 전체 가이드 및 문서

API, MCP 연결 및 예제 통합(Claude 및 ChatGPT 포함)에 대한 모든 단계별 가이드는 다음에서 확인할 수 있습니다:

👉 [**https://www.craft.do/imagine/**](https://www.craft.do/imagine/)

튜토리얼을 살펴보고 MCP를 활성화하는 방법을 배우며 Craft를 서드파티 도구에 연결하는 방법을 이해하려면 위 링크가 가장 좋은 출발점입니다.

시작에 도움이 필요하거나 질문이 있으시면 언제든지 문의하세요 – 도와드리겠습니다.