Not available in Korea
endueendue
Sign In시작하기
← Connectors

Craft

Craft문서·지식

전체 스페이스 문서·블록·태스크·컬렉션·리마인더·화이트보드 관리 및 4 MiB 이하 파일 업로드

제공 도구 13

발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.

  • craft__api_destructive파괴적승인 필요

    Craft 항목 삭제·컬렉션 스키마 변경 — 삭제 또는 속성·선택지 변경을 적용한다. ⚠️ 하위 내용과 전체 컬렉션에 영향을 주며 변경 전 값을 모르면 되돌릴 수 없다. 문서 삭제는 휴지통으로 이동한다. 먼저 craft__describe_operation으로 정확한 요청 스키마를 조회한다. 결과: data · pagination · truncated.

  • craft__api_send발신승인 필요

    Craft 댓글·태스크·블록·리마인더 생성·수정 — 알림을 포함할 수 있는 내용을 기록한다. ⚠️ 공유 공간에 반영되고 이미 전달된 알림은 되돌릴 수 없다. 먼저 craft__describe_operation으로 요청 스키마를 조회한다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). 결과: data · pagination · truncated.

  • craft__api_write쓰기

    Craft 문서·폴더·컬렉션·화이트보드 생성·이동·수정 및 파일 업로드 — 먼저 craft__describe_operation으로 요청 스키마를 조회한다. 업로드는 base64 바이너리를 MIME과 함께 보내며 4 MiB까지 지원한다. 결과: data · pagination · truncated.

  • craft__append쓰기

    문서 또는 데일리 노트에 마크다운 이어쓰기. document_id 와 date 중 **하나는 반드시** 준다 — 어디에 썼는지 모르면 사용자가 되찾을 수 없다

  • craft__create_document쓰기

    새 문서 생성. content 를 주면 제목 생성 후 본문까지 기록한다 (Craft API 가 제목만 받으므로 2단계로 처리된다)

  • craft__create_task쓰기

    새 태스크 생성 — 인박스(기본)·데일리 노트·특정 문서에 추가한다

  • craft__api_read읽기

    Craft 스페이스 조회·검색 — 문서·블록·태스크·컬렉션·리마인더·화이트보드를 읽는다. 먼저 craft__describe_operation으로 요청 스키마를 조회한다. 결과: 공식 data와 id, pagination.cursor 및 next_offset, truncated.

  • craft__describe_operation읽기

    Craft operation 스키마 조회 — 실행 전 필수 입력·고정 위험도·페이지네이션을 확인한다. 결과: id · method · path · risk · schema · tool. 반환된 tool로 같은 operation을 실행한다.

  • craft__list_documents읽기

    문서 목록 — 내장 위치(unsorted·templates·daily_notes·trash) 또는 폴더 안의 문서를 나열한다

  • craft__list_folders읽기

    폴더 목록 — 문서 조회·생성에 쓸 folder_id 를 여기서 확보한다

  • craft__list_tasks읽기

    태스크 조회 — 상태·예정일·마감일과 태스크가 속한 문서/데일리 노트가 함께 돌아온다

  • craft__read_document읽기

    문서 또는 데일리 노트 내용 읽기 — 블록 트리가 평문 마크다운으로 접혀 돌아온다 (태스크는 [ ]/[x] 로 표시)

  • craft__search읽기

    Craft 스페이스 전체 검색 — 다른 Craft 툴에 쓸 document_id 를 여기서 확보한다. 매치된 블록과 앞뒤 문맥이 함께 돌아온다

연동 준비

  1. Craft Imagine 탭에서 전체 스페이스(Space) 범위로 API 연결을 만드세요. 바로가기
  2. 발급된 https://connect.craft.do/links/{secretLinkId}/api/v1 URL과 API 키를 붙여넣으세요. URL도 비밀입니다.
  3. 기존 데일리 노트·선택 문서 연결은 자동 확장되지 않습니다. 전체 스페이스 연결을 새로 만들고 URL과 API 키를 모두 재입력하세요. OAuth 재동의 대신 API 연결 재발급이 필요합니다.
  4. 리마인더는 실험적 기능입니다. 삭제·스키마 변경·알림 요청은 승인 후 실행됩니다.

Craft 공식 문서 ↗