Serwer MCP

Serwer MCP udostępnia Clip Foundry dla Claude Code, Claude Desktop, Cursora i dowolnego klienta MCP przez stdio.

Claude Code (CLI) — jedna komenda do skopiowania (podmień klucz):

bash

claude mcp add clipfoundry -e CLIPFOUNDRY_API_KEY=cf_live_... -- npx -y @clipfoundry/mcp

Claude Desktop / Cursor — dodaj do konfiguracji MCP klienta:

json

{
  "mcpServers": {
    "clipfoundry": {
      "command": "npx",
      "args": ["-y", "@clipfoundry/mcp"],
      "env": { "CLIPFOUNDRY_API_KEY": "cf_live_..." }
    }
  }
}

Klucz wygenerujesz w https://app.clipfoundry.pl/settings/keys.

Narzędzia: create_short, get_job, list_jobs, cancel_job, list_styles, list_voices, get_balance. create_short przyjmuje scenariusz (pełny tekst narracji, 10–5000 znaków) oraz voiceId z list_voices — nie temat. Silnik czyta scenariusz dosłownie i dorabia obrazy, napisy i muzykę. Podaj asystentowi scenariusz i głos, a zleci zadanie na Twoim koncie.

Uruchomienie na lokalnym silniku

Serwer MCP tylko woła HTTP API, więc lokalne generowanie wymaga działającego silnika. Skieruj klienta na lokalne API przez CLIPFOUNDRY_API_URL:

json

{
  "mcpServers": {
    "clipfoundry-local": {
      "command": "npx",
      "args": ["-y", "@clipfoundry/mcp"],
      "env": {
        "CLIPFOUNDRY_API_KEY": "cf_...",
        "CLIPFOUNDRY_API_URL": "http://localhost:4000"
      }
    }
  }
}

Uruchom API (pnpm --filter @shorts-engine/engine http:watch) i dispatcher (pnpm --filter @shorts-engine/engine dispatcher:watch), a klucz wygeneruj w http://localhost:3000/app/settings/keys. Z klona możesz też odpalić serwer ze źródeł: pnpm --filter @clipfoundry/mcp dev.

Klienty zdalne / web (Streamable HTTP)

Dla przeglądarki lub hostowanych klientów uruchom transport HTTP zamiast stdio:

bash

clipfoundry-mcp-http   # serwuje POST/GET/DELETE /mcp na :4100

Używa nowoczesnego transportu Streamable HTTP (SSE pod spodem) z sesjami mcp-session-id. Autoryzacja jest per sesja — każdy klient wysyła Authorization: Bearer <twój-klucz> przy initialize, więc jeden serwer obsłuży wielu użytkowników. Skieruj zdalnego klienta MCP na https://<host>/mcp.