Filmsquare AjudaDocumentação

5.0 Trabalhe com o seu próprio Claude5.1 Conectar o Claude (MCP)

Conectar o Claude (MCP)

Conecte o seu próprio Claude (claude.ai, Claude Desktop ou Claude Code) ao Filmsquare via MCP, e gerencie ou desconecte a conexão.

Atualizado em 3 min de leitura.md

Nesta página
  1. claude.ai ou Claude Desktop
  2. Claude Code
  3. Com uma chave pessoal
  4. Confira se funciona
  5. Ver e desconectar conexões
  6. O que uma conexão pode fazer
  7. Detalhes técnicos

Todo integrante da equipe pode conectar o seu próprio Claude ao Filmsquare. O Claude então trabalha no seu espaço de trabalho em seu nome, com a sua função, na sua própria assinatura do Claude: ele vê o que está aguardando por você, passa pelo feedback, faz a decupagem de um roteiro e prepara um departamento. O Filmsquare não paga tokens de IA por isso, e você não paga créditos do Filmsquare pelo raciocínio do próprio Claude.

A conexão usa MCP (Model Context Protocol). O endereço é:

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

Você o encontra, com botões de copiar, em Settings → Claude: abra o menu do espaço de trabalho no alto da barra lateral, e escolha Settings (configurações), depois Claude.

A página Your Claude com o endereço do conector, o comando do Claude Code e as suas conexões (abrir a captura de tela completa)
Fig. 1 A página Your Claude com o endereço do conector, o comando do Claude Code e as suas conexões

claude.ai ou Claude Desktop #

  1. No Claude, abra Settings → Connectors e escolha Add custom connector.
  2. Dê o nome Filmsquare e cole o endereço https://app.filmsquare.ai/v1/mcp.
  3. Escolha Connect (conectar). O seu navegador abre a página Connect Claude do Filmsquare. Entre, se ainda não estiver.
  4. Escolha o Workspace (espaço de trabalho) em que o Claude pode trabalhar.
  5. Em Claude works as (o Claude trabalha como), mantenha a sua própria função ou escolha uma mais baixa.
  6. Escolha Allow (permitir). Você pode fechar a aba quando o Claude tiver aberto.

Claude Code #

Rode isto no seu terminal:

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

O Claude Code abre o seu navegador para conectar, com a mesma página Connect Claude de cima. Se não abrir, rode /mcp no Claude Code e escolha o servidor filmsquare para entrar.

Com uma chave pessoal #

Para uma máquina em que entrar pelo navegador não serve, use uma chave pessoal:

  1. Em Settings → Claude, escolha Use a personal key instead (usar uma chave pessoal).
  2. Dê um Name of the key (nome da chave; por exemplo "Claude Code no meu notebook") e escolha Create a personal key.
  3. Copie o comando. A chave aparece uma vez só.
claude mcp add --transport http filmsquare https://app.filmsquare.ai/v1/mcp \
  --header "Authorization: Bearer fsk_…"

Quem tiver esta chave pode trabalhar como você neste espaço de trabalho. Desconecte-a se ela vazar.

Confira se funciona #

Peça ao Claude com as suas próprias palavras, por exemplo:

  • "O que está aguardando por mim no Filmsquare?"
  • "Passe pelo feedback aberto da minha produção e trate tudo"
  • "Faça a decupagem do roteiro do Episódio 1 da minha produção"

O Claude começa com whats_waiting ou list_productions. A sua conexão aparece em Settings → Claude assim que ela conecta, e a lista de primeiros passos marca Connect your Claude.

Ver e desconectar conexões #

Settings → Claude lista Your Claude connections (suas conexões do Claude): o nome, a função e o último uso de cada conexão. Disconnect (desconectar) a interrompe na hora. Esta página lista só as suas próprias conexões e chaves.

O que uma conexão pode fazer #

  • É uma chave em seu próprio nome, em um espaço de trabalho, com no máximo a sua função. Se você escolheu uma função mais baixa, o Claude tem essa função.
  • Toda chamada confere a sua função de novo, e só mostra o que você pode ver. Se a sua função cair ou você sair do espaço de trabalho, os direitos do Claude vão junto.
  • O que o Claude faz aparece como você: em comentários, escolhas, aprovações e na atividade de cada item.
  • Uma conexão não pode criar chaves de API, permitir outras conexões nem gerenciar webhooks.

Veja O que o Claude faz para o que fica de fora de propósito, e Prompts e método de trabalho para as regras de segurança que o Claude segue.

Detalhes técnicos #

  • Transporte: Streamable HTTP, JSON-RPC sem estado. Lotes não são suportados.
  • Autenticação: OAuth 2.1 com PKCE (S256), registro dinâmico de cliente em /oauth/register, metadados em /.well-known/oauth-protected-resource/v1/mcp e /.well-known/oauth-authorization-server. Os códigos são de uso único e duram 10 minutos.
  • Sem credencial, o endpoint responde 401 com um cabeçalho WWW-Authenticate que aponta para os metadados.
  • Uma chave pessoal ou uma chave de API (Authorization: Bearer fsk_…) também funciona, assim como uma sessão iniciada.
  • Páginas de navegador de outras origens não podem chamar o endpoint (o claude.ai é permitido).

Com o Claude

MCP

O seu próprio Claude faz isso via MCP, em seu nome e com a sua função:

  • whats_waiting

    Lista as etapas que aguardam a sua aprovação e as notificações que você ainda não leu.

    Peça: O que está aguardando por mim no Filmsquare?

Conectar o Claude 5.1

Esta página em Markdown: /docs/pt-br/claude/connect.md