Google Flow Agent MCP Server by useapi.net

Agente Google Flow: chat que planeja e cria vídeos Veo 3.1 e imagens Nano Banana, aprovações, sua própria mídia. De terceiros, pago (US$ 15/mês).

Ver em useapi.net

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Google Flow MCP Server

16 de outubro de 2026

O servidor MCP Google Flow da useapi.net permite que um assistente de IA, como Claude Code, Cursor ou VS Code Copilot, trabalhe com o Google Flow Agent, o assistente criativo integrado ao Google Flow, nas suas próprias contas do Google. É um servidor Model Context Protocol hospedado com 12 ferramentas: conversar com o agente, anexar imagens, um vídeo, vozes e personagens, responder aos pedidos dele para gastar créditos, ler, listar, renomear e excluir conversas, definir o modo de aprovação do projeto, instruções e modelos padrão, listar os personagens, vozes, imagens e vídeos da conta e enviar suas próprias imagens. Cada ferramenta chama a Agent API ou outro endpoint da API do Google Flow, portanto as mesmas regras e limites se aplicam. Nada precisa ser instalado ou hospedado.

Existe um servidor MCP do Google Flow? Sim. A useapi.net, um serviço de terceiros não afiliado ao Google, hospeda um em https://api.useapi.net/v1/google-flow/mcp com 12 ferramentas para conversar com o Google Flow Agent, na sua própria conta do Google, sem precisar instalar nada.

Prefere REST? Guia: Google Flow Agent API · Demonstração: Agent Live Demo · Código: github.com/useapi/google-flow-api/demo

Veja todos os servidores MCP da useapi.net em Model Matrix & MCP.

Endpoint e autorização

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

Transporte: HTTP Streamable.
Listado no registro oficial de MCP como net.useapi/google-flow, para que clientes e diretórios MCP que leiam o registro possam encontrá-lo por esse nome.
Autorização: seu token de API da useapi.net no cabeçalho Authorization: Bearer …, consulte Configuração useapi.net.
Você precisa de pelo menos uma conta do Google adicionada com Configuração Google Flow e de um provedor de captcha quando seus créditos gratuitos de captcha acabarem. Adicionar e remover contas não está disponível via MCP: use POST /accounts ou a página de configuração.

Configuração

Substitua YOUR_API_TOKEN pelo seu token de API da 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

Em ~/.cursor/mcp.json:

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

VS Code

Em .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 e outros clientes

Qualquer cliente que suporte servidores MCP remotos via HTTP com cabeçalhos personalizados funciona. O formato JSON usual:

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

Alguns clientes nomeiam o campo de endereço como url em vez de serverUrl.

Teste com 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"}'

A primeira chamada responde com o nome do servidor useapi-google-flow e suas instruções para o assistente; a segunda, com as 12 ferramentas.

Ferramentas

As conversas são nomeadas pelo seu chatId, que carrega sua conta e projeto, então um acompanhamento sempre roda onde a conversa está. As ferramentas que operam em uma conta (flow_agent_list_chats, flow_agent_get_settings, flow_agent_update_settings, flow_list_characters, flow_list_voices, flow_list_assets, flow_upload_image) aceitam um email opcional, que pode ser omitido quando o token de API tem uma conta do Google Flow.

Conversa

Ferramenta	O que faz	Principais parâmetros
`flow_agent_chat`	Envia uma mensagem ao agente e retorna a resposta: o `chatId` da conversa, o `status` do turno (`completed`, `waiting_approval`, `failed` ou `running`), o texto do agente, suas chamadas de ferramenta, a mídia que ele criou com `referenceId` e link, e um pedido pendente para gastar créditos. Sem `chatId`, inicia uma nova conversa, em `email`, na conta das referências ou em uma conta que a API escolher. Nomeie referências na mensagem como `@referenceImage_1`, `@referenceVideo_1`, `@referenceAudio_1` ou `@character_1`. Encontre-as com as ferramentas em Seus personagens, vozes e mídia. Elas devem pertencer à conta da conversa.	`message`, `chatId`, `email`, `projectId`, `referenceImage_1`..`7`, `referenceVideo_1`, `referenceAudio_1`..`5`, `character_1`..`7`
`flow_agent_get_chat`	Lê uma conversa: status, pedido pendente, último erro e turnos mais recentes com status e links de mídia. Com `wait: true`, acompanha o turno em execução e retorna o restante, após o `lastEventId` de um resultado anterior.	`chatId`, `wait`, `after`, `media`, `limit`
`flow_agent_answer_approval`	Responde ao pedido do agente para gastar créditos com `approve`, `always` (aprovar e mudar o projeto para `auto`) ou `reject`, e então acompanha o agente como `flow_agent_chat`.	`chatId`, `decision`, `wait`
`flow_agent_list_chats`	Lista as conversas do agente da conta com título, datas e se um turno está em execução, incluindo conversas iniciadas no app web do Flow no mesmo projeto.	`email`, `projectId`
`flow_agent_rename_chat`	Renomeia uma conversa, também no app web do Flow.	`chatId`, `title`
`flow_agent_delete_chat`	Exclui o histórico de uma conversa. As imagens e vídeos que ela criou permanecem no projeto.	`chatId`

Os parâmetros correspondem a POST /agent/chats, POST /agent/chats/chatId/messages, POST /agent/chats/chatId/approval e GET /agent/chats/chatId.

Configurações

Ferramenta	O que faz	Principais parâmetros
`flow_agent_get_settings`	Lê o modo de aprovação do projeto (`ask` ou `auto`), suas instruções e o modelo padrão de imagem e vídeo, proporção de aspecto e quantidade, e lista os modelos de imagem e vídeo que o plano Google da conta tem, com o custo de uma geração.	`email`, `projectId`
`flow_agent_update_settings`	Altera essas configurações. `instructions` substitui a lista inteira de até 3. Um `model` padrão é qualquer modelo que `flow_agent_get_settings` liste para a conta.	`email`, `projectId`, `approval`, `instructions`, `imageDefaults`, `videoDefaults`

Os parâmetros correspondem a PUT /agent/settings.

Seus personagens, vozes e mídia

Ferramenta	O que faz	Principais parâmetros
`flow_list_characters`	Lista os personagens salvos na conta com nome, voz e id `character`, para passar como `character_N`.	`email`
`flow_list_voices`	Lista as 30 vozes integradas por nome e as vozes próprias da conta com seus ids, para passar como `referenceAudio_N`.	`email`, `source`
`flow_list_assets`	Lista as imagens e vídeos de um projeto, do mais recente ao mais antigo, com um `referenceId` para `referenceImage_N` ou `referenceVideo_1` e se cada um é um upload. Sem `projectId`, lista o projeto principal da conta. Todo projeto inclui os uploads da conta. Passe o id do projeto do agente de `flow_agent_get_settings` para ver o que o agente criou. Retorna 50 por padrão, até 200 por chamada.	`email`, `projectId`, `type`, `uploadsOnly`, `limit`
`flow_upload_image`	Envia sua própria imagem JPEG, PNG ou WebP a partir de uma URL https pública, ou enviada como `contentBase64`, até 20 MB, e retorna seu `referenceId` para `referenceImage_N`. Envie para a conta com a qual você conversa. Os uploads permanecem na conta do Google até serem excluídos.	`url` ou `contentBase64`, `mimeType`, `email`

Os parâmetros correspondem a GET /characters, GET /voices, GET /assets/media/email e POST /assets/email.

O esquema completo de entrada de cada ferramenta vem de tools/list.

Trabalhos de longa duração

Clientes MCP geralmente desistem de uma chamada de ferramenta após cerca de um minuto, então uma ferramenta espera até cerca de 50 segundos:

O envio espera o Google aceitar o turno, geralmente de 3 a 40 segundos. Se o Google não confirmar em 55 segundos, a ferramenta informa isso e diz ao assistente para verificar a conversa antes de enviar novamente.
A ferramenta então acompanha o agente pelo tempo restante. Uma resposta curta, uma imagem ou um pedido para gastar créditos geralmente retorna nesse período.
Um turno que ainda está trabalhando retorna status: "running" e um lastEventId. flow_agent_get_chat com wait: true e after definidos para esse lastEventId retorna o restante. Peça ao assistente para continuar verificando até concluir.
Os vídeos terminam um ou dois minutos após o turno. flow_agent_get_chat sem wait mostra o status e o link deles.

Clientes que pedem notificações de progresso recebem uma a cada 10 segundos enquanto uma ferramenta espera.

Os links de mídia são do Google e expiram cerca de 6 horas após serem emitidos. Leia a conversa novamente para obter links novos. O referenceId de um item de mídia pode ir para uma mensagem posterior como referenceImage_N ou referenceVideo_1.

Aprovações e créditos

Conversar com o agente não custa créditos do Flow. As imagens e vídeos que ele cria custam o preço usual do Flow. No modo de aprovação ask, o agente para antes de gastar créditos e informa o custo, e o resultado da ferramenta diz ao assistente para perguntar a você antes de responder com flow_agent_answer_approval. always, ou approval: "auto" com flow_agent_update_settings, permite que o agente gaste sem perguntar em todas as conversas do projeto.

Exemplos de prompts

"Envie https://example.com/photo.jpg para minha conta do Flow e peça ao agente para descrevê-la."
"Peça ao agente do Flow três ideias para um anúncio de café de 30 segundos e depois transforme a primeira em um storyboard de quatro imagens."
"Crie um vídeo de 8 segundos em Veo 3.1 Lite de um barquinho de papel flutuando em um lago calmo. Mostre-me o custo antes de aprovar."
"Envie meu personagem e esta imagem de produto ao agente do Flow e peça um vídeo curto dela segurando o item, na voz Aoede."
"O vídeo da minha última conversa no Flow está pronto? Me dê o link."
"Liste minhas conversas do agente do Flow e exclua as que falam sobre o farol."
"Configure o agente do Flow para usar Nano Banana Pro em 9:16 por padrão e adicione uma instrução para manter todas as respostas curtas."

Limites e observações

As ferramentas usam suas contas do Google e as mesmas regras da API REST: um turno por vez por conversa, no máximo 3 turnos em execução por conta e o limite diário do Google para mensagens do agente. Consulte Limites.
Cada turno usa um captcha, igual a uma solicitação de geração.
As referências em uma conversa devem pertencer à conta da conversa. Envie imagens com flow_upload_image para essa conta.
flow_list_assets retorna até 200 itens por chamada, e um projeto grande pode levar 20 segundos ou mais para ser lido. Um novo upload pode demorar um pouco para aparecer na lista.
Conectores personalizados no claude.ai exigem login OAuth, que este servidor ainda não suporta. Use Claude Code ou outro cliente que possa enviar um cabeçalho Authorization.
Um cliente pode enviar até 20 solicitações JSON-RPC em um único lote.
Se o cliente enviar um cabeçalho MCP-Protocol-Version, ele deve ser uma das versões suportadas: 2025-06-18, 2025-03-26 ou 2024-11-05.
Cada chamada de ferramenta aparece nas suas estatísticas de uso ( bot=google-flow) como modelo mcp, com o nome da ferramenta como status, ou failed.

Tutoriais para a 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" } ] }