Faceless MCP server

Crie, renderize e publique automaticamente vídeos faceless com IA a partir do Claude, ChatGPT, Cursor ou qualquer cliente MCP: roteiros, narração, visuais, legendas, séries e agendamento para YouTube, TikTok, Instagram e mais 4 plataformas.

Ver em faceless.soExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://faceless.so/api/v1/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

MCP

O Faceless inclui um servidor Model Context Protocol (MCP) para que runtimes de agentes (Claude, Claude Code, Claude Desktop, Cursor e qualquer outro cliente MCP) possam chamar a API como ferramentas. Há duas formas de conectar: o servidor remoto via HTTP streamable, ou um servidor local via stdio. O servidor remoto aceita OAuth (entre com sua conta Faceless, sem necessidade de gerenciar chaves) ou uma chave de API das configurações da sua equipe em https://faceless.so/team;; o servidor local precisa de uma chave de API.

Conectar o Claude (claude.ai e os aplicativos Claude)

O caminho mais rápido para usuários do Claude é um conector personalizado. Sem instalação, sem chave de API: você entra com sua conta Faceless e aprova exatamente as permissões que deseja.

  1. No Claude, abra Configurações > Conectores > Adicionar conector personalizado.
  2. Insira https://faceless.so/api/v1/mcp e continue.
  3. O Claude abre a tela de consentimento do Faceless. Entre, escolha a equipe para conectar, desmarque qualquer permissão que não queira conceder e clique em Autorizar.
  4. De volta ao Claude, ative o conector em qualquer chat. Experimente: "Verifique meus créditos do Faceless" ou "Crie um vídeo sem rosto sobre criaturas do mar profundo e publique no meu YouTube".

Disponível nos planos Claude Pro, Max, Team e Enterprise. O acesso pode ser revogado a qualquer momento nas configurações da sua equipe no Faceless.

Faceless no diretório do Claude

O conector Faceless listado no diretório de conectores do Claude usa https://faceless.so/api/v1/mcp/claude. Ele faz login da mesma forma (OAuth, você escolhe a equipe e as permissões) e traz as ferramentas para gerenciar, renderizar e publicar os vídeos que você já tem no Faceless:

  • faceless_get_me: a equipe conectada, o plano e o saldo de créditos
  • faceless_list_videos, faceless_get_video, faceless_get_video_status: seus vídeos e em que etapa cada um está
  • faceless_update_video, faceless_select_video_thumbnail: títulos, legendas e descrições por plataforma, e qual miniatura um vídeo usa
  • faceless_render_video, faceless_get_render: renderizar um vídeo finalizado em MP4 e acompanhar a renderização
  • faceless_list_accounts, faceless_publish_post, faceless_schedule_post, faceless_post_now, faceless_cancel_post, faceless_get_calendar: publicar agora, agendar, antecipar uma publicação agendada, cancelar e ver o que está na fila
  • faceless_list_series, faceless_get_series, faceless_list_series_episodes: suas séries automatizadas e seus episódios
  • faceless_get_analytics: visualizações, curtidas, comentários e volume de publicações entre plataformas

Criar novos vídeos e comprar créditos não fazem parte deste conector; faça isso no aplicativo Faceless em https://faceless.so.

Experimente: "Liste meus vídeos do Faceless desta semana", "Agende meu vídeo mais recente do Faceless para YouTube e TikTok às 18h de amanhã" ou "Como foram minhas publicações do Faceless no TikTok nos últimos 30 dias?".

Solução de problemas: um erro forbidden_scope significa que a permissão foi desmarcada no login, então desconecte e reconecte o conector e mantenha-a marcada. Uma rejeição schedule_post geralmente significa que os metadados de publicação da plataforma estão ausentes; defina-os com faceless_update_video primeiro. A publicação exige que a plataforma esteja conectada no Faceless (verifique com faceless_list_accounts). Qualquer outra coisa: support@faceless.so.

Servidor remoto (nada para instalar)

O servidor remoto está em https://faceless.so/api/v1/mcp e usa o transporte HTTP streamable. Autentique com o mesmo cabeçalho Authorization da API REST.

Claude Code:

claude mcp add --transport http faceless https://faceless.so/api/v1/mcp \
  --header "Authorization: Bearer fl_live_..."

Qualquer cliente MCP que suporte HTTP streamable funciona da mesma forma: aponte para a URL e envie Authorization: Bearer fl_live_... em cada requisição.

Servidor local (stdio)

Para clientes que só falam stdio, execute o servidor localmente. Duas formas equivalentes: npx -y faceless-mcp, ou faceless mcp se o CLI estiver instalado. Ambos leem a chave da variável de ambiente FACELESS_API_KEY.

Claude Code:

claude mcp add faceless --env FACELESS_API_KEY=fl_live_... -- npx -y faceless-mcp

Claude Desktop (Configurações > Desenvolvedor > Editar Config, claude_desktop_config.json):

{
	"mcpServers": {
		"faceless": {
			"command": "npx",
			"args": ["-y", "faceless-mcp"],
			"env": { "FACELESS_API_KEY": "fl_live_..." }
		}
	}
}

Cursor (.cursor/mcp.json no seu projeto, ou o ~/.cursor/mcp.json global):

{
	"mcpServers": {
		"faceless": {
			"command": "npx",
			"args": ["-y", "faceless-mcp"],
			"env": { "FACELESS_API_KEY": "fl_live_..." }
		}
	}
}

Use o servidor remoto quando quiser zero instalação e ferramentas sempre atualizadas; use o local quando seu cliente só falar stdio ou sua política de rede preferir um processo iniciado localmente.

Ferramentas

Todas as 28 operações da API são expostas como ferramentas chamadas faceless_*, e cada uma respeita os escopos da chave (um escopo ausente aparece como erro forbidden_scope). As principais que um agente usa:

  • faceless_get_me, faceless_get_credits: identidade, escopos e orçamento
  • faceless_list_voices, faceless_list_options: catálogos para escolher vozes, estilos e modelos
  • faceless_create_video, faceless_get_video_status, faceless_render_video, faceless_get_render: o ciclo de criar, consultar, renderizar, consultar
  • faceless_create_caption_video: legendar filmagens existentes
  • faceless_update_video, faceless_publish_post, faceless_schedule_post, faceless_post_now, faceless_cancel_post, faceless_get_calendar: publicação e agendamento
  • faceless_create_series, faceless_list_series, faceless_get_series, faceless_update_series, faceless_delete_series, faceless_generate_series_episode, faceless_list_series_episodes: séries automatizadas
  • faceless_list_videos, faceless_get_video, faceless_delete_video, faceless_list_accounts, faceless_create_asset, faceless_get_analytics: o restante da superfície

Ferramentas de mutação aceitam um argumento opcional idempotencyKey com a mesma semântica do cabeçalho Idempotency-Key da REST: novas tentativas com a mesma chave e argumentos reproduzem o resultado armazenado em vez de reexecutar (e recobrar). Passe um quando uma chamada de ferramenta puder ser repetida.

Os resultados das ferramentas usam o mesmo envelope e tipos de erro da API REST; veja erros e limites de taxa. Os limites de taxa também se aplicam por chave, então um agente ocupado deve recuar em rate_limited.

Relacionados