PostFast MCP 서버

Name: postfast-mcp
Author: peturgeorgievv-factory

PostFast API용 MCP 서버 — Claude, Cursor, VS Code 등과 같은 AI 도구를 통해 소셜 미디어 게시물을 예약하고 관리하세요.

빠른 시작

1. API 키 받기

PostFast에 로그인한 후 사이드바에서 API로 이동하여 키를 생성하세요.

2. 설치

원하는 방법을 선택하세요:

Claude Desktop (권장)

Claude Desktop 확장 프로그램 디렉토리에서 확장 프로그램을 다운로드하거나 수동으로 설치하세요:

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "postfast": {
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop을 재시작하세요.

Claude Code

플러그인 사용 (마켓플레이스 승인 대기 중):

/plugin install postfast@claude-plugins-official

설치 후 API 키를 설정하세요 — 다음 중 하나를 선택하세요:

# Option A: Add to your shell profile (~/.zshrc or ~/.bashrc)
export POSTFAST_API_KEY="your-api-key-here"

# Option B: Add to ~/.claude/settings.local.json
# { "env": { "POSTFAST_API_KEY": "your-api-key-here" } }

그런 다음 Claude Code를 재시작하세요.

수동 설정:

프로젝트의 .mcp.json 또는 ~/.claude/.mcp.json (전역)에 추가:

{
  "mcpServers": {
    "postfast": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / VS Code / Windsurf / 기타 MCP 클라이언트

MCP 설정(.mcp.json, mcp.json 또는 도구의 설정 UI)에 추가:

{
  "mcpServers": {
    "postfast": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. 사용 방법

AI 어시스턴트에게 다음과 같이 요청하세요:

"연결된 소셜 계정 목록을 보여줘"
"내일 오전 9시에 Instagram에 게시물 예약해줘"
"이번 주에 예약된 모든 게시물을 보여줘"
"이 이미지를 업로드하고 LinkedIn 게시물을 만들어줘"
"이 영상으로 Facebook 릴스를 만들어줘"
"이번 달 Instagram 게시물 분석을 보여줘"

사용 가능한 도구

도구	설명
`list_accounts`	연결된 소셜 미디어 계정 목록
`list_posts`	필터(플랫폼, 상태, 날짜 범위)를 적용한 게시물 목록
`create_posts`	게시물 생성 및 예약 (일괄 처리, 최대 15개)
`delete_post`	ID로 게시물 삭제
`upload_media`	로컬 파일을 업로드하고 미디어 키 획득 (전체 흐름 처리)
`get_upload_urls`	미디어 파일 업로드를 위한 서명된 URL 획득
`list_pinterest_boards`	계정의 Pinterest 보드 가져오기
`list_youtube_playlists`	계정의 YouTube 재생목록 가져오기
`generate_connect_link`	클라이언트가 계정을 연결할 수 있는 링크 생성
`get_post_analytics`	게시된 게시물의 성과 지표 가져오기 — Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (회사 페이지)

지원 플랫폼

Facebook, Instagram, X (Twitter), TikTok, LinkedIn, YouTube, BlueSky, Threads, Pinterest, Telegram

플랫폼별 제어

게시물을 생성할 때 controls 매개변수를 통해 플랫폼별 설정을 전달할 수 있습니다:

플랫폼	제어
X (Twitter)	`xCommunityId`, `xQuoteTweetUrl`, `xRetweetUrl`
Instagram	`instagramPublishType` (TIMELINE/STORY/REEL), `instagramPostToGrid`, `instagramCollaborators`
Facebook	`facebookContentType` (POST/REEL/STORY), `facebookAllowComments`, `facebookPrivacy`, `facebookReelsCollaborators`
TikTok	`tiktokPrivacy` (PUBLIC/MUTUAL_FRIENDS/FOLLOWER_OF_CREATOR/ONLY_ME), `tiktokIsDraft`, `tiktokAllowComments`, `tiktokAllowDuet`, `tiktokAllowStitch`, `tiktokBrandOrganic`, `tiktokBrandContent`, `tiktokAutoAddMusic`, `tiktokIsAigc`
YouTube	`youtubeTitle`, `youtubePrivacy` (PUBLIC/PRIVATE/UNLISTED), `youtubeTags`, `youtubeCategoryId`, `youtubeIsShort`, `youtubeMadeForKids`, `youtubePlaylistId`, `youtubeThumbnailKey`
Pinterest	`pinterestBoardId` (필수), `pinterestLink`
LinkedIn	`linkedinAttachmentKey`, `linkedinAttachmentTitle`

미디어 업로드

upload_media 도구는 단일 호출로 전체 흐름을 처리합니다:

파일 확장자에서 콘텐츠 유형 감지
PostFast에서 서명된 업로드 URL 획득
파일 업로드
create_posts에서 사용할 준비가 된 key와 type 반환

지원 형식: JPEG, PNG, GIF, WebP, MP4, WebM, MOV

업로드 과정을 더 세밀하게 제어해야 하는 경우 get_upload_urls를 직접 사용할 수도 있습니다.

환경 변수

변수	필수	설명
`POSTFAST_API_KEY`	예	워크스페이스 API 키
`POSTFAST_API_URL`	아니오	API 기본 URL (기본값: `https://api.postfa.st`)

테스트

MCP Inspector로 모든 것이 작동하는지 확인하세요:

POSTFAST_API_KEY=your-key npx @modelcontextprotocol/inspector npx postfast-mcp

API 문서

전체 REST API 문서: postfa.st/docs

개발

npm install
npm run build
node dist/index.js

배지

peturgeorgievv-factory/postfast-mcp MCP server

라이선스

MIT

postfast-mcp