Faceless MCP server

Crea, renderiza y publica automáticamente videos sin rostro con IA desde Claude, ChatGPT, Cursor o cualquier cliente MCP: guiones, locuciones, visuales, subtítulos, series y programación para YouTube, TikTok, Instagram y 4 más.

Ver en faceless.soPrueba este MCPPatrocinado

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

MCP

Faceless incluye un servidor del Protocolo de Contexto de Modelos (MCP) para que los entornos de ejecución de agentes (Claude, Claude Code, Claude Desktop, Cursor y cualquier otro cliente MCP) puedan llamar a la API como herramientas. Hay dos formas de conectarse: el servidor remoto a través de HTTP transmisible, o un servidor local stdio. El servidor remoto acepta OAuth (inicia sesión con tu cuenta de Faceless, sin necesidad de gestionar claves) o una clave de API desde la configuración de tu equipo en https://faceless.so/team;; el servidor local necesita una clave de API.

Conectar Claude (claude.ai y las aplicaciones de Claude)

La vía más rápida para los usuarios de Claude es un conector personalizado. Sin instalación, sin clave de API: inicias sesión con tu cuenta de Faceless y apruebas exactamente los permisos que deseas.

  1. En Claude, abre Configuración > Conectores > Añadir conector personalizado.
  2. Introduce https://faceless.so/api/v1/mcp y continúa.
  3. Claude abre la pantalla de consentimiento de Faceless. Inicia sesión, elige el equipo a conectar, desmarca cualquier permiso que no quieras otorgar y haz clic en Autorizar.
  4. De vuelta en Claude, activa el conector en cualquier chat. Prueba: "Revisa mis créditos de Faceless" o "Crea un video sin rostro sobre criaturas de aguas profundas y publícalo en mi YouTube".

Disponible en los planes Claude Pro, Max, Team y Enterprise. El acceso puede revocarse en cualquier momento desde la configuración de tu equipo de Faceless.

Faceless en el directorio de Claude

El conector de Faceless listado en el directorio de conectores de Claude utiliza https://faceless.so/api/v1/mcp/claude. Inicia sesión de la misma manera (OAuth, tú eliges el equipo y los permisos) e incluye las herramientas para gestionar, renderizar y publicar los videos que ya tienes en Faceless:

  • faceless_get_me: el equipo conectado, el plan y el saldo de créditos
  • faceless_list_videos, faceless_get_video, faceless_get_video_status: tus videos y en qué punto se encuentra cada uno
  • faceless_update_video, faceless_select_video_thumbnail: títulos, subtítulos y descripciones por plataforma, y qué miniatura usa cada video
  • faceless_render_video, faceless_get_render: renderizar un video terminado a MP4 y seguir el renderizado
  • faceless_list_accounts, faceless_publish_post, faceless_schedule_post, faceless_cancel_post, faceless_get_calendar: publicar ahora, programar, cancelar y ver qué hay en cola
  • faceless_list_series, faceless_get_series, faceless_list_series_episodes: tus series automatizadas y sus episodios
  • faceless_get_analytics: vistas, me gusta, comentarios y volumen de publicación en todas las plataformas

Crear nuevos videos y comprar créditos no forman parte de este conector; hazlo en la aplicación de Faceless en https://faceless.so.

Prueba: "Lista mis videos de Faceless de esta semana", "Programa mi último video de Faceless en YouTube y TikTok para mañana a las 6pm" o "¿Cómo les fue a mis publicaciones de Faceless en TikTok durante los últimos 30 días?".

Solución de problemas: un error de forbidden_scope significa que el permiso se desmarcó al iniciar sesión, así que desconecta y reconecta el conector y mantenlo marcado. Un rechazo de schedule_post generalmente significa que faltan los metadatos de publicación de la plataforma; configúralo con faceless_update_video primero. La publicación necesita que la plataforma esté conectada en Faceless (verifícalo con faceless_list_accounts). Cualquier otra cosa: support@faceless.so.

Servidor remoto (nada que instalar)

El servidor remoto se encuentra en https://faceless.so/api/v1/mcp y utiliza el transporte HTTP transmisible. Autentícate con el mismo encabezado Authorization que la API REST.

Claude Code:

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

Cualquier cliente MCP que admita HTTP transmisible funciona de la misma manera: apúntalo a la URL y envía Authorization: Bearer fl_live_... con cada solicitud.

Servidor local (stdio)

Para clientes que solo hablan stdio, ejecuta el servidor localmente. Dos formas equivalentes: npx -y faceless-mcp, o faceless mcp si el CLI está instalado. Ambos leen la clave de la variable de entorno FACELESS_API_KEY.

Claude Code:

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

Claude Desktop (Configuración > Desarrollador > Editar configuración, claude_desktop_config.json):

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

Cursor (.cursor/mcp.json en tu proyecto, o el ~/.cursor/mcp.json global):

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

Usa el servidor remoto cuando quieras cero instalación y herramientas siempre actualizadas; usa el local cuando tu cliente solo hable stdio o tu política de red prefiera un proceso generado localmente.

Herramientas

Las 28 operaciones de la API están expuestas como herramientas llamadas faceless_*, y cada una respeta los alcances de la clave (un alcance faltante aparece como un error de forbidden_scope). Las principales a las que un agente recurre:

  • faceless_get_me, faceless_get_credits: identidad, alcances y presupuesto
  • faceless_list_voices, faceless_list_options: catálogos para elegir voces, estilos y modelos
  • faceless_create_video, faceless_get_video_status, faceless_render_video, faceless_get_render: el ciclo de vida de crear, consultar, renderizar, consultar
  • faceless_create_caption_video: subtitular material existente
  • faceless_update_video, faceless_publish_post, faceless_schedule_post, faceless_cancel_post, faceless_get_calendar: publicación y programación
  • faceless_create_series, faceless_list_series, faceless_get_series, faceless_update_series, faceless_delete_series, faceless_generate_series_episode, faceless_list_series_episodes: series automatizadas
  • faceless_list_videos, faceless_get_video, faceless_delete_video, faceless_list_accounts, faceless_create_asset, faceless_get_analytics: el resto de la superficie

Las herramientas de mutación aceptan un argumento opcional idempotencyKey con la misma semántica que el encabezado Idempotency-Key de la REST: los reintentos con la misma clave y argumentos reproducen el resultado almacenado en lugar de volver a ejecutarse (y volver a cobrarse). Pasa uno cuando una llamada de herramienta pueda reintentarse.

Los resultados de las herramientas usan el mismo sobre y tipos de error que la API REST; consulta errores y límites de velocidad. Los límites de velocidad también se aplican por clave, así que un agente ocupado debería retroceder en rate_limited.

Relacionado