MCP 서버 설치

Postlark MCP 서버를 사용하면 Claude Code 또는 Claude Desktop에서 직접 블로그 포스트를 발행할 수 있습니다.

설치

Claude Code (CLI)

터미널에서 아래 명령어 하나만 실행하세요. pk_live_your_key_here 부분을 본인의 API 키로 교체합니다.

터미널

claude mcp add postlark --env POSTLARK_API_KEY=pk_live_your_key_here -- npx @postlark/mcp-server

끝입니다 — --env 플래그가 API 키를 MCP 서버 프로세스에 직접 전달합니다.

Claude Desktop

Settings → Developer → Edit Config을 열고 설정 파일에 다음을 추가하세요:

claude_desktop_config.json

{
  "mcpServers": {
    "postlark": {
      "command": "npx",
      "args": ["@postlark/mcp-server"],
      "env": {
        "POSTLARK_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

설정 파일 위치:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

저장 후 Claude Desktop을 재시작하세요.

팁

대시보드 → 설정 → API Keys(app.postlark.ai)에서 API 키를 발급하세요. 키는 한 번만 표시되므로 창을 닫기 전에 저장하세요.

shell export는 사용하지 마세요

.zshrc나 .bashrc에 export POSTLARK_API_KEY=...를 추가하는 방식은 안정적으로 작동하지 않습니다 — MCP 서버는 별도 서브프로세스로 실행되어 쉘 환경변수를 상속받지 못할 수 있습니다. 반드시 --env (Claude Code) 또는 "env" 필드 (Claude Desktop)를 사용하세요.

확인

Claude Code (CLI)

claude "내 Postlark 포스트 목록 보여줘"

Claude Desktop

채팅에 입력하세요:

내 Postlark 포스트 목록 보여줘

Claude가 list_posts 도구를 사용하여 포스트 목록을 표시합니다 (아직 발행한 글이 없으면 빈 목록이 표시됩니다).

사용 예시

You: "Docker 초보 가이드를 작성해서 Postlark에 올려줘"

Claude: Docker 가이드를 작성하여 블로그에 발행하겠습니다.
        [create_post 도구 사용 중...]

        발행 완료: https://myblog.postlark.ai/docker-beginners-guide

        포스트에 포함된 내용:
        - 컨테이너 소개
        - Docker 설치
        - 기본 명령어
        - 첫 Dockerfile 작성

환경 변수

변수	필수	설명
POSTLARK_API_KEY	예	Postlark API 키
POSTLARK_API_BASE	아니오	API 기본 URL (기본값: https://api.postlark.ai/v1)

npm 패키지

@postlark/mcp-server

npmjs.com/@postlark/mcp-server