Conecta tu Agent mediante MCP

Elige tu método de conexión

FreeLipSync expone un punto final MCP remoto en https://freelipsync.com/mcp. Le brinda al agente las mismas capacidades de generación de video y créditos de cuenta que el REST API. Debes tener una cuenta FreeLipSync registrada; No se admite el acceso anónimo. Para probar en staging, utiliza el dominio de ese entorno.

Se admiten tanto la configuración API Key como OAuth. Elija una fuente de credenciales por entrada de servidor. Un archivo de configuración existente sigue siendo una forma válida de conectarse; no es necesario utilizar OAuth.

Crea una clave y copia el secreto completo del diálogo de creación. OAuth no requiere copiar ninguna clave. Cada cuenta admite hasta 5 API Keys y 5 conexiones OAuth independientes. Acceder con una API Key ocupa un cupo de clave, no uno de conexión OAuth. Ambos métodos comparten el saldo, los modelos y los límites de la cuenta.

Flujo de autorización OAuth

1. Agregue el HTTPS URL remoto en su cliente, sin un encabezado Authorization o configuración API Key.
2. Elija Connect / Authenticate / Sign in, según corresponda para el cliente.
3. En el navegador, inicie sesión en su cuenta FreeLipSync y revise el cliente solicitante y los permisos.
4. Cree una nueva conexión (predeterminada) o elija explícitamente una conexión existente para reemplazarla. Una autorización exitosa en otro dispositivo normalmente cuenta por separado.
5. Permita que el agente gaste los créditos API adquiridos y luego autorícelo. Regrese al cliente y verifique las herramientas a continuación.

Puede rechazar la solicitud. Si se utilizan todas las ranuras de conexión 5, reemplace o revoque explícitamente una conexión anterior en la consola Agent; una nueva autorización no desaloja silenciosamente una conexión. La actualización de token y la reconexión de una autorización existente no agregan una ranura. Una conexión OAuth puede gastar los créditos de su cuenta cuando se envía la generación.

La compatibilidad del cliente OAuth es importante: FreeLipSync admite metadatos de identidad de cliente publicados (CIMD) y clientes prerregistrados, en lugar de un punto final de registro dinámico abierto. Utilice una versión de cliente compatible o una ID de cliente asignada cuando sea compatible. Si un cliente solo admite el registro dinámico y el inicio de sesión falla, utilice el método API Key o comuníquese con el soporte para verificar el registro del cliente.

Compatibilidad del cliente y diferencias OAuth

El registro OAuth y la autenticación de token son independientes. FreeLipSync admite CIMD o un ID de cliente prerregistrado, con none + PKCE o private_key_jwt. Entiende la gama más nueva de métodos admitidos CIMD, así como el campo de método único más antiguo. Los clientes firmados utilizan sus claves públicas publicadas automáticamente; los usuarios no cargan una clave privada.

FreeLipSync no ofrece registro dinámico abierto (DCR), autenticación de secreto de cliente ni la concesión client_credentials. Si un cliente requiere DCR, use su opción de cliente público prerregistrado cuando esté disponible, o use la configuración API Key en un cliente que admita encabezados de portador personalizados. Obtenga una ID asignada y registre la devolución de llamada real antes de configurarla. Un ID de cliente API Key y OAuth son credenciales diferentes.

Codex: archivo de configuración o OAuth

Agregue o edite un servidor HTTP remoto en Plugins → MCPs en Codex; algunas versiones utilizan servidores Settings → MCP. Esta entrada local MCP admite la configuración de API Key y está separada de la entrada del complemento alojado OAuth descrita anteriormente.

Elija una fuente de credenciales. Los ejemplos utilizan https://freelipsync.com/mcp. Para staging, reemplácela con https://staging.freelipsync.com/mcp y cree la clave en su cuenta de staging. Las claves de producción y de staging no son intercambiables.

Opción A: pegar un API Key en la configuración del escritorio

Utilice esta opción cuando no desee configurar variables de entorno. Cree una clave en la consola Agent, copie el secreto completo y luego complete:

Utilice un espacio después de Bearer; la clave en sí no tiene prefijo de portador. No asigne al encabezado el nombre FLS_API_KEY ni pegue el secreto en Bearer token env var. Guardar y volver a conectar; Si el cliente todavía usa una configuración anterior, reinícielo o abra una nueva sesión.

La entrada personal equivalente ~/.codex/config.toml es:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
http_headers = { Authorization = "Bearer YOUR_API_KEY" }

Opción B: suministrar el API Key a través de una variable de entorno

Bearer token env var toma un nombre de variable, no un secreto. Configúrelo en FLS_API_KEY. Esa variable debe existir en el entorno del proceso que ejecuta Codex. Su valor es la clave completa sin Bearer ; Codex agrega el prefijo.

El archivo de configuración personal correspondiente es:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
bearer_token_env_var = "FLS_API_KEY"

Para Codex CLI iniciado desde un terminal:

export FLS_API_KEY='YOUR_API_KEY'
codex mcp list
codex
# Inspect /mcp in the new session.

Exportar una variable en otra terminal no actualiza una aplicación de escritorio que ya se está ejecutando. Es posible que una aplicación iniciada desde el menú Dock o Inicio tampoco herede variables de terminal. Si no está seguro de cómo proporcionar el entorno de proceso de escritorio, utilice la opción A.

Headers crea encabezados de solicitud HTTP. Headers from environment variables lee los valores de encabezado de las variables de entorno existentes. Ninguno de los campos crea una variable de entorno del sistema. Un encabezado denominado FLS_API_KEY no completa la configuración de Portador y un marcador de posición gris como MCP_BEARER_TOKEN no significa que esa variable se haya configurado.

Opción C: autorizar en el navegador con OAuth

Ingrese solo el URL. Deje Bearer token env var, Headers y Headers from environment variables vacíos, incluida la eliminación de cualquier fila Authorization anterior. Guarde, elija Authenticate / Sign in donde esté disponible, inicie sesión en FreeLipSync y apruebe la conexión. No es necesario crear ni pegar ningún API Key.

Para un archivo de configuración, mantenga solo:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"

Comandos CLI:

# Run the next line only if this server name does not exist; otherwise edit it.
codex mcp add freelipsync --url https://freelipsync.com/mcp
codex mcp login freelipsync
codex mcp list

Reemplace freelipsync en los comandos con el nombre de su servidor guardado. Los tres bloques TOML anteriores son alternativas; mantenga una entrada para el servidor. Elimine la configuración con clave antes de cambiar a OAuth: iniciar sesión no repara un encabezado Authorization incorrecto que aún está configurado.

Verifique la conexión después de guardar

En una nueva sesión, pregunte: "Llame a FreeLipSync get_capabilities y get_usage para verificar mis modelos y créditos. No genere un video". Una respuesta exitosa de la cuenta confirma la conexión; un nombre de servidor que aparece solo en la lista no lo hace.

Para HTTP 401, verifique que URL y la clave pertenezcan al mismo entorno, que la clave esté completa, que el encabezado estático sea Authorization: Bearer YOUR_API_KEY y que no quede ninguna variable portadora antigua ni ninguna configuración de Authorization duplicada. Con la opción B, verifique también el entorno del proceso que realmente inicia el cliente.

Consulte la guía oficial de OpenAI MCP y la referencia de configuración para obtener definiciones de campos.

Claude Code: archivo de configuración o OAuth

Para acceder a API Key, coloque esta entrada en una configuración MCP personal/local o combínela con .mcp.json para el proyecto. La variable de entorno se expande con Claude Code. Mantenga la clave real fuera de la configuración compartida e inicie Claude Code con el conjunto de variables.

{
  "mcpServers": {
    "freelipsync": {
      "type": "http",
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer ${FLS_API_KEY}"}
    }
  }
}

export FLS_API_KEY='YOUR_API_KEY'
claude mcp list

Para OAuth, primero elimine la entrada con clave o su encabezado Authorization, agregue un servidor HTTP exclusivo para URL y autentíquese a través de /mcp en una sesión interactiva Claude Code:

claude mcp add --transport http --scope user freelipsync https://freelipsync.com/mcp
claude
# In Claude Code, run /mcp and choose Authenticate for freelipsync.

Utilice un método a la vez. Un encabezado de portador no válido configurado no se solucionará iniciando sesión a través de un flujo diferente. Consulte la guía oficial MCP de Claude Code.

Claude Desktop y Claude web

Para OAuth, abra la página de administración Connectors de Claude, agregue un conector web/remoto personalizado llamado FreeLipSync e ingrese https://freelipsync.com/mcp. Elija iniciar sesión y utilizar la identidad de cliente publicada de Claude cuando esté disponible; Complete la página de autorización FreeLipSync. Una organización puede exigir a su propietario que habilite el conector primero. Los conectores remotos deben llegar a un punto final público HTTPS; No se puede acceder a localhost desde la nube de Claude. Consulte la Guía del conector remoto de Claude.

Para el método antiguo de archivo de configuración de Claude Desktop, un cliente que solo admite stdio necesita un puente local hacia el servidor remoto; pegar una url remota en una configuración stdio no basta. Con Node.js / npx instalado, añade esta entrada a claude_desktop_config.json (ábrelo desde los ajustes de desarrollador de Desktop) y reinicia Desktop. Sustituye el marcador en tu equipo y mantén este archivo personal en privado.

{
  "mcpServers": {
    "freelipsync": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://freelipsync.com/mcp",
        "--header", "Authorization:${FLS_AUTH_HEADER}"
      ],
      "env": {"FLS_AUTH_HEADER": "Bearer YOUR_API_KEY"}
    }
  }
}

mcp-remote es un puente de compatibilidad de terceros, no un paquete FreeLipSync. Revise sus instrucciones del mantenedor y su versión instalada. Su argumento de encabezado apoya la expansión del entorno; el formato anterior también evita espacios dentro del argumento. Prefiera el soporte nativo HTTP de un cliente cuando esté disponible. Este archivo de escritorio no es el mecanismo de configuración para Claude web.

Cursor: archivo de configuración o OAuth

Para acceder a API Key, utilice su ~/.cursor/mcp.json personal (o un proyecto .cursor/mcp.json mantenido fuera del control de código fuente cuando contiene una clave). Reemplace el marcador de posición localmente. No asuma que la expansión del entorno desde el formato de otro cliente funciona en su versión Cursor instalada.

{
  "mcpServers": {
    "freelipsync": {
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer YOUR_API_KEY"}
    }
  }
}

Para OAuth, use la misma entrada solo con url, eliminando el objeto de encabezados. En la configuración de MCP de Cursor, conéctese/autentíquese y complete la autorización del navegador, si se ofrece. Vuelva a cargar o reinicie el cliente después de cambiar su configuración, luego verifique las herramientas en modo Agent. Si el flujo de registro de esa versión es incompatible, utilice la configuración de clave anterior. Consulte las instrucciones oficiales de MCP de Cursor.

VS Code y GitHub Copilot

Para una configuración nativa de VS Code MCP, cree .vscode/mcp.json con una entrada de contraseña en lugar de una clave real en el archivo:

{
  "inputs": [
    {"type":"promptString","id":"fls-key","description":"FreeLipSync API Key","password":true}
  ],
  "servers": {
    "freelipsync": {
      "type":"http",
      "url":"https://freelipsync.com/mcp",
      "headers":{"Authorization":"Bearer ${input:fls-key}"}
    }
  }
}

Para OAuth, elimine inputs y headers, conservando el tipo de servidor y URL. Inicie/conecte el servidor y siga las instrucciones de autenticación; El registro del cliente debe ser compatible como se describe anteriormente. Seleccione sus herramientas en el modo Agent de Copilot y pruebe el mensaje de verificación a continuación. El formato VS Code utiliza servers, no el mcpServers de otro cliente; Las entradas interactivas no son compatibles con todos los arneses o configuraciones portátiles Copilot. Consulte la referencia VS Code MCP.

Verifique las herramientas y pruebe un mensaje

Primero pregúntele a su agente: "Use FreeLipSync para verificar mis modelos disponibles y saldo de crédito. No cree un video todavía. " Debe llamar a get_capabilities y get_usage, sin gastar créditos. Un servidor incluido en un archivo de configuración no es prueba suficiente de que la autenticación funcionó.

Entonces intente: "Haga una breve foto hablada Image Fast a partir de mi imagen y audio. Obtenga primero una cotización y dígame los créditos. Espere mi confirmación antes de enviarla. Si no puede cargar mis archivos locales, proporcione los enlaces de carga del navegador". Mantenga habilitada la aprobación del cliente para las herramientas de gasto.

Subir archivos locales desde un agente

Hay dos rutas de archivos locales, además de la importación HTTPS. No pase una ruta local como import_asset URL.

• Si el cliente puede leer archivos y enviar solicitudes HTTP PUT, llama a create_asset_upload con kind, filename, content_type, size_bytes e idempotency_key. Sube los bytes del archivo a la URL recibida usando los encabezados indicados y llama a confirm_asset_upload. Nunca envíes tu API Key a una URL de almacenamiento firmada.
• Un cliente sin acceso a archivos locales/HTTP llama a create_asset_upload_session para cada imagen/vídeo/audio. Abres browser_upload_url, inicias sesión en la misma cuenta FreeLipSync y la cargas en el navegador. El agente retiene asset_id y sondea get_asset; no es necesario que vuelvas a copiar el documento de identidad. No comparta públicamente el ticket de carga.
• Para un archivo público HTTPS existente, import_asset con kind, url, idempotency_key comienza la importación. Espere hasta que esté listo antes de cotizar.

Un conector de nube/solo URL no obtiene acceso a sus archivos de escritorio simplemente usando MCP. Por ejemplo, los conectores remotos de Claude se ejecutan desde su nube, así que utilice los enlaces de carga del navegador cuando el cliente no pueda transferir su archivo adjunto al URL firmado.

Créditos, reintentos y gestión de conexiones.

API y MCP tienen las mismas tarifas: Video Lip Sync / Image Fast, 1 crédito/s; Image Max, 2; Image Super / Music Video, 3. La duración de audio verificada se redondea hacia arriba al segundo entero, con un mínimo de 5 segundos. estimate_generation devuelve total_points y un ID de presupuesto; create_generation recibe ese quote_id y una idempotency_key. Subir archivos, consultar el uso y obtener presupuestos no gasta créditos. Una generación aceptada no se puede cancelar; solo un fallo de procesamiento devuelve la reserva original. Consulta facturación y recuperación de la API.

Mantenga la misma cotización y clave de idempotencia después de un envío incierto. Guarde el ID del trabajo devuelto y consúltelo; No le pida al agente que "intente de nuevo" realizando otra tarea. Encuesta usando poll_after_seconds, retrocede en Retry-After y usa list_generations para consultar varios trabajos activos juntos. API y MCP comparten el depósito de lectura de cuenta, mientras que los tres puntos de entrada del sitio web/API/MCP comparten la frecuencia de envío y la capacidad de ejecución de video. El sitio web y API/MCP tienen asignaciones separadas para tareas pendientes: Free 1, Starter 3, Pro 10 en cada grupo. Todas las credenciales REST/MCP comparten el grupo API/MCP. Consulte por qué utilizar API/MCP para ver ejemplos.

Revocar una clave o conexión OAuth desde la consola Agent. Revocar una clave detiene su uso futuro en todos los clientes que la comparten, incluido REST; revocar una conexión OAuth afecta solo a esa conexión. Ninguna operación cancela las tareas ya aceptadas. La eliminación de una entrada de cliente local por sí sola no revoca una credencial en FreeLipSync. Utilice claves independientes o autorizaciones independientes cuando necesite una revocación independiente, para no aumentar la simultaneidad.

Solución de problemas

La configuración del cliente puede cambiar entre versiones. Consulte la documentación oficial vinculada de cada cliente para obtener las instrucciones actuales. ¿Necesita integración directa con HTTP? Lea la documentación API.