Conectar fal, Replicate e ElevenLabs por MCP com permissões mínimas

Cada serviço de mídia tem painel, chave e formato de resposta próprios. Copiar esses detalhes para o chat expõe credenciais e convida o agente a inventar parâmetros: o resultado típico é uma chave colada na conversa, uma geração disparada sem preço conhecido e um modelo escolhido pelo nome parecido.

O MCP, protocolo que liga o agente a ferramentas externas como uma tomada padronizada, resolve a conexão: o Claude Code passa a enxergar as ferramentas de cada serviço com nome, esquema e descrição. Conectar, porém, não é autorizar. Um servidor de geração expõe na mesma lista a consulta de preço, que é gratuita, e a execução do modelo, que é cobrada por execução.

Nesta aula o primeiro resultado é um inventário, e não um vídeo. Você registra fal, Replicate e ElevenLabs hospedados, autentica cada um pelo navegador, grava o .mcp.json do projeto, libera só as ferramentas de consulta e deixa geração e alteração sob pergunta ou negadas.

Diferencie conexão, autenticação e permissão

Conexão é o registro do servidor. Servidor remoto entra com claude mcp add --transport http <nome> <url>. Servidor local, um processo na sua máquina que conversa pelo stdio (a entrada e a saída padrão do terminal), entra com claude mcp add --transport stdio <nome> -- <comando>, e variáveis vão em --env CHAVE=valor. O escopo decide onde o registro mora: local, o padrão, vale só para você neste projeto; project grava o .mcp.json na raiz, que vai para o Git e aceita variáveis no formato ${VAR}; user vale para todos os seus projetos.

Autenticação é provar ao serviço quem você é. Na fal e na ElevenLabs, o OAuth abre o navegador, você entra na conta e o Claude Code guarda o token. Na Replicate, a página que o /mcp abre pede um API token, que você cria em replicate.com/account/api-tokens e cola nessa página do navegador. Nos três casos, nenhuma chave passa pelo chat nem pelo .mcp.json. Permissão é o que o agente pode chamar sem perguntar, e ela mora no settings.json, com a mesma lógica de allow, ask e deny da aula 07. A aula sobre o grau de poder de cada servidor aprofunda essa separação para empresas, e a de MCP no curso de agentes explica o protocolo por dentro.

Registre os servidores no projeto

O bloco abaixo registra os quatro servidores pela linha de comando. Na ElevenLabs, use só o hospedado: o servidor local antigo saiu de linha, como a aula 01 registra. A documentação de operação do hospedado cobre ElevenAgents, os agentes de voz da empresa, e fala; o anúncio de 14/09/2026 promete também transcrição, música e efeitos, então conte só com o que aparecer no /mcp do seu workspace. No curso, a narração segue pela API, como na aula de Eleven v4. Alterações em agentes feitas pelo MCP são publicadas na hora, sem rascunho, na branch que o assistente indicar ou na main quando nenhuma for indicada; por isso o exercício nunca aponta para um agente em produção.

Para a equipe inteira usar os mesmos servidores, registre-os com --scope project ou grave direto o .mcp.json abaixo na raiz video-ia. Ele vai para o Git, então nunca leva chave: os três hospedados autenticam pelo navegador, e um servidor que precise de credencial lê a variável do ambiente com ${VAR}.

Libere só a consulta e deixe a geração sob pergunta

O MCP da fal expõe 11 ferramentas. Cinco só consultam: search_models, get_model_schema, get_pricing, search_docs e recommend_model. As outras seis executam, acompanham ou enviam arquivos: run_model, submit_job, check_job, get_job_result, cancel_job e upload_file. A geração é cobrada pela tabela da fal por execução, e não pela cota do seu plano Claude.

No settings.json, cada ferramenta MCP tem um nome no formato mcp__<servidor>__<ferramenta>, e a regra mcp__<servidor> sozinha cobre todas as ferramentas daquele servidor. Antes de gravar as regras, abra o /mcp e copie os nomes exatos que aparecem no seu workspace: a lista muda entre versões, e uma regra com nome errado não casa com nada. Nunca marque "sempre permitir" num servidor inteiro por conveniência.

Mescle as regras abaixo no .claude/settings.json da aula 07, sem apagar o hook nem as permissões que já estão lá. A lista enabledMcpjsonServers aprova os servidores do .mcp.json que você quer ativos; o Kinocut fica de fora até você revisar o pacote. Depois, o script Python cria o inventário que registra o que cada servidor realmente mostrou.

Decida quais operações podem avançar

Se a tarefa é narração ou transcrição, use a API da ElevenLabs com eleven_v4 ou scribe_v2, e não o MCP. Quando não houver preço ou esquema que dê para conferir, não autorize a geração. Se um servidor comunitário pedir acesso amplo, rode-o num ambiente separado, só com cópias de teste. E se o modelo devolvido for um preview com data de saída anunciada, escolha antes uma alternativa estável, pelos critérios da aula de escolha do modelo de vídeo.

Para os três vídeos semanais da Cozinha da Rafa, o agente consulta na fal opções de b-roll gerado, as imagens de apoio como a cartola dourando na frigideira, sem gerar nada. A resposta é uma tabela com fornecedor, ID, duração e preço por segundo; só depois do sim da Rafa a primeira cena é gerada, na aula de geração por API com polling.

Guia prático: consulta de preço sem tela e registro de toda tentativa de geração

Com os servidores conectados e as permissões mínimas da aula, dois usos aparecem na rotina: conferir preços toda semana sem abrir sessão e saber depois quem tentou gerar o quê. Aqui você roda a consulta da fal em claude -p, o modo sem interface que responde e sai, só com o servidor que ela precisa, e grava num arquivo de custos/ cada chamada de geração antes mesmo da pergunta de permissão.

Registre os servidores, grave as permissões mínimas e faça uma consulta de descoberta. Está pronto quando fal, Replicate e ElevenLabs aparecem autenticados no /mcp, a Replicate está registrada como http, o .mcp.json está na raiz sem segredo, logs/mcp-inventario.json lista as ferramentas que realmente apareceram, a consulta da fal devolveu modelo, esquema e preço sem nenhum job criado e nenhuma regra allow cobre geração ou alteração. Com isso, a aula de subagentes pode dividir o trabalho sem abrir a carteira.