Filmsquare AiutoDocumentazione

5.0 Lavora con il tuo Claude5.1 Collega Claude (MCP)

Collega Claude (MCP)

Collega il tuo Claude (claude.ai, Claude Desktop o Claude Code) a Filmsquare via MCP, e gestisci o scollega la connessione.

Aggiornato il 3 min di lettura.md

In questa pagina
  1. claude.ai o Claude Desktop
  2. Claude Code
  3. Con una chiave personale invece
  4. Controlla che funzioni
  5. Vedere e scollegare le connessioni
  6. Cosa può fare una connessione
  7. Dettagli tecnici

Ogni membro della troupe può collegare il proprio Claude a Filmsquare. Claude lavora allora nel tuo spazio di lavoro a tuo nome, con il tuo ruolo, sul tuo abbonamento Claude: vede cosa ti aspetta, passa in rassegna i feedback, fa lo spoglio di una sceneggiatura e prepara un reparto. Filmsquare non paga nessun token di IA per questo, e tu non paghi nessun credito Filmsquare per il ragionamento di Claude.

La connessione usa MCP (Model Context Protocol). L'indirizzo è:

https://app.filmsquare.ai/v1/mcp

Lo trovi, con i pulsanti per copiarlo, sotto Settings → Claude: apri il menu dello spazio di lavoro in alto nella barra laterale e scegli Settings, poi Claude.

La pagina Your Claude con l'indirizzo del connettore, il comando di Claude Code e le tue connessioni (apri lo screenshot intero)
Fig. 1 La pagina Your Claude con l'indirizzo del connettore, il comando di Claude Code e le tue connessioni

claude.ai o Claude Desktop #

  1. In Claude, apri Settings → Connectors e scegli Add custom connector.
  2. Chiamalo Filmsquare e incolla l'indirizzo https://app.filmsquare.ai/v1/mcp.
  3. Scegli Connect. Il tuo browser apre la pagina Filmsquare Connect Claude. Accedi se non l'hai fatto.
  4. Scegli lo Workspace in cui Claude può lavorare.
  5. Sotto Claude works as, tieni il tuo ruolo o scegline uno più basso.
  6. Scegli Allow. Puoi chiudere la scheda quando Claude si è aperto.

Claude Code #

Esegui questo nel tuo terminale:

claude mcp add --transport http filmsquare https://app.filmsquare.ai/v1/mcp

Claude Code apre il tuo browser per collegarsi, con la stessa pagina Connect Claude di sopra. Se non succede, esegui /mcp in Claude Code e scegli il server filmsquare per accedere.

Con una chiave personale invece #

Per una macchina dove un accesso dal browser non va bene, usa una chiave personale:

  1. In Settings → Claude, scegli Use a personal key instead.
  2. Dalle un Name of the key (per esempio «Claude Code sul mio portatile») e scegli Create a personal key.
  3. Copia il comando. La chiave viene mostrata una sola volta.
claude mcp add --transport http filmsquare https://app.filmsquare.ai/v1/mcp \
  --header "Authorization: Bearer fsk_…"

Chiunque abbia questa chiave può lavorare come te in questo spazio di lavoro. Scollegala se trapela.

Controlla che funzioni #

Chiedi a Claude con parole tue, per esempio:

  • «Cosa mi aspetta in Filmsquare?»
  • «Passa in rassegna i feedback aperti sulla mia produzione e gestiscili»
  • «Fai lo spoglio della sceneggiatura dell'Episodio 1 della mia produzione»

Claude parte da whats_waiting o list_productions. La tua connessione compare in Settings → Claude appena si è collegata, e la checklist per iniziare spunta Connect your Claude.

Vedere e scollegare le connessioni #

Settings → Claude elenca Your Claude connections: nome, ruolo e ultimo utilizzo di ogni connessione. Disconnect la ferma subito. Questa pagina elenca solo le tue connessioni e chiavi.

Cosa può fare una connessione #

  • È una chiave a tuo nome, in uno spazio di lavoro, con al massimo il tuo ruolo. Se hai scelto un ruolo più basso, Claude ha quel ruolo.
  • Ogni chiamata ricontrolla il tuo ruolo, e mostra solo ciò che puoi vedere. Se il tuo ruolo si abbassa o lasci lo spazio di lavoro, i diritti di Claude se ne vanno con te.
  • Ciò che fa Claude compare come fatto da te: nei commenti, nelle scelte, nelle approvazioni e nell'attività di ogni voce.
  • Una connessione non può creare chiavi API, autorizzare altre connessioni né gestire i webhook.

Vedi Cosa può fare Claude per ciò che è lasciato fuori di proposito, e Prompt e metodo di lavoro per le regole di sicurezza che Claude segue.

Dettagli tecnici #

  • Trasporto: Streamable HTTP, JSON-RPC senza stato. I batch non sono supportati.
  • Autenticazione: OAuth 2.1 con PKCE (S256), registrazione dinamica del client su /oauth/register, metadati su /.well-known/oauth-protected-resource/v1/mcp e /.well-known/oauth-authorization-server. I codici sono monouso e durano 10 minuti.
  • Senza credenziali l'endpoint risponde 401 con un header WWW-Authenticate che punta ai metadati.
  • Funzionano anche una chiave personale o una chiave API (Authorization: Bearer fsk_…), così come una sessione con accesso effettuato.
  • Le pagine del browser di altre origini non possono chiamare l'endpoint (claude.ai è consentito).

Con Claude

MCP

Il tuo Claude lo fa via MCP, a tuo nome e con il tuo ruolo:

  • whats_waiting

    Elenca le fasi in attesa della tua approvazione e le tue notifiche non lette.

    Chiedi: Cosa mi aspetta in Filmsquare?

Collega Claude 5.1

Questa pagina in Markdown: /docs/it/claude/connect.md