MCP: FilmLune in Claude, Claude Code e Codex

MCP consente a un client compatibile di usare strumenti strutturati. FilmLune espone pubblicamente esempi riutilizzabili e, per gli account idonei, una generazione cloud privata sullo stesso endpoint MCP; non è disponibile un’API REST pubblica separata.

Collega un client compatibile all’endpoint Streamable HTTP di FilmLune. Sei strumenti pubblici non richiedono un account: cinque strumenti di catalogo filtrati in base ai diritti e l’elenco dei modelli di generazione. Gli account attivi con un indirizzo e-mail verificato possono usare la propria chiave MCP, con le autorizzazioni necessarie, per ottenere preventivi, caricare riferimenti e generare immagini e video privati con i crediti FilmLune idonei. È un accesso MCP, non un’API pubblica autonoma.

Endpoint Streamable HTTP

https://filmlune.com/api/mcp/

Aggiungi questo URL a un client MCP compatibile. Il catalogo non richiede una chiave; la generazione richiede una chiave di accesso MCP associata a un account idoneo.

Claude Code

Aggiungi FilmLune con un solo comando. Gli strumenti pubblici del catalogo funzionano senza chiave.

claude mcp add --transport http filmlune https://filmlune.com/api/mcp/

Per generare, salva la tua chiave di accesso MCP nella variabile d’ambiente FILMLUNE_MCP_KEY e aggiungila come intestazione:

claude mcp add --transport http filmlune https://filmlune.com/api/mcp/ --header "Authorization: Bearer $FILMLUNE_MCP_KEY"

Codex

Aggiungi FilmLune alla configurazione di Codex. Codex invia la chiave letta dalla variabile d’ambiente FILMLUNE_MCP_KEY; senza di essa sono disponibili solo gli strumenti pubblici.

[mcp_servers.filmlune]
url = "https://filmlune.com/api/mcp/"
bearer_token_env_var = "FILMLUNE_MCP_KEY"

App Claude

In Claude, aggiungi un connettore personalizzato e incolla l’URL dell’endpoint per usare gli strumenti pubblici del catalogo. La generazione richiede una chiave di accesso MCP inviata in un’intestazione della richiesta; per ora genera da Claude Code o Codex.

Connessione e chiamate

1. Aggiungi l’endpoint Streamable HTTP indicato sopra a un client MCP compatibile oppure avvia il server stdio locale.
2. Inizializza la connessione ed elenca i sei strumenti pubblici e i sette strumenti associati all’account per preventivi, caricamenti, generazione e cronologia.
3. Usa search_cases e get_case senza chiave. Per creare un media privato, aggiungi la tua chiave di accesso MCP, chiama generate_image o generate_video, poi check_generation.

Chiavi di accesso MCP

Crea, controlla e revoca le tue chiavi dal tuo account. Ogni chiave viene mostrata una sola volta: conservala in una variabile d’ambiente, non in un file condiviso.

FilmLune non ti chiederà mai la password, un codice monouso, il numero completo della carta, il codice di sicurezza, una chiave API o un segreto Stripe via e-mail, su X o su Discord.

• Gestisci le chiavi di accesso MCP

Autorizzazioni e fonte di verità

Il catalogo generato non dispone di percorsi di scrittura. Una generazione autenticata crea solo un task FilmLune privato per il proprietario e rispetta i controlli di sicurezza e crediti del sito; non può modificare o pubblicare il catalogo. I diritti di ogni scheda e la licenza dei contenuti regolano i prompt, mentre i media degli esempi e i contenuti di terze parti restano esclusi.

Trasporto stdio locale

Cinque strumenti in sola lettura, senza account, generazione cloud o accesso ai crediti.

• Repository GitHub open source

  github.com/xspring1982/filmlune-mcp