SNS 예약 발행, Claude Code에 맡겨도 될까요? Postiz 설치·한계 확인 (2026 최신)

SNS 예약 발행, Claude Code에 맡겨도 될까요? Postiz 설치·한계 확인 (2026 최신)

Postiz는 Claude Code 같은 AI 에이전트가 SNS 예약 발행을 대신 실행하게 해 주는 오픈소스입니다. 연결은 명령 한 줄이지만 진짜 관문은 플랫폼 앱 승인이에요.

SNS 예약 발행을 AI에게 맡겨도 되는지, Postiz가 정확히 뭔가요?

먼저 답부터 드리면, Postiz는 연결이 쉬운 대신 발행 권한을 어디까지 줄지 사람이 정해야 하는 도구예요. 이 글을 열어 본 분은 아마 이런 질문을 품고 있을 거예요. "AI한테 SNS 계정을 맡겨도 되나요?" 그리고 "설치는 우리 팀이 따라갈 수 있나요?" 둘 다 당연한 걱정입니다. 이 글에서는 Postiz가 무엇인지, Claude Code에 붙이는 법, 할 수 있는 일과 못 하는 일, 직접 설치하는 순서와 비용, 보안 이력까지 공식 문서 기준으로 차례로 답해 볼게요.

GitHub 저장소 정보에 따르면 Postiz(gitroomhq/postiz-app)는 별 39,723개, 포크 7,542개(2026-10-28 17:39 KST 기준)를 받은 AGPL-3.0 라이선스 프로젝트입니다. README는 스스로를 이렇게 소개해요. "Postiz is a social media management platform for scheduling, automating, and analyzing your content." SNS 콘텐츠를 예약하고 자동화하고 분석하는 플랫폼이라는 뜻입니다.

Postiz란: 여러 SNS 계정의 글을 한곳에서 예약해 발행하는 오픈소스(소스코드가 공개된 프로그램) 도구입니다. 회사가 운영하는 유료 Postiz Cloud와, 내 서버에 직접 깔아 쓰는 셀프 호스팅(자기 서버에서 프로그램을 직접 운영하는 방식) 두 가지로 쓸 수 있어요.

여러 계정의 발송을 한 책상에서 처리하는 예약 발송실이라고 보면 쉬워요. 이 발송실 출입증을 AI 비서에게 쥐여 주는 일이 바로 연결입니다. 출입증을 받은 비서는 초안 서랍에 글을 넣을 수도 있고, 곧바로 발송 버튼을 누를 수도 있어요. 뒤쪽 안전장치 절이 이 차이를 다룹니다.

Claude Code에는 어떻게 붙이나요?

붙이는 일 자체는 명령 한 줄이에요. Postiz 공식 문서에 따르면 Postiz의 MCP 서버(AI 프로그램이 외부 도구를 불러 쓰는 표준 규격)는 AI에게 도구 13개를 내줍니다. 문서 원문은 "Postiz exposes an MCP server that provides 13 tools to AI agents."예요. 도구 참조 페이지(2026-10-20 갱신)에는 미디어 도구 섹션 3개가 더 있어서, 13개는 소개 문서 기준 숫자로 읽어 주세요.

postiz.com/claude-code 안내대로 OAuth(로그인 창에서 허용만 누르면 연결되는 방식)로 붙이면 API 키를 따로 만들 필요가 없습니다.

claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic

실행한 뒤 Claude에게 "List my connected social media accounts"라고 물어보세요. 연결된 채널 목록을 보여 주는 도구가 호출되면 연결 성공입니다.

터미널이 더 편하면 CLI(명령어로 쓰는 도구)와 에이전트 스킬 경로도 있어요.

npx skills add gitroomhq/postiz-agent
npm install -g postiz
postiz auth:login

postiz auth:login은 브라우저에서 승인하는 방식이고, 대신 POSTIZ_API_KEY 환경변수(프로그램에 알려 주는 설정값)를 써도 됩니다. 셀프 호스팅 서버에 붙일 때는 POSTIZ_API_URL에 내 서버 주소를 넣어요.

여기서 오해하기 쉬운 점이 하나 있어요. Postiz가 SNS 글을 스스로 기획해 주는 게 아닙니다. 글은 Claude 같은 AI가 쓰고, Postiz는 예약·발행 도구를 내주는 역할이에요. postiz.com/claude-code도 이렇게 당부합니다. "Please make sure there is always a human in the loop." 사람이 항상 중간에서 확인하라는 뜻이에요.

에이전트는 어디까지 하고, 무엇은 못 하나요?

Postiz 공식 문서(MCP 소개) 기준으로 에이전트가 할 수 있는 일은 다음과 같아요.

에이전트는 어디까지 하고, 무엇은 못 하나요?

AI 에이전트는 초안·예약·즉시 발행까지 맡을 수 있지만 댓글 읽기·답글과 채널 연결은 못 하므로, 처음엔 초안(draft)만 맡기고 사람이 확인한 뒤 예약하는 편이 안전합니다

자료: docs.postiz.com · QJC 재구성

• 연결된 채널과 플랫폼별 글쓰기 규칙 조회
• 초안·예약·즉시 발행 (schedulePostTool의 type 값이 draft, schedule, now)
• 기간별 게시물 조회와 미발행 게시물 수정
• AI 이미지·영상 생성, 유튜브 긴 영상 클리핑(잘라 내기)

못 하는 일도 분명합니다. 문서는 댓글을 읽거나 답글을 다는 기능이 없다고 밝혀요. 표현은 "The current tool set is read-only on integrations and write-only on posts/media."입니다. 채널 연결도 MCP가 아니라 사람이 Postiz 화면에서 해야 해요. "AI가 알아서 SNS를 운영한다"는 말은 맞지 않고, 사람이 연결해 둔 채널에 글을 올리는 일을 AI가 대신 누르는 구조라고 봐야 합니다.

플랫폼마다 형식 제약도 있어요. Postiz 공식 문서 기준으로 Threads는 500자, Instagram은 첨부 1개 이상 필수, YouTube는 영상 1개만 올릴 수 있습니다. 규칙을 어기면 검증 오류가 돌아와요.

한국 채널이 궁금하실 텐데요. 지원 플랫폼은 Postiz 공식 문서 기준 34개이고, 카카오톡과 네이버 블로그는 공식 지원 목록(2026-10-28 확인)에 없어요. 안 된다고 단정할 근거는 없지만 기본으로 쓸 수는 없다는 뜻입니다. README에 코드를 고쳐 채널을 추가할 수 있다는 언급은 있으나 그 난이도는 확인하지 못했어요.

시간대도 놓치기 쉬워요. Postiz 공식 문서에는 "Times are in your browser's timezone. There is no per-account timezone setting."이라고 적혀 있습니다. MCP 도구의 날짜는 UTC 문자열로 받아요. 한국 시간은 UTC보다 9시간 빠르니, 예약 시각이 9시간 어긋나지 않았는지 꼭 확인하세요.

잘못된 발행을 막아 주는 안전장치가 있나요?

"승인 버튼 같은 게 있겠죠?" 많이 나오는 질문이에요. 답은 반쯤만 맞습니다. Postiz 공식 문서를 정리하면 아래와 같아요.

Postiz 공식 문서의 승인 공유 안내 화면(Sharing a post for approval)

이미지 출처: docs.postiz.com

문서의 권고 문장은 "Ask it to draft rather than publish while you are getting a feel for it."입니다. 익숙해지기 전에는 발행 말고 초안만 만들게 하라는 뜻이에요. 미리보기 링크에 대해서도 "A preview link is not password protected."라고 밝히고 있어서, 링크를 받은 사람은 누구든 볼 수 있습니다. 실패한 게시물은 "Postiz does not silently retry a rejected post: fix the cause and reschedule."라는 설명대로 조용히 재시도하지 않아요.

한 줄 정리: 초안으로 만들고, 미리보기로 확인한 뒤, 사람이 예약으로 바꾸는 흐름을 문서가 권합니다. 이 흐름을 지킬지는 운영하는 사람의 습관에 달려 있어요.

API 키도 짚어 둘게요. Postiz 개발자 설정 문서에 따르면 키는 스스로 만료되지 않고("do not expire on their own") 유출되면 교체밖에 대책이 없습니다. 에이전트에게 키를 주면 연결된 모든 채널에 즉시 발행까지 할 수 있다는 뜻이에요. 셀프 호스팅 설정에는 시간당 게시물 생성 API 상한인 API_LIMIT이 있고 기본값은 90, 동봉된 compose 파일은 30입니다. 상한이 있다고 해서 잘못된 내용이 걸러지지는 않아요.

처음 시작한다면 채널 하나만 골라 "초안만 만들어 줘"로 시키는 게 안전합니다.

직접 설치하려면 무엇이 필요하고, 어디서 막히나요?

설치 사양과 순서

Postiz 공식 문서(System Requirements)가 권하는 출발점은 20명 이하 소규모 팀 기준 4 vCPU·8 GB RAM·50 GB 디스크예요. 하한은 아래와 같습니다.

문서는 2 GB가 혼자 가끔 발행하는 설치에만 맞는다고 보고, 여러 사용자라면 "plan for 4 GB or more"라고 적습니다.

설치는 Docker Compose(여러 프로그램을 한 번에 띄우는 도구)로 해요. Postiz와 PostgreSQL, Redis, Temporal(예약과 재시도를 관리하는 엔진)이 함께 올라갑니다.

git clone https://github.com/gitroomhq/postiz-docker-compose
# 변수 설정 후
docker compose up

끝나면 브라우저에서 http://localhost:4007로 접속해요. 필수 환경변수는 6개이고, 하나라도 없으면 부팅에 실패합니다.

• DATABASE_URL (데이터베이스 주소)
• REDIS_URL (Redis 주소)
• JWT_SECRET (로그인 관련 비밀값)
• FRONTEND_URL (접속 화면 주소)
• NEXT_PUBLIC_BACKEND_URL (브라우저가 부르는 서버 주소)
• BACKEND_INTERNAL_URL (서버 내부에서 쓰는 주소)

변수를 바꾼 뒤에는 docker compose down 다음 docker compose up을 해야 적용돼요. 프론트와 백엔드 주소의 상위 도메인이 다르면 채널 연결이 "Invalid state"로 실패하니 같은 상위 도메인으로 맞추세요. 백엔드가 상주형 서버라서 Vercel 같은 서버리스에는 올릴 수 없습니다.

비용은 README 표현 그대로 "you pay only for your own infra"예요. 라이선스 비용은 없지만 서버비와 AI 기능 사용료는 내가 부담합니다. 그래서 "완전 무료"라고 부르기는 어려워요.

진짜 관문은 플랫폼 앱 승인

설치보다 훨씬 오래 걸리는 단계가 따로 있어요. X, LinkedIn, Instagram, Threads, YouTube, TikTok 같은 플랫폼은 운영자가 각 플랫폼 개발자 포털에서 앱을 직접 만들고 승인받아야 합니다. README는 이렇게 적어요. "You create your own developer apps on each platform and go through their approval (Meta, YouTube, TikTok can take weeks)."

승인에 몇 주가 걸릴 수 있으니 "설치 5분" 같은 기대는 접어 두세요. 키를 넣지 않은 플랫폼도 채널 추가 화면에는 그대로 보이고, 누르면 안내 없이 연결 실패만 나옵니다.

다행히 앱 등록 없이 바로 붙는 채널이 10개 있어요. Bluesky, Lemmy, Nostr, Medium, Dev.to, Hashnode, WordPress, Listmonk, Moltbook, Skool입니다. 문서도 새 설치가 제대로 도는지 이 채널들로 먼저 확인하라고 권해요.

라이선스는 어떻게 보나요

AGPL-3.0은 수정한 프로그램을 네트워크로 다른 사용자에게 제공하면 수정본 소스를 내놓을 의무가 생길 수 있는 라이선스로 일반적으로 해석됩니다. 고치지 않고 사내 업무용으로 쓰는 경우와, 고쳐서 고객에게 서비스로 제공하는 경우는 다를 수 있어요. 후자라면 전문가 검토가 필요합니다. 이 문단은 법률 자문이 아니에요.

Postiz Cloud는 얼마이고, 직접 설치와 무엇이 다른가요?

Postiz 요금 페이지(postiz.com/pricing, 2026-10-28 확인, 통화 USD)에 따르면 요금제는 네 가지입니다.

연 결제 할인은 같은 요금제 월 결제 대비 약 20%예요. 모든 요금제가 7일 무료 체험으로 시작하고, 요금 페이지는 "There is no permanent free tier on the hosted version."이라고 밝힙니다. 버튼에 적힌 "Start for $0"는 7일 체험을 뜻해요. Standard는 팀원과 AI 이미지 생성이 없는 1인용입니다.

직접 설치와 Cloud 중 무엇이 맞을지는 비용만으로 정하기 어려워요. README는 기능을 막지 않는다("We do not "gate" features or limit the license.")고 하지만, 요금 페이지 FAQ는 "Self-hosting is a secondary option; the hosted platform is where the agent features ship first."라고 적습니다. 두 문장의 무게가 다르니 "기능이 똑같다"고 단정하지 마세요. 먼저 운영할 채널 수와 함께 쓸 팀원 수를 세어 보면, 요금제 선택이 훨씬 쉬워집니다.

보안 이력은 어떻고, Railway 서비스 중단은 무슨 일이었나요?

GitHub에 공개된 Postiz 보안 권고는 19건이고, 그중 2026년에 게시된 것이 18건이에요. 2026년분 심각도는 critical 5건, high 7건, medium 6건입니다. v2.25.1(2026-10-11), v2.25.2(2026-10-23), v2.25.3(2026-10-24, UTC)이 모두 보안 대응판이고, v2.25.3 릴리스 노트는 "all users are recommended to upgrade immediately"라고 권해요.

셀프 호스팅이라면 이 업데이트가 전부 내 몫입니다. README도 "You pull new images and run migrations yourself"라고 밝혀요. 서버를 쓰는 팀이라면 업데이트와 백업, 보안 패치를 누가 맡을지 먼저 정해 두세요.

이와 별개로 2026-10-21(UTC)에 Postiz Cloud가 전 고객 대상 서비스를 내렸다가 2026-10-22(UTC)에 재개했어요. 창업자 Nevo David는 X에 이렇게 썼습니다. "We are currently shutting down Postiz for all customers. We are afraid @Railway has been compromised" 창업자 설명 기준으로 이유는 호스팅 업체 Railway의 환경변수 저장 시스템 침해 공지와 Anthropic·Stripe의 키 유출 통보였어요.

Railway 공식 블로그(2026-10-21)는 같은 날 고객 환경변수 저장 시스템에서 이상 활동을 탐지했다고 공지하고, Railway에 저장한 환경변수 전부(API 키 포함)와 프라이빗 레지스트리 자격 증명을 바로 교체하라고 권고했습니다. Hacker News의 Railway 사고 토론(603 points)에서도 Postiz는 피해 사례로 언급됐어요.

중요한 구분이 있어요. 이 사건은 Postiz 코드의 취약점이 아니라 호스팅 업체 쪽 사건이라서 앞의 권고 18건과 별개입니다. v2.25.3 보안 수정과 관련이 있는지는 출처에서 확인되지 않았어요. 셀프 호스팅을 Railway에 올렸다면 같은 교체 권고의 대상이 될 수 있습니다.

마무리

Postiz는 Claude Code에 명령 한 줄로 붙고, 초안과 예약과 즉시 발행까지 에이전트가 실행하는 오픈소스예요. 대신 승인 플래그는 없고, 직접 설치하면 플랫폼 앱 승인과 보안 업데이트가 운영자 몫입니다. 카카오톡과 네이버 블로그는 공식 지원 목록에 없고 시간대는 9시간 차이를 확인해야 해요.

우리 팀 상황에 맞는지부터 따져보셔도 충분합니다. 판단에 필요한 기준은 위에 정리해 뒀어요. 지금 운영하는 채널 수와 앱 승인을 맡을 사람, 업데이트 담당자가 정해졌는지가 첫 점검 항목이에요.

자주 묻는 질문

Postiz는 무료로 쓸 수 있나요?

Postiz Cloud는 7일 무료 체험 뒤 월 $29(Standard, 월 결제 기준)부터이고 상시 무료 요금제는 없어요. 직접 설치하면 라이선스 비용은 없지만 서버비와 AI 기능 사용료는 내야 합니다. 출처는 Postiz 요금 페이지와 README(2026-10-28 확인)예요.

Claude에게 맡기면 댓글 답글까지 해 주나요?

해 주지 못해요. Postiz 공식 문서는 현재 도구가 연동 정보는 읽기 전용이고 게시물과 미디어는 쓰기 전용이라고 밝히고 있습니다. 댓글 읽기와 답글은 지원 목록에 없어서 사람이 직접 처리해야 해요.

Railway에 올려 둔 Postiz는 어떻게 해야 하나요?

Railway 공식 블로그(2026-10-21)가 저장한 환경변수 전부(API 키 포함)를 바로 교체하고 로그를 점검하라고 권고했습니다. 셀프 호스팅 서버를 Railway에 배포했다면 같은 권고가 적용돼요. 교체 범위는 Railway 공지 원문을 열어 직접 확인하세요.

참고 자료

• gitroomhq/postiz-app 저장소
• Postiz README
• MCP Introduction (Postiz Docs)
• Schedule Social Media Posts with Claude Code (Postiz)
• Docker Compose 설치 (Postiz Docs)
• Postiz 보안 권고 목록 (GitHub Security Advisories)
• Railway Blog: Security Disclosure
• Postiz Pricing
• Postiz v2.25.3 릴리스