/
LinkHarbor MCP 서버의 도구 25개: 각 도구가 하는 일, 필요한 권한, 즉시 적용되거나 승인 후 적용되는 작업을 정리했습니다.
LinkHarbor MCP 서버는 읽기용 10개, 변경용 15개, 모두 25개의 도구를 제공합니다. 어시스턴트는 해당 권한을 허용한 도구만 봅니다. 표의 이름은 기술적 이름이며 어시스턴트에도 그대로 표시될 수 있습니다.
읽기
| 도구 | 하는 일 | 권한 |
|---|---|---|
| list_pages | 워크스페이스의 페이지를 ID, 핸들, 제목, 상태, 공개 버전과 함께 나열 | 읽기 · 페이지 |
| get_page | 페이지에서 편집할 수 있는 모든 것을 읽음: 페이지 데이터, 초안(템플릿, 디자인, 테마, 커스텀 CSS, SEO), 블록, 링크 | 읽기 · 페이지와 읽기 · 링크 |
| get_block_types | 사용할 수 있는 블록 종류와 설정을 보여 줌 | 읽기 · 페이지 |
| list_templates | 기본 제공 템플릿과 워크스페이스의 활성 커스텀 템플릿을 나열하고, 플랜에서 쓸 수 있는 템플릿을 표시 | 읽기 · 워크스페이스 |
| list_page_versions | 페이지의 게시된 버전을 최신순으로 나열 | 읽기 · 페이지 |
| get_preview_link | 10분 동안 유효한 초안 미리보기 링크를 만듦 | 읽기 · 페이지 |
| get_page_stats | 페이지의 조회수, 클릭수, 클릭률, 링크별 클릭수(Creator Pro부터) | 읽기 · 통계 |
| get_workspace_stats | 모든 페이지의 개요와 기간 내 인기 페이지(Creator Pro부터) | 읽기 · 통계 |
| list_forms | 워크스페이스의 폼을 나열 | 읽기 · 폼 |
| get_form_submissions | 폼의 최근 제출 내역(1~100개, 기본 20개)을 보여 주며, 요청하면 이전 내역도 보여 줌 | 읽기 · 폼 |
통계 도구에서는 어시스턴트가 기간을 고를 수 있습니다: 24시간, 7일, 30일(기본값), 90일, 이번 달, 지난달.
변경하기
| 도구 | 하는 일 | 권한 | 적용 시점 |
|---|---|---|---|
| create_page | 게시하지 않은 새 페이지를 만듦. 핸들은 이후 어시스턴트로 바꿀 수 없음 | 쓰기 · 페이지 | 새 페이지가 초안으로 |
| update_page | 제목이나 LinkHarbor 디렉터리 노출 설정을 변경(핸들 제외) | 쓰기 · 페이지 | 즉시, 버전 없음 |
| update_page_design | 템플릿, 디자인, 테마, 커스텀 CSS를 변경. 지정한 값만 바뀌고 테마의 나머지는 유지 | 쓰기 · 페이지 | 초안 |
| update_page_seo | SEO 및 공유 텍스트를 변경(이미지 제외) | 쓰기 · 페이지 | 초안 |
| add_block | 블록을 끝에 추가 | 쓰기 · 페이지 | 초안 |
| update_block | 블록을 변경 | 쓰기 · 페이지 | 초안 |
| delete_block | 블록을 제거 | 쓰기 · 페이지 | 초안, 먼저 물어봄 |
| reorder_blocks | 블록 순서를 변경 | 쓰기 · 페이지 | 초안 |
| add_link | 링크 버튼을 끝에 추가 | 쓰기 · 링크 | 초안 |
| update_link | 링크를 변경: 제목, 대상, 켜기/끄기, 예약, 스타일, 국가 및 기기 규칙 | 쓰기 · 링크 | 초안 |
| delete_link | 링크를 제거 | 쓰기 · 링크 | 초안, 먼저 물어봄 |
| reorder_links | 링크 순서를 변경 | 쓰기 · 링크 | 초안 |
| restore_page_version | 게시된 버전(또는 현재 공개 상태)을 초안으로 되돌림 | 쓰기 · 페이지 | 초안, 먼저 물어봄 |
| set_page_visibility | 페이지를 공개, 비공개 또는 비밀번호 보호로 설정 | 쓰기 · 페이지 | 즉시 공개 반영, 먼저 물어봄 |
| publish_page | 초안을 공개하고 새 버전으로 저장 | 쓰기 · 페이지 | 즉시 공개 반영, 먼저 물어봄 |
“초안”은 publish_page로 페이지를 게시해야 방문자가 변경을 볼 수 있다는 뜻입니다. “먼저 물어봄”은 어시스턴트에게 그 도구가 영향이 큰 작업으로 표시된다는 뜻입니다. Claude와 ChatGPT는 보통 이런 도구를 쓸 때 확인을 요청하며, 구체적인 방식은 클라이언트마다 다릅니다.
알아 두면 좋은 점
- 어시스턴트의 읽기 권한과 쓰기 권한은 별개임. “쓰기 · 페이지”만 허용하면 페이지 읽기 도구는 따라오지 않음
- get_page는 페이지의 링크도 읽으므로 “읽기 · 링크”도 필요함
- 새 블록과 링크는 항상 끝에 추가되며, 어시스턴트가 reorder_blocks나 reorder_links로 옮김
- 블록 종류, 프리미엄 템플릿, 링크 수 등 대시보드와 똑같이 플랜 한도가 적용됨
- 미리보기 링크는 게시한 뒤 방문자가 보게 될 모습 그대로 초안을 보여 줌
- 어시스턴트는 페이지와 폼 제출 내역의 텍스트를 지시가 아니라 데이터로 다룸
전용 도구가 없는 권한
일부 권한은 동의 페이지에서 허용할 수 있지만 현재 어시스턴트가 어떤 도구에도 쓰지 않습니다: “읽기 · 에셋”, “쓰기 · 에셋”, “쓰기 · 폼”, “쓰기 · 워크스페이스”, “읽기 · 후원 결제”, “읽기 · 단축 링크”, “쓰기 · 단축 링크”, “쓰기 · 워크스페이스 템플릿”. 체크를 해제해도 불이익은 없습니다.
함께 보면 좋은 글
원하는 내용을 찾지 못했나요?
필요한 내용을 알려 주시면 지원팀이 직접 도와드립니다.