leeshfield MCP

Servidor MCP (Protocolo de Contexto de Modelo) para leeshfield (plataforma de generación de video). Permite que clientes de IA (como Claude) inicien sesión en una cuenta de leeshfield mediante OAuth, añadan activos, generen videos haciendo referencia a ellos y reciban los resultados.

Arquitectura

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

• El servidor de autorización es el propio leeshfield. Porque la sesión del usuario (pantalla de inicio de sesión/consentimiento) está en ese dominio. Este servidor solo indica la ubicación del AS mediante metadatos de recursos protegidos RFC 9728.

• Este servidor no tiene autoridad propia. Todas las llamadas a herramientas se reenvían tal cual a la API de leeshfield con el token de acceso del usuario, y leeshfield aplica los permisos del espacio de trabajo y el aislamiento de inquilinos.

• HTTP Streamable sin estado: al no haber estado de sesión, es seguro para redespliegues y múltiples réplicas.

Related MCP server: creatify-mcp

Herramientas

Variables de entorno

Desarrollo

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

Verificación: npm run typecheck && npm run lint

Conexión del cliente

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

Al conectarse, se abre el navegador y, tras iniciar sesión en leeshfield (Google/correo electrónico) y aceptar en la pantalla de consentimiento, se completa el proceso. El registro del cliente (DCR) y la emisión de tokens se realizan automáticamente.

Despliegue

• Ramas: develop → dev(dev.leeshfield-mcp.klr.kr, solo red interna) / main → prod(leeshfield-mcp.klr.kr)

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

• El MCP de dev apunta al leeshfield de dev(dev.leeshfield.klr.kr), y el de prod al servidor principal de prod.