Por meio de MCP, um agente de IA como Claude ou ChatGPT pode ler sua conta do FlowModels, por exemplo para comparar modelos ou resumir o consumo. MCP significa Model Context Protocol, um padrão aberto pelo qual agentes de IA usam ferramentas.
O servidor é somente leitura. Por meio dele, o agente não pode chamar modelos nem alterar nada.
O endereço
O endereço é o mesmo para todos os clientes:
https://mcp.flowconnect.one/flowmodels
Use exatamente assim, sem barra no final.
Conectar
Informe o endereço no seu cliente MCP e faça login. Há dois caminhos:
- Login (OAuth): seu cliente leva você ao login no FlowConnect, onde você confirma sua equipe.
- Chave MCP: você cria uma chave no FlowConnect e a informa no seu cliente como token Bearer.
As chaves MCP do FlowModels são criadas de forma centralizada no FlowConnect, o FlowModels não tem mais uma página própria para isso:
- No FlowConnect, abra Desenvolvedores › MCP e crie uma nova chave.
- Dê um nome a ela e marque FlowModels em Servidores.
- Copie a chave na hora. Ela só é exibida uma vez.
- Informe o endereço e a chave no seu cliente:
{
"mcpServers": {
"flowmodels": {
"type": "http",
"url": "https://mcp.flowconnect.one/flowmodels",
"headers": { "Authorization": "Bearer mcp_SUA_CHAVE" }
}
}
}
Para a conexão, você precisa ter acesso ao FlowModels na sua equipe, senão o FlowConnect não oferece o servidor. Conexões feitas por login também aparecem em Desenvolvedores › MCP e podem ser desconectadas ali. Mais sobre o gerenciamento, como revogar chaves, está em Chaves de API e MCP.
As ferramentas
| Ferramenta | O que retorna |
|---|---|
flowmodels_models |
todos os modelos que sua equipe pode usar, com filtro opcional por provedor, tipo ou capacidade |
flowmodels_prices |
os preços da sua equipe em euros por 1 milhão de tokens, nos modelos de áudio por minuto, com data |
flowmodels_usage |
consumo por dia ou por modelo, com requisições, tokens e custos em euros |
flowmodels_balance |
saldo disponível e reservado e quanto você ainda pode gastar no total |
O agente sempre lê apenas a conta da equipe à qual a chave ou o login pertence. Um período de flowmodels_usage abrange no máximo 90 dias por chamada.
O que o servidor não faz
- Chamar modelos, criar chaves ou recarregar saldo
- Exibir conteúdo de requisições ou chaves e usuários finais individuais
Para chamadas de modelo, sua aplicação continua usando a API em https://api.flowmodels.one/v1 com uma chave de Chaves de API.
Quando algo não funciona
- O cliente não encontra ferramentas: verifique se o endereço está exatamente correto.
- O login falha: seu usuário precisa ter acesso ao FlowModels na equipe escolhida, veja Dar acesso ao FlowModels para colegas.