---
title: "Collega Claude (MCP)"
description: "Collega il tuo Claude (claude.ai, Claude Desktop o Claude Code) a Filmsquare via MCP, e gestisci o scollega la connessione."
url: https://www.filmsquare.ai/docs/it/claude/connect/
lang: it
section: claude
updated: 2026-10-26
mcp: [whats_waiting]
---

# Collega Claude (MCP)

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](https://www.filmsquare.ai/docs/shots/en/settings-claude-desktop.webp)

## 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:

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

```bash
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](https://www.filmsquare.ai/docs/it/claude/tools/) per ciò che è lasciato fuori di proposito, e
[Prompt e metodo di lavoro](https://www.filmsquare.ai/docs/it/claude/prompts/) 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).
