velog_mcp

MCP-сервер, позволяющий Claude напрямую создавать и публиковать посты на Velog.

Поддерживает Velog, у которого нет публичного API, через реверс-инжиниринг GraphQL. Разработан по принципу human-in-the-loop: черновик → проверка пользователем → публикация, что обеспечивает автоматизацию при сохранении полного контроля со стороны пользователя.

Установка

npx velog_mcp_setup

Войдя в систему Velog, откройте инструменты разработчика (DevTools) в браузере → Application → Cookies → https://velog.io и скопируйте значения access_token и refresh_token.

Токены будут сохранены в ~/.velog-mcp.json с правами доступа 0600. Добавьте этот файл в .gitignore.

Related MCP server: velog-mcp

Настройка Claude CLI (Claude Code)

Добавление в проект

claude mcp add velog npx -y velog_mcp

Или добавьте напрямую в .claude/settings.json проекта:

{
  "mcpServers": {
    "velog": {
      "command": "npx",
      "args": ["-y", "velog_mcp"]
    }
  }
}

Глобальное добавление

claude mcp add --scope global velog npx -y velog_mcp

Глобальные настройки доступны во всех проектах.

Проверка

claude mcp list

Если сервер velog отображается в списке, значит всё готово. После этого его можно использовать прямо в чате Claude Code.

나: "React 훅에 대한 글 써줘"
Claude: (velog_draft_post 호출 → 검토 후 발행)

Настройка Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "velog": {
      "command": "npx",
      "args": ["-y", "velog_mcp"]
    }
  }
}

Использование

Написание и публикация поста

나: "React 19 concurrent features에 대한 글 써줘"

Claude: velog_draft_post 호출
→ { draft_id: "abc123", title: "React 19 Concurrent Features 정리", body_preview: "..." }

나: "좋아, 발행해"

Claude: velog_publish_post(draft_id: "abc123") 호출
→ { url: "https://velog.io/@username/react-19-...", post_id: "..." }

Публикация в приватном режиме

나: "이 글 비공개로 발행해줘"
Claude: velog_publish_post(draft_id: "abc123", is_private: true)

Список инструментов

Аутентификация

• access_token: TTL ~1-2 часа. Сервер Velog автоматически обновляет его через Set-Cookie в ответе GraphQL.

• refresh_token: TTL ~30 дней. При истечении срока действия необходимо повторно выполнить npx velog_mcp_setup.

• Отдельного эндпоинта для обновления нет — промежуточное ПО Velog обрабатывает это автоматически.

Обработка ошибок

Примечания

• Черновики сохраняются в памяти сессии процесса MCP-сервера. При перезапуске Claude Desktop они удаляются.

• Чтобы сохранить черновик без публикации, используйте velog_publish_post(is_private: true) для сохранения в приватном режиме.

• Изображения: используется метод ссылок на внешние URL в Markdown (![alt](url)).

Лицензия

MIT