Velog — MCP-сервер для Claude Code: посты, серии, комментарии
Подключает Claude к Velog: черновики, публикация постов, серии, комментарии, поиск и тренды — через 29 инструментов.
claude mcp add velog -- npx -y velog-mcp-claudeЧто делает Velog
Velog — stdio MCP-сервер на Node.js, который даёт агенту доступ к velog.io. Через него можно создать черновик поста и опубликовать его, править и удалять записи, загружать картинки на CDN Velog, вести серии, писать комментарии и ставить лайки. Отдельный блок инструментов — разведка: поиск по ключевым словам, тренды за день, неделю, месяц или год, отчёт по трендам и подбор популярных тем, которых у вас ещё нет.
Есть два инструмента для миграции и генерации контента. Один переносит markdown из GitHub-блога (Jekyll, Hugo и прочие с front matter) в черновики Velog, относительные пути картинок превращает в raw-ссылки. Второй разбирает историю коммитов и diff локального репозитория и готовит черновик технического поста — можно указать число коммитов, диапазон после тега, включать ли diff и сколько строк брать, а также подсказать теги.
Перед первым запуском нужен Node.js 18+ и токены Velog. Их достают из DevTools → Application → Cookies на https://velog.io и вводят через npx -p velog-mcp-claude velog-mcp-setup; сохраняются они в ~/.velog-mcp.json с правами 0600. access_token живёт около 24 часов и обновляется сервером сам, refresh_token — около 30 дней, после чего setup надо прогнать заново. Черновики держатся в памяти сессии: перезапуск их стирает, а через 24 часа они истекают. Нужен долгий черновик — публикуйте с is_private: true.
Сервер собран на внутреннем GraphQL API Velog, который разбирали реверс-инжинирингом.
Какие задачи решает
- написать черновик поста по свежим коммитам и diff
- перенести статьи из GitHub-блога в Velog
- разложить посты по сериям и поправить их порядок
- посмотреть тренды Velog и найти незанятые темы
- ответить на комментарии под своими записями
Примеры запросов агенту
- Собери черновик поста по последним 10 коммитам в этом репозитории
- Перенеси статьи из папки
_postsв черновики Velog, сначала покажи превью - Какие темы сейчас в тренде на Velog за неделю и что из этого я ещё не писал?
Как установить Velog
Командой платформы
claude mcp add velog -- npx -y velog-mcp-claudeКомандой платформы
codex mcp add velog -- npx -y velog-mcp-claudeФайл настроек
{
"mcpServers": {
"velog": {
"command": "npx",
"args": [
"-y",
"velog-mcp-claude"
]
}
}
}Файл настроек
{
"servers": {
"velog": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"velog-mcp-claude"
]
}
}
}Командой платформы
gemini mcp add velog npx -y velog-mcp-claudeПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Velog
Как установить Velog MCP в Claude Code?
Сначала получите токены: npx -p velog-mcp-claude velog-mcp-setup. Затем добавьте сервер командой claude mcp add velog -- npx -y velog-mcp-claude. Для глобальной установки — claude mcp add --scope global velog -- npx -y velog-mcp-claude.
Что делает Velog MCP?
Даёт агенту 29 инструментов для работы с velog.io: черновики и публикация постов, правка и удаление, серии, комментарии, лайки, поиск, тренды и аналитика тем. Плюс импорт markdown из GitHub-блога и генерация черновика по истории git.
Что нужно для работы сервера?
Node.js 18+ и токены access_token и refresh_token из cookies Velog. Сервер работает через внутренний GraphQL API, поэтому при изменении API на стороне Velog инструменты могут перестать отвечать.
