FlowData

Como conectar agentes de IA ao FlowData?

Publicado em 10. novembro 2026

Com o MCP, agentes de IA como Claude ou ChatGPT podem usar diretamente os serviços do FlowData da sua equipe, por exemplo para buscar um endereço ou verificar um e-mail. O endereço do servidor é:

https://mcp.flowconnect.one/flowdata

Informe exatamente assim, sem barra no final. O FlowData tem endereço próprio e não faz parte do pacote FlowConnect em mcp.flowconnect.one. Para conectar, você precisa ter acesso ao FlowData na sua equipe.

Conectar com login (claude.ai, ChatGPT)

O claude.ai e o ChatGPT são conectados sem chave:

  1. Adicione um conector próprio no claude.ai ou no ChatGPT.
  2. Informe o endereço acima.
  3. Entre com sua conta, escolha a equipe e confirme a conexão.

Depois, a conexão aparece no FlowConnect em Desenvolvedores › MCP, com a marcação Conectado por login, e pode ser desconectada ali.

Conectar com chave (Claude Code, Cursor e outros)

Clientes que aceitam uma chave usam uma chave MCP. Chaves do FlowData iniciadas por fd_ não funcionam aqui.

  1. No FlowConnect, abra Desenvolvedores › MCP e crie uma nova chave.
  2. Dê um nome a ela e marque FlowData em Servidores.
  3. Copie a chave na hora. Ela só é exibida uma vez.
  4. Informe o endereço e a chave no seu cliente:
{
  "mcpServers": {
    "flowdata": {
      "type": "http",
      "url": "https://mcp.flowconnect.one/flowdata",
      "headers": { "Authorization": "Bearer mcp_SUA_CHAVE" }
    }
  }
}

Mais sobre o gerenciamento, como revogar chaves, está no artigo do FlowConnect sobre chaves de API e MCP.

O que o agente pode fazer

Área Ferramenta Tarefa
IP Geolocation flowdata_geolocation Dados de localização de um endereço IP ou domínio
Client Info flowdata_client_info Navegador, dispositivo e idiomas do cliente que faz a chamada
Maps flowdata_maps_search Buscar endereços e lugares
Maps flowdata_maps_geocode Converter um endereço em coordenadas ou o contrário
Maps flowdata_maps_directions Calcular uma rota entre dois pontos
Email Verifier flowdata_email_verification Verificar um endereço de e-mail
YouTube flowdata_youtube_stats Consultar estatísticas de canais
Mídia flowdata_media_create_job Criar um trabalho de mídia
Mídia flowdata_media_job_status Consultar o status e os links de download de um trabalho

No Client Info, o cliente que faz a chamada é o cliente MCP, e não o seu cliente final.

No processamento de mídia, o agente só pode criar trabalhos e consultar o status deles. A origem precisa ser uma URL https acessível publicamente, e uploads diretos e destinos de armazenamento próprios não são possíveis. Cada saída é guardada pelo FlowData e excluída após sete dias. As saídas prontas têm um link de download temporário.

Custos e responsabilidade

Cada chamada é uma requisição normal, cobrada da conta FlowData da sua equipe. A descrição de cada ferramenta paga informa ao agente o preço de tabela, e seus preços reais estão em Cobrança. Como na API, erros, uma busca no Maps sem resultados e o resultado de e-mail unknown não são cobrados, veja Como são calculados os preços do FlowData?.

Você é responsável por tudo o que o seu agente faz no FlowData. Os pontos principais são:

  • Defina um limite de gastos para que um agente não gaste mais do que você deseja.
  • Chamar flowdata_media_create_job de novo cria um segundo trabalho. Inicie trabalhos de mídia só por pedido explícito.
  • Se o crédito ou o limite não cobrirem uma chamada, o FlowData a recusa, com HTTP 402 nas áreas de dados e HTTP 429 em mídia.

Ao conectar agentes de IA, valem também os termos do respectivo fornecedor.

Este artigo foi útil?

Voltar para Playground e agentes de IA