MCP 도구 목록
Postlark MCP 서버는 16개의 도구를 제공합니다. Claude에게 자연어로 말하면 적절한 도구를 자동으로 선택합니다.
create_post
섹션 제목: “create_post”새 블로그 포스트를 생성하고 발행합니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
title | string | 예 | — | 포스트 제목 |
content | string | 예 | — | 마크다운 콘텐츠 |
slug | string | 아니오 | 제목에서 자동 생성 | URL slug |
tags | string[] | 아니오 | [] | 태그 (최대 10개) |
status | "draft" | "published" | 아니오 | "published" | 상태 |
사용 예시:
- “Docker 기초 가이드를 작성해서 Postlark에 발행해줘”
- “TypeScript 팁 포스트를 초안으로 작성해줘, 발행은 하지 마”
- “tech, news 태그로 주간 뉴스레터 올려줘”
update_post
섹션 제목: “update_post”기존 포스트를 수정합니다. 지정한 필드만 변경됩니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
slug | string | 예 | 수정할 포스트의 slug |
title | string | 아니오 | 새 제목 |
content | string | 아니오 | 새 콘텐츠 |
tags | string[] | 아니오 | 새 태그 |
사용 예시:
- “docker-basics 포스트에 Docker Compose 섹션 추가해줘”
- “최신 포스트의 태그를 python, tutorial로 변경해줘”
list_posts
섹션 제목: “list_posts”포스트 목록을 필터와 함께 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
status | string | 아니오 | 필터: draft, published, scheduled |
tag | string | 아니오 | 태그 필터 |
page | number | 아니오 | 페이지 번호 |
per_page | number | 아니오 | 페이지당 항목 수 (최대 100) |
사용 예시:
- “발행된 포스트 목록 보여줘”
- “초안 포스트 리스트”
- “python 태그가 달린 포스트가 몇 개야?“
get_post
섹션 제목: “get_post”포스트 하나를 마크다운 원본과 함께 조회합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
slug | string | 예 | 포스트 slug |
사용 예시:
- “docker-basics 포스트 내용 보여줘”
- “최근 포스트 전체 텍스트 가져와”
delete_post
섹션 제목: “delete_post”포스트를 영구 삭제합니다. DB, KV 캐시, CDN에서 모두 제거됩니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
slug | string | 예 | 포스트 slug |
사용 예시:
- “test-post 삭제해줘”
publish_post
섹션 제목: “publish_post”초안 포스트를 발행합니다. 상태를 draft에서 published로 변경하고 블로그에 공개합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
slug | string | 예 | 발행할 초안 포스트의 slug |
사용 예시:
- “docker-basics 초안을 발행해줘”
- “최근에 만든 초안 포스트를 공개해줘”
schedule_post
섹션 제목: “schedule_post”초안 포스트를 미래 시점에 발행 예약합니다. Creator 플랜 이상 필요.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
slug | string | 예 | 포스트 slug (초안이어야 함) |
scheduled_at | string | 예 | ISO 8601 날짜시간 (미래여야 함) |
사용 예시:
- “docker-basics 포스트를 다음 월요일 오전 9시에 발행 예약해줘”
- “초안 포스트를 4월 1일 정오에 발행해줘”
list_blogs
섹션 제목: “list_blogs”현재 사용자가 소유한 모든 블로그를 조회합니다. 파라미터가 필요 없습니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| (없음) | — | — | — |
사용 예시:
- “내 블로그 목록 보여줘”
- “Postlark에 블로그 몇 개 있어?“
set_active_blog
섹션 제목: “set_active_blog”이후 명령의 대상이 될 활성 블로그를 설정합니다. 여러 블로그를 관리할 때 유용합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
blog_id | string | 예 | 블로그 ID (list_blogs로 확인) |
사용 예시:
- “기술 블로그로 전환해줘”
- “마케팅 블로그를 활성 블로그로 설정해”
create_blog
섹션 제목: “create_blog”Postlark에 새 블로그를 생성합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
slug | string | 예 | 블로그 서브도메인 slug (예: my-blog → my-blog.postlark.ai) |
name | string | 예 | 블로그 표시 이름 |
description | string | 아니오 | 블로그 설명 |
사용 예시:
- “tech-notes라는 slug로 기술 노트 블로그 만들어줘”
- “마케팅 블로그를 새로 만들어줘”
update_blog
섹션 제목: “update_blog”블로그 설정(이름, 설명)을 변경합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
blog_id | string | 예 | 수정할 블로그 ID |
name | string | 아니오 | 새 표시 이름 |
description | string | 아니오 | 새 설명 |
사용 예시:
- “내 블로그 이름을 Developer Diary로 바꿔줘”
- “블로그 설명을 업데이트해줘”
delete_blog
섹션 제목: “delete_blog”블로그와 모든 콘텐츠를 영구적으로 삭제합니다. 되돌릴 수 없습니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
blog_id | string | 예 | 삭제할 블로그 ID |
사용 예시:
- “오래된 테스트 블로그를 삭제해줘”
get_analytics
섹션 제목: “get_analytics”블로그 분석 개요를 조회합니다 — 총 조회수(7일/30일)와 인기 글. Starter 플랜 이상 필요.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
period | "7d" | "30d" | "90d" | 아니오 | "30d" | 기간 |
사용 예시:
- “이번 주 블로그 조회수 알려줘”
- “가장 많이 본 글 10개 보여줘”
- “최근 30일 블로그 트래픽 알려줘”
search_posts
섹션 제목: “search_posts”블로그 내 발행된 포스트를 전문 검색합니다. 제목, 설명, 헤딩, 태그를 모두 검색합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
q | string | 예 | 검색어 |
page | number | 아니오 | 페이지 번호 (기본 1) |
per_page | number | 아니오 | 페이지당 결과 수 (기본 20, 최대 50) |
사용 예시:
- “내 블로그에서 쿠버네티스 관련 글 검색해줘”
- “CI/CD 언급한 포스트 찾아줘”
discover_posts
섹션 제목: “discover_posts”전체 Postlark 플랫폼의 발행된 포스트를 검색합니다. 인증이 필요 없습니다 — API 키 없이도 작동합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
q | string | 예 | 검색어 |
tag | string | 아니오 | 태그 필터 |
page | number | 아니오 | 페이지 번호 (기본 1) |
per_page | number | 아니오 | 페이지당 결과 수 (기본 20, 최대 50) |
사용 예시:
- “Postlark에서 머신러닝 관련 블로그 글 찾아줘”
- “Postlark에서 devops 태그 달린 Docker 튜토리얼 검색해줘”
upload_image
섹션 제목: “upload_image”블로그의 R2 미디어 저장소에 이미지를 업로드합니다. 마크다운에서 사용할 수 있는 공개 URL을 반환합니다. media:write 스코프가 필요합니다.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
data | string | 예 | Base64로 인코딩된 이미지 데이터 |
content_type | string | 예 | MIME 타입 (image/jpeg, image/png, image/gif, image/webp) |
filename | string | 아니오 | 파일명 (생략 시 UUID 자동 생성) |
제한:
- 최대 파일 크기: 5 MB
- JPEG EXIF 메타데이터는 개인정보 보호를 위해 자동으로 제거됩니다
사용 예시:
- “이 스크린샷을 블로그에 업로드해줘”
- “이 다이어그램 이미지를 미디어 저장소에 추가해줘”
일반적인 워크플로우:
사용자: "이 다이어그램을 포스트에 넣고 싶어"Claude: (upload_image 호출, base64 데이터 전달) → 이미지 업로드 완료: https://media.postlark.ai/blog-id/uuid.png
사용자: "그 다이어그램을 사용해서 시스템 아키텍처 포스트를 작성해줘"Claude: (create_post 호출, 콘텐츠에  포함) → 이미지가 포함된 포스트 발행 완료멀티 블로그 워크플로우
섹션 제목: “멀티 블로그 워크플로우”여러 블로그를 운영 중이라면 (Creator 플랜: 최대 3개, Scale: 최대 5개), list_blogs와 set_active_blog로 관리할 수 있습니다:
사용자: "내 블로그 보여줘"Claude: (list_blogs 호출) → 2개 블로그: tech-blog, marketing-blog
사용자: "marketing-blog로 전환해"Claude: (set_active_blog 호출) → 활성 블로그가 "marketing-blog"로 설정됨
사용자: "신제품 런칭 포스트 작성해"Claude: (create_post 호출 — marketing-blog 자동 대상) → marketing-blog에 포스트 발행모든 포스트 명령 (create_post, update_post, list_posts, get_post, delete_post, schedule_post)이 활성 블로그를 설정하면 자동으로 해당 블로그를 대상으로 합니다.