leeshfield MCP

MCP-Server (Model Context Protocol) für leeshfield (Video-Generierungsplattform). KI-Clients (z. B. Claude) können sich per OAuth bei einem leeshfield-Konto anmelden, Assets hinzufügen, darauf verweisend Videos generieren und Ergebnisse zurückerhalten.

Architektur

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

• Der Autorisierungsserver ist leeshfield selbst. Die Benutzersitzung (Login/Zustimmungsbildschirm) befindet sich auf dieser Domain. Dieser Server stellt lediglich den AS-Standort als geschützte Ressourcen-Metadaten gemäß RFC 9728 bereit.

• Dieser Server besitzt keine eigenen Berechtigungen. Alle Tool-Aufrufe werden mit dem Benutzerzugriffstoken unverändert an die leeshfield-API weitergeleitet; die Workspace-Berechtigungen und die Mandantentrennung erzwingt leeshfield.

• Zustandsloses Streamable HTTP – ohne Sitzungszustand, daher für Neubereitstellung und mehrere Replikate geeignet.

Related MCP server: creatify-mcp

Tools

Umgebungsvariablen

Entwicklung

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

Prüfung: npm run typecheck && npm run lint

Client-Verbindung

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

Beim Verbinden öffnet sich der Browser; nach dem leeshfield-Login (Google/E-Mail) und der Zustimmung im Einwilligungsbildschirm erfolgen Client-Registrierung (DCR) und Token-Ausstellung automatisch.

Bereitstellung

• Branches: develop → dev(dev.leeshfield-mcp.klr.kr, nur internes Netz) / main → prod(leeshfield-mcp.klr.kr)

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

• Das dev-MCP zeigt auf dev leeshfield(dev.leeshfield.klr.kr), das prod-MCP auf das Produktivsystem.