substack-mcp

AI 어시스턴트가 귀하의 발행물 데이터를 읽고 초안을 관리할 수 있게 해주는 Substack용 MCP 서버입니다.

안전한 설계: 이 서버는 초안을 생성하고 편집할 수 있지만, 게시물을 게시하거나 삭제할 수는 없습니다. 게시물은 항상 Substack 에디터를 통해 직접 검토하고 게시해야 합니다.

도구

읽기

쓰기

의도적으로 제외된 기능

• 게시물 게시 — 긴 형식의 게시물을 게시하는 것은 인간이 신중하게 결정해야 하는 작업입니다.

• 삭제 — AI 도구로 수행하기에는 너무 파괴적입니다.

• 예약 — 예약 기능은 Substack 에디터를 사용하세요.

Related MCP server: Substack MCP Server

설정

1. 자격 증명 가져오기

브라우저에서 Substack을 열고 다음을 수행하세요:

1. 세션 토큰: 발행물 페이지로 이동하여 개발자 도구(DevTools) → 애플리케이션(Application) → 쿠키(Cookies)를 열고 connect.sid의 값을 복사합니다 (s%3A로 시작하는 URL 인코딩된 문자열).

2. 사용자 ID: 개발자 도구 콘솔에서 다음을 실행합니다: fetch('/api/v1/archive?sort=new&limit=1').then(r=>r.json()).then(d=>console.log(d[0]?.publishedBylines?.[0]?.id))

3. 발행물 URL: 귀하의 Substack URL (사용자 지정 도메인이 있는 경우 포함, 예: https://newsletter.yourdomain.com 또는 https://yourblog.substack.com)

2. MCP 클라이언트 구성

Claude Desktop

claude_desktop_config.json에 추가하세요:

{
 "mcpServers": {
 "substack": {
 "command": "npx",
 "args": ["-y", "@conorbronsdon/substack-mcp"],
 "env": {
 "SUBSTACK_PUBLICATION_URL": "https://yourblog.substack.com",
 "SUBSTACK_SESSION_TOKEN": "your-session-token",
 "SUBSTACK_USER_ID": "your-user-id"
 }
 }
 }
}

Claude Code

.mcp.json에 추가하세요:

{
 "mcpServers": {
 "substack": {
 "command": "npx",
 "args": ["-y", "@conorbronsdon/substack-mcp"],
 "env": {
 "SUBSTACK_PUBLICATION_URL": "https://yourblog.substack.com",
 "SUBSTACK_SESSION_TOKEN": "your-session-token",
 "SUBSTACK_USER_ID": "your-user-id"
 }
 }
 }
}

3. 확인

AI 어시스턴트에게 "내 Substack 구독자가 몇 명이야?"라고 물어보세요.

토큰 만료

Substack 세션 토큰은 주기적으로(보통 약 90일) 만료됩니다. 인증 오류가 발생하면 브라우저에서 새로운 connect.sid 쿠키를 가져와 환경 변수를 업데이트하세요. 쿠키를 복사할 때 광고 차단기가 비활성화되어 있는지 확인하세요.

마크다운 지원

create_draft 및 update_draft 도구는 마크다운을 허용하며 이를 Substack의 기본 형식으로 변환합니다. 지원되는 항목:

• 단락, 제목 (h1–h6)

• 굵게, 기울임꼴, inline code

• 링크

• 이미지

• 글머리 기호 및 번호 매기기 목록

• 코드 블록 (언어 포함)

• 인용문

• 가로 구분선

중요 참고 사항

• 이 서버는 Substack의 비공식 API를 사용합니다. Substack이 엔드포인트를 변경하면 작동하지 않을 수 있습니다.

• 세션 토큰은 쿠키로 전송됩니다. SUBSTACK_SESSION_TOKEN을 안전하게 보관하세요.

• 서버는 시작 시 인증을 검증하며 토큰이 만료된 경우 즉시 실패합니다.

개발

git clone https://github.com/conorbronsdon/substack-mcp.git
cd substack-mcp
npm install
npm run build

로컬에서 실행:

SUBSTACK_PUBLICATION_URL=https://yourblog.substack.com \
SUBSTACK_SESSION_TOKEN=your-token \
SUBSTACK_USER_ID=your-id \
npm start

면책 조항

이 계정에서 표현된 모든 견해, 의견 및 진술은 전적으로 본인의 것이며 개인적인 자격으로 작성되었습니다. 이는 Modular의 견해, 입장 또는 정책을 반영하지 않으며 그렇게 해석되어서도 안 됩니다. 이 계정은 Modular와 제휴하거나, 승인받거나, 보증받지 않습니다.

라이선스

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• create_draftA
• create_noteA
• create_note_with_linkA
• get_draftA
• get_postA
• get_post_commentsA
• get_subscriber_countA
• list_draftsB