leeshfield MCP

MCP-сервер (Model Context Protocol) для leeshfield (платформа генерации видео). AI-клиенты (например, Claude) могут войти в аккаунт leeshfield через OAuth, добавлять активы, создавать видео, ссылаясь на них, и получать результаты.

Архитектура

MCP 클라이언트 (Claude 등)
   │  Streamable HTTP + OAuth 2.1 (PKCE)
   ▼
leeshfield-mcp  ← 이 리포. 얇은 어댑터 (리소스 서버)
   │  Bearer 토큰 그대로 전달 (introspection으로 검증)
   ▼
leeshfield 본체  ← 인가 서버(/oauth/authorize, /api/oauth/*) + REST API

• Сервер авторизации — это сам leeshfield. Потому что пользовательские сессии (экран входа и согласия) находятся на его домене. Этот сервер сообщает только местоположение AS через метаданные защищённого ресурса RFC 9728.

• Этот сервер не имеет собственных полномочий. Все вызовы инструментов передают пользовательский токен доступа напрямую в API leeshfield, а изоляция прав рабочего пространства и арендаторов обеспечивается leeshfield.

• stateless Streamable HTTP — без состояния сессии, безопасен для повторного развертывания и нескольких реплик.

Related MCP server: creatify-mcp

Инструменты

Переменные окружения

Разработка

npm install
LEESHFIELD_URL=http://localhost:3000 MCP_PUBLIC_URL=http://localhost:3100 \
OAUTH_INTROSPECT_SECRET=dev PORT=3100 npm run dev

Проверка: npm run typecheck && npm run lint

Подключение клиента

# Claude Code
claude mcp add --transport http leeshfield https://leeshfield-mcp.klr.kr/mcp

При подключении открывается браузер, после входа в leeshfield (Google/email) нужно разрешить на экране согласия. Регистрация клиента (DCR) и выдача токенов автоматические.

Развертывание

• Ветки: develop → dev(dev.leeshfield-mcp.klr.kr, только внутренняя сеть) / main → prod(leeshfield-mcp.klr.kr)

• Jenkins → OCI Registry → ArgoCD (gitops apps/leeshfield-mcp)

• dev MCP использует dev leeshfield(dev.leeshfield.klr.kr), prod — основной prod.