메인 콘텐츠로 건너뛰기
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에서 생성, 검토 및 관리할 수 있습니다. 설정에서의 API 연결 관리 Craft에서 API 연결을 만든 후에는 Imagine 탭에 표시된 API 엔드포인트와 자격 증명을 복사하세요. 그다음 이를 연결하려는 외부 앱이나 워크플로(예: AI 어시스턴트, 자동화 도구 또는 개발 환경)의 커넥터나 API 통합 설정에 추가하면 됩니다. 각 도구마다 처리 방식은 조금씩 다르지만 아이디어는 같습니다. Craft의 API 정보를 붙여넣으면 해당 도구는 그 연결에 대해 선택한 문서만 접근할 수 있습니다.
Craft API는 이제 고급 기능을 갖춘 스페이스 수준 액세스를 지원합니다:
  • 폴더, 태그 및 날짜 필터링을 통한 모든 문서 검색
  • 데일리 노트와 할 일을 API로 완전 접근 가능
  • 문서의 생성, 업데이트, 삭제를 프로그래밍 방식으로 수행
  • 컬렉션 관리(스키마 생성 및 편집 포함)
  • 정규식 지원 및 시간대 인식 날짜 필터가 포함된 고급 검색
자세한 엔드포인트 정보는 공식 API 문서를 참조하세요.

​
사용 사례

다음은 API로 구축할 수 있는 예시들입니다:
  • 자동으로 업데이트되는 개인 대시보드
  • 다른 생산성 앱과 동기화되는 할 일 목록
  • 외부 소스에서 데이터를 가져오는 독서 로그
  • Craft 문서에 맞춘 맞춤형 AI 어시스턴트
  • 템플릿을 기반으로 한 자동 문서 생성
  • 예약된 백업 또는 내보내기
  • 팀 커뮤니케이션 도구와의 통합
가능성은 광범위합니다 – API를 통해 Craft를 상상하는 방식대로 확장할 수 있습니다.

​
전체 가이드 및 문서

API, MCP 연결 및 예제 통합(Claude 및 ChatGPT 포함)에 대한 모든 단계별 가이드는 다음에서 확인할 수 있습니다: 👉 https://www.craft.do/imagine/ 튜토리얼을 살펴보고 MCP를 활성화하는 방법을 배우며 Craft를 서드파티 도구에 연결하는 방법을 이해하려면 위 링크가 가장 좋은 출발점입니다. 시작에 도움이 필요하거나 질문이 있으시면 언제든지 문의하세요 – 도와드리겠습니다.