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: DevToolsのコンソールで以下を実行します： 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