Google Flow Agent MCP Server by useapi.net

Agente de Google Flow: chat que planifica y crea videos Veo 3.1 e imágenes Nano Banana, aprobaciones, tu propio material. De terceros, de pago ($15/mes).

Ver en useapi.net

Servidor MCP alojado

npx add-mcp 'https://api.useapi.net/v1/google-flow/mcp'

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

Documentación

Saltar al contenido principal

Servidor MCP de Google Flow

16 de octubre de 2026

El servidor MCP de Google Flow de useapi.net permite que un asistente de IA como Claude Code, Cursor o VS Code Copilot trabaje con Google Flow Agent, el asistente creativo integrado en Google Flow, en tus propias cuentas de Google. Es un servidor Model Context Protocol alojado con 12 herramientas: chatear con el agente, adjuntar imágenes, un video, voces y personajes, responder a sus solicitudes de gastar créditos, leer, listar, renombrar y eliminar chats, configurar el modo de aprobación del proyecto, las instrucciones y los modelos predeterminados, listar los personajes, voces, imágenes y videos de la cuenta, y subir tus propias imágenes. Cada herramienta llama a la Agent API o a otro endpoint de la API de Google Flow, por lo que se aplican las mismas reglas y límites. No es necesario instalar ni alojar nada.

¿Existe un servidor MCP de Google Flow? Sí. useapi.net, un servicio de terceros no afiliado a Google, aloja uno en https://api.useapi.net/v1/google-flow/mcp con 12 herramientas para chatear con Google Flow Agent, en tu propia cuenta de Google, sin necesidad de instalar nada.

¿Prefieres REST? Guía: Google Flow Agent API · Demo: Agent Live Demo · Código: github.com/useapi/google-flow-api/demo

Consulta todos los servidores MCP de useapi.net en Model Matrix & MCP.

Endpoint y autorización

https://api.useapi.net/v1/google-flow/mcp

Transporte: HTTP transmisible.
Listado en el Registro oficial de MCP como net.useapi/google-flow, por lo que los clientes y directorios de MCP que lean el registro pueden encontrarlo por ese nombre.
Autorización: tu token de API de useapi.net en el encabezado Authorization: Bearer …, consulta Configuración de useapi.net.
Necesitas al menos una cuenta de Google añadida con Configuración de Google Flow, y un proveedor de captcha una vez que se agoten tus créditos de captcha gratuitos. Añadir y eliminar cuentas no está disponible a través de MCP: usa POST /accounts o la página de configuración.

Configuración

Reemplaza YOUR_API_TOKEN con tu token de API de useapi.net.

Claude Code

claude mcp add --transport http useapi-google-flow https://api.useapi.net/v1/google-flow/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor

En ~/.cursor/mcp.json:

{
  "mcpServers": {
    "useapi-google-flow": {
      "url": "https://api.useapi.net/v1/google-flow/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code

En .vscode/mcp.json:

{
  "servers": {
    "useapi-google-flow": {
      "type": "http",
      "url": "https://api.useapi.net/v1/google-flow/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Windsurf y otros clientes

Cualquier cliente que admita servidores MCP remotos a través de HTTP con encabezados personalizados funciona. La forma JSON habitual:

{
  "mcpServers": {
    "useapi-google-flow": {
      "serverUrl": "https://api.useapi.net/v1/google-flow/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Algunos clientes nombran el campo de dirección url en lugar de serverUrl.

Pruébalo con curl

curl -s https://api.useapi.net/v1/google-flow/mcp \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

curl -s https://api.useapi.net/v1/google-flow/mcp \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

La primera llamada responde con el nombre del servidor useapi-google-flow y sus instrucciones para el asistente, la segunda con las 12 herramientas.

Herramientas

Los chats se nombran por su chatId, que lleva su cuenta y proyecto, por lo que un seguimiento siempre se ejecuta donde vive el chat. Las herramientas que trabajan en una cuenta (flow_agent_list_chats, flow_agent_get_settings, flow_agent_update_settings, flow_list_characters, flow_list_voices, flow_list_assets, flow_upload_image) toman un email opcional, que se puede omitir cuando el token de API tiene una cuenta de Google Flow.

Chat

Herramienta	Qué hace	Parámetros principales
`flow_agent_chat`	Envía un mensaje al agente y devuelve su respuesta: el `chatId` del chat, el `status` del turno (`completed`, `waiting_approval`, `failed` o `running`), el texto del agente, sus llamadas a herramientas, los medios que creó con `referenceId` y el enlace, y una solicitud pendiente para gastar créditos. Sin `chatId` inicia un nuevo chat, en `email`, en la cuenta de las referencias, o en una cuenta que la API elija. Nombra las referencias en el mensaje como `@referenceImage_1`, `@referenceVideo_1`, `@referenceAudio_1` o `@character_1`. Encuéntralas con las herramientas bajo Tus personajes, voces y medios. Deben pertenecer a la cuenta del chat.	`message`, `chatId`, `email`, `projectId`, `referenceImage_1`..`7`, `referenceVideo_1`, `referenceAudio_1`..`5`, `character_1`..`7`
`flow_agent_get_chat`	Lee un chat: su estado, solicitud pendiente, último error y últimos turnos con estado de medios y enlaces. Con `wait: true` sigue el turno en ejecución y devuelve el resto, después del `lastEventId` de un resultado anterior.	`chatId`, `wait`, `after`, `media`, `limit`
`flow_agent_answer_approval`	Responde a la solicitud del agente de gastar créditos con `approve`, `always` (aprobar y cambiar el proyecto a `auto`) o `reject`, luego sigue al agente como `flow_agent_chat`.	`chatId`, `decision`, `wait`
`flow_agent_list_chats`	Lista los chats del agente de la cuenta con título, fechas y si un turno está en ejecución, incluidos los chats iniciados en la aplicación web de Flow en el mismo proyecto.	`email`, `projectId`
`flow_agent_rename_chat`	Renombra un chat, también en la aplicación web de Flow.	`chatId`, `title`
`flow_agent_delete_chat`	Elimina el historial de un chat. Las imágenes y videos que creó permanecen en el proyecto.	`chatId`

Los parámetros coinciden con POST /agent/chats, POST /agent/chats/chatId/messages, POST /agent/chats/chatId/approval y GET /agent/chats/chatId.

Configuración

Herramienta	Qué hace	Parámetros principales
`flow_agent_get_settings`	Lee el modo de aprobación del proyecto (`ask` o `auto`), sus instrucciones y el modelo de imagen y video predeterminado, la relación de aspecto y el recuento, y lista los modelos de imagen y video que tiene el plan de Google de la cuenta con lo que cuesta una generación.	`email`, `projectId`
`flow_agent_update_settings`	Los cambia. `instructions` reemplaza la lista completa de hasta 3. Un `model` predeterminado es cualquier modelo que `flow_agent_get_settings` liste para la cuenta.	`email`, `projectId`, `approval`, `instructions`, `imageDefaults`, `videoDefaults`

Los parámetros coinciden con PUT /agent/settings.

Tus personajes, voces y medios

Herramienta	Qué hace	Parámetros principales
`flow_list_characters`	Lista los personajes guardados en la cuenta con su nombre, voz e id de `character`, para pasarlos como `character_N`.	`email`
`flow_list_voices`	Lista las 30 voces integradas por nombre y las voces propias de la cuenta con sus ids, para pasarlas como `referenceAudio_N`.	`email`, `source`
`flow_list_assets`	Lista las imágenes y videos de un proyecto, los más recientes primero, con un `referenceId` para `referenceImage_N` o `referenceVideo_1` y si cada uno es una subida. Sin `projectId` lista el proyecto principal de la cuenta. Cada proyecto incluye las subidas de la cuenta. Pasa el id del proyecto del agente desde `flow_agent_get_settings` para ver lo que creó el agente. Devuelve 50 por defecto, hasta 200 por llamada.	`email`, `projectId`, `type`, `uploadsOnly`, `limit`
`flow_upload_image`	Sube tu propia imagen JPEG, PNG o WebP desde una URL https pública, o enviada como `contentBase64`, hasta 20 MB, y devuelve su `referenceId` para `referenceImage_N`. Súbela a la cuenta con la que chateas. Las subidas permanecen en la cuenta de Google hasta que se eliminen.	`url` o `contentBase64`, `mimeType`, `email`

Los parámetros coinciden con GET /characters, GET /voices, GET /assets/media/email y POST /assets/email.

El esquema de entrada completo de cada herramienta proviene de tools/list.

Trabajo de larga duración

Los clientes de MCP generalmente abandonan una llamada de herramienta después de aproximadamente un minuto, por lo que una herramienta espera hasta unos 50 segundos:

El envío espera a que Google acepte el turno, generalmente de 3 a 40 segundos. Si Google no lo ha confirmado dentro de 55 segundos, la herramienta lo dice y le indica al asistente que verifique el chat antes de enviar nuevamente.
La herramienta luego sigue al agente durante el tiempo restante. Una respuesta corta, una imagen o una solicitud para gastar créditos generalmente regresan en ese tiempo.
Un turno que aún está trabajando devuelve status: "running" y un lastEventId. flow_agent_get_chat con wait: true y after establecidos en ese lastEventId devuelve el resto. Pide al asistente que siga verificando hasta que termine.
Los videos terminan uno o dos minutos después del turno. flow_agent_get_chat sin wait muestra su estado y enlace.

Los clientes que solicitan notificaciones de progreso reciben una aproximadamente cada 10 segundos mientras una herramienta espera.

Los enlaces de medios son de Google y caducan aproximadamente 6 horas después de emitirse. Lee el chat nuevamente para obtener enlaces nuevos. El referenceId de un elemento de medios puede ir en un mensaje posterior como referenceImage_N o referenceVideo_1.

Aprobaciones y créditos

Chatear con el agente no cuesta créditos de Flow. Las imágenes y videos que crea cuestan el precio habitual de Flow. En el modo de aprobación ask, el agente se detiene antes de gastar créditos y dice cuánto cuesta, y el resultado de la herramienta le indica al asistente que te pregunte antes de responder con flow_agent_answer_approval. always, o approval: "auto" con flow_agent_update_settings, permite que el agente gaste sin preguntar en cada chat del proyecto.

Ejemplos de indicaciones

"Sube https://example.com/photo.jpg a mi cuenta de Flow y pide al agente que lo describa."
"Pide al agente de Flow tres ideas para un anuncio de café de 30 segundos, luego haz la primera como un guion gráfico de cuatro imágenes."
"Haz un video de 8 segundos de Veo 3.1 Lite de un barco de papel flotando en un estanque tranquilo. Muéstrame el costo antes de que lo apruebes."
"Envía mi personaje y esta imagen de producto al agente de Flow y pide un video corto de ella sosteniéndolo, con la voz Aoede."
"¿Está listo el video de mi último chat de Flow? Dame el enlace."
"Lista mis chats del agente de Flow y elimina los que traten sobre el faro."
"Configura el agente de Flow para usar Nano Banana Pro en 9:16 por defecto, y añade una instrucción para mantener cada respuesta breve."

Límites y notas

Las herramientas usan tus cuentas de Google y las mismas reglas que la API REST: un turno a la vez por chat, como máximo 3 turnos en ejecución por cuenta, y el límite diario de Google en mensajes del agente. Consulta Límites.
Cada turno usa un captcha, igual que una solicitud de generación.
Las referencias en un chat deben pertenecer a la cuenta del chat. Sube imágenes con flow_upload_image a esa cuenta.
flow_list_assets devuelve hasta 200 elementos por llamada, y un proyecto grande puede tardar 20 segundos o más en leerse. Una nueva subida puede tardar un momento en aparecer en la lista.
Los conectores personalizados en claude.ai necesitan inicio de sesión OAuth, que este servidor aún no admite. Usa Claude Code u otro cliente que pueda enviar un encabezado Authorization.
Un cliente puede enviar hasta 20 solicitudes JSON-RPC en un lote.
Si el cliente envía un encabezado MCP-Protocol-Version, debe ser una de las versiones admitidas: 2025-06-18, 2025-03-26 o 2024-11-05.
Cada llamada de herramienta aparece en tus estadísticas de uso ( bot=google-flow) como modelo mcp, con el nombre de la herramienta como su estado, o failed.

Tutoriales para la Google Flow API v1:

{ "@context": "https://schema.org", "@type": "APIReference", "name": "Google Flow MCP Server: Chat with Google Flow Agent in Claude Code", "url": "https://useapi.net/docs/api-google-flow-v1/mcp", "inLanguage": "en", "isAccessibleForFree": true, "description": "Connect Claude Code, Cursor, VS Code or any MCP client to the hosted useapi.net Google Flow MCP server: 12 tools to chat with Google Flow Agent, approve spending, manage chats and upload images.", "about": "Google Flow API v1", "isPartOf": { "@type": "APIReference", "name": "Google Flow API v1" }, "publisher": { "@type": "Organization", "name": "useapi.net", "url": "https://useapi.net", "logo": { "@type": "ImageObject", "url": "https://useapi.net/assets/brand/useapi-logo-512.png" }, "alternateName": ["useapi", "UseAPI"], "sameAs": ["https://discord.gg/w28uK3cnmF", "https://t.me/use_api", "https://github.com/useapi", "https://bsky.app/profile/useapi.net", "https://www.youtube.com/@useapi-net"] }, "documentationOf": { "@type": "WebAPI", "name": "useapi.net REST API", "documentation": "https://useapi.net/llms.txt", "termsOfService": "https://useapi.net/docs/legal" } }
{ "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://useapi.net/" }, { "@type": "ListItem", "position": 2, "name": "Google Flow API v1", "item": "https://useapi.net/docs/api-google-flow-v1" }, { "@type": "ListItem", "position": 3, "name": "MCP Server", "item": "https://useapi.net/docs/api-google-flow-v1/mcp" } ] }