Figma

제공 도구 11

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

• figma__api_destructive파괴적승인 필요

  Figma 코멘트·리액션·웹훅·개발 리소스 삭제 또는 변수 일괄 변경. operation과 해당 path/body 스키마를 사용한다. ⚠️ 삭제한 데이터는 되돌릴 수 없다. postVariables는 컬렉션·모드·변수 삭제가 섞일 수 있어 모든 일괄 변경에 승인이 필요하다. 결과: 원본 JSON(data), 항목별 결과·생성 ID. 대상 ID와 각 action을 확인한다.

• figma__api_send발신승인 필요

  Figma 코멘트·리액션 게시 또는 웹훅 생성·수정. operation과 해당 path/body 스키마를 사용한다. ⚠️ 협업자에게 알림이 가거나 웹훅 목적지로 파일 이벤트가 발신되며 이미 전달된 알림은 되돌릴 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다. 결과: 원본 JSON(data), 게시 ID 또는 웹훅 설정(비밀값 제외).

• figma__post_comment발신승인 필요

  Figma 파일 코멘트 작성 — reply_to를 주면 답글이 된다. ⚠️ 협업자에게 알림이 가며 이미 보낸 알림은 되돌릴 수 없다. 위치 지정과 삭제는 figma__api_send / figma__api_destructive 를 사용한다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다. file은 파일 URL 또는 key. 결과: posted · comment_id · at · author · message.

• figma__api_write쓰기

  Figma 개발 리소스 링크를 생성·수정한다. operation은 postDevResources 또는 putDevResources, body는 dev_resources 배열이다. ⚠️ 협업자가 보는 링크가 바뀌며 다시 수정할 수 있다. 결과: 원본 JSON(data), 생성 ID와 항목별 오류. 배열 안의 각 리소스 필수 필드를 확인한다.

• figma__api_read읽기

  Figma 공식 조회 — 폴더·파일·노드·버전·이미지·댓글·컴포넌트·스타일·변수·웹훅·라이브러리 분석. operation 목록과 스키마에서 메서드를 선택한다. path는 리소스 ID, query는 조회 조건이다. 결과: 원본 JSON(data), 다음 호출 인자(pagination.next), 이미지 다운로드 URL과 만료 정보. 조회는 한 페이지이며 next 인자로 이어서 호출한다.

• figma__export_images읽기

  노드를 이미지로 렌더해 다운로드 URL 을 받는다(30일 유효). 디자인을 눈으로 확인시켜야 할 때 쓴다

• figma__get_file읽기

  파일 구조 — 페이지와 그 안의 프레임 목록(id·이름·크기). 파일 전체 트리는 너무 커서 이 깊이까지만 준다. 세부는 figma__get_node

• figma__get_node읽기

  노드(프레임/컴포넌트) 상세 — 안에 든 텍스트와 자식 구조를 요약한다. node 를 생략하면 URL 의 node-id 를 쓴다

• figma__list_comments읽기

  파일의 코멘트 조회 — 기본은 해결되지 않은 것만(include_resolved 로 전부). 결과: 코멘트마다 id(figma__post_comment 의 reply_to) · author · at · resolved · reply_to · message (최대 50건).

• figma__list_project_files읽기

  기존 호환용 프로젝트 파일 목록(폐기 예정 API). 새 폴더 탐색은 figma__api_read의 getFolderFiles를 사용한다. 결과: 파일마다 key · name · last_modified.

• figma__list_team_projects읽기

  기존 호환용 프로젝트 목록(폐기 예정 API). 새 폴더 탐색은 figma__api_read의 getTeamFolders를 사용한다. team_id는 Figma 팀 URL에서 얻는다.