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.
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.

claude.ai o Claude Desktop #
- In Claude, apri Settings → Connectors e scegli Add custom connector.
- Chiamalo Filmsquare e incolla l'indirizzo
https://app.filmsquare.ai/v1/mcp. - Scegli Connect. Il tuo browser apre la pagina Filmsquare Connect Claude. Accedi se non l'hai fatto.
- Scegli lo Workspace in cui Claude può lavorare.
- Sotto Claude works as, tieni il tuo ruolo o scegline uno più basso.
- 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:
- In Settings → Claude, scegli Use a personal key instead.
- Dalle un Name of the key (per esempio «Claude Code sul mio portatile») e scegli Create a personal key.
- 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/mcpe/.well-known/oauth-authorization-server. I codici sono monouso e durano 10 minuti. - Senza credenziali l'endpoint risponde
401con un headerWWW-Authenticateche 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
MCPIl tuo Claude lo fa via MCP, a tuo nome e con il tuo ruolo:
whats_waitingElenca le fasi in attesa della tua approvazione e le tue notifiche non lette.
Chiedi: Cosa mi aspetta in Filmsquare?
Collega Claude 5.1