Substack by Cotlet — MCP-сервер для Claude Code: посты, заметки
Самодельный MCP-сервер и REST API для Substack: публикация постов из Markdown, заметки, комментарии, подписчики и статистика. Пригодится, если ведёте рассылку и хотите управлять ею из агента.
claude mcp add --transport http substack https://cotlet.dev/mcp/v1/substack/connectЧто делает Substack by Cotlet
Сервер запускается на вашей машине на Python и работает с Substack через сессию вашего же Chrome. Отдельного публичного API у Substack нет, поэтому запросы идут на внутренние эндпоинты сайта с вашими куками. Внутри 50 инструментов: посты и черновики из Markdown, отложенная публикация, заметки, комментарии, подписчики, статистика, рекомендации и личные сообщения.
Сначала нужно поднять Chrome с удалённой отладкой, войти в Substack и выполнить substack-mcp connect. Команда цепляется к браузеру через DevTools Protocol, забирает куки substack.com и кладёт их в ~/.config/substack-api-mcp/session.json — файл доступен только вашему пользователю. Пароль хранить не нужно: Substack входит по коду или ссылке из письма. Дальше каждый вызов уходит на substack.com/api/v1 через curl_cffi, который повторяет TLS-отпечаток Chrome. Браузер в фоне не крутится.
Нужен Python 3.11 или новее и Chrome 144 или новее с активной сессией Substack. Инструменты публикации работают на первой публикации, где у аккаунта есть роль админа, владельца, редактора или участника; читательские — на любом аккаунте. Лицензия некоммерческая, так что для команды или бизнеса этот вариант не подойдёт. Кука substack.sid живёт около трёх месяцев: когда Substack разлогинит, сервер перечитает куки из Chrome, но только если браузер открыт с включённой отладкой.
Какие задачи решает
- опубликовать пост из Markdown-файла без копирования в веб-редактор
- поставить публикацию в расписание
- выгрузить статистику публикации
- разобрать список подписчиков
- отправить личное сообщение читателю
Примеры запросов агенту
- Опубликуй пост из
draft.mdв моей рассылке - Покажи черновики, которые лежат дольше недели
- Собери статистику по последним постам
Как установить Substack by Cotlet
1Командой платформы: удалённый сервер
claude mcp add --transport http substack https://cotlet.dev/mcp/v1/substack/connect2Командой платформы
claude mcp add substack-by-cotlet -- uvx substack-api-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from substack-api-mcp <команда>
1Командой платформы: удалённый сервер
codex mcp add substack-by-cotlet --url https://cotlet.dev/mcp/v1/substack/connect2Командой платформы
codex mcp add substack-by-cotlet -- uvx substack-api-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from substack-api-mcp <команда>
Файл настроек
{
"mcpServers": {
"substack-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/substack/connect"
}
}
}{
"mcpServers": {
"substack-by-cotlet": {
"command": "uvx",
"args": [
"substack-api-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from substack-api-mcp <команда>
Файл настроек
{
"servers": {
"substack-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/substack/connect"
}
}
}{
"servers": {
"substack-by-cotlet": {
"type": "stdio",
"command": "uvx",
"args": [
"substack-api-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from substack-api-mcp <команда>
1Командой платформы: удалённый сервер
gemini mcp add -t http substack-by-cotlet https://cotlet.dev/mcp/v1/substack/connect2Командой платформы
gemini mcp add substack-by-cotlet uvx substack-api-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from substack-api-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Substack by Cotlet
Как установить Substack by Cotlet в Claude Code?
Локальный вариант: claude mcp add substack-by-cotlet -- uvx substack-api-mcp. Если нужен хостинг Cotlet, команда другая: claude mcp add --transport http substack https://cotlet.dev/mcp/v1/substack/connect.
Что делает Substack by Cotlet?
Даёт агенту доступ к вашей рассылке в Substack: посты и черновики, заметки, комментарии, подписчики, статистика, рекомендации и личные сообщения. Всего 50 инструментов, плюс REST API на http://127.0.0.1:8787/api/v1/substack и вызовы из Python.
Что нужно, чтобы сервер заработал?
Python 3.11 или новее, Chrome 144 или новее с выполненным входом в Substack и разово запущенная команда substack-mcp connect. Инструменты для публикации требуют роли админа, владельца, редактора или участника в рассылке.
