---
title: "Conectar o Claude (MCP)"
description: "Conecte o seu próprio Claude (claude.ai, Claude Desktop ou Claude Code) ao Filmsquare via MCP, e gerencie ou desconecte a conexão."
url: https://www.filmsquare.ai/docs/pt-br/claude/connect/
lang: pt-BR
section: claude
updated: 2026-10-26
mcp: [whats_waiting]
---

# Conectar o Claude (MCP)

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

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

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

```bash
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](https://www.filmsquare.ai/docs/pt-br/claude/tools/) para o que fica de fora de propósito, e
[Prompts e método de trabalho](https://www.filmsquare.ai/docs/pt-br/claude/prompts/) 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).
