Skip to content
Floopy floopy / Blog

Floopy Suporta MCP: Conecte Ferramentas de IA ao Seu Gateway

Floopy agora suporta Model Context Protocol — exponha seu gateway como servidor MCP ou conecte ferramentas externas aos seus workflows.

Floopy Team | | 4 min de leitura
mcp ai-gateway agentic-loop tool-calling product

O Model Context Protocol esta se tornando o padrao para clientes de IA descobrirem e chamarem ferramentas. Hoje adicionamos suporte MCP ao Floopy — tanto como servidor quanto como cliente.

O Que Isso Significa para Voce

O Floopy agora fala MCP nas duas direcoes:

Como servidor MCP: Aponte o Claude Desktop, Cursor ou qualquer cliente compativel com MCP para https://api.floopy.ai/mcp. Eles recebem quatro ferramentas: rotear requisicoes LLM, listar modelos, estimar custos e consultar analytics — tudo com suas regras de roteamento, cache e rate limits aplicados automaticamente.

Como cliente MCP: Vincule um plugin YAML a qualquer regra de roteamento e o Floopy se conectara a servidores MCP externos em nome do seu agente. O LLM chama uma ferramenta, o Floopy a executa, adiciona o resultado e volta ao modelo. Voce tem um agent loop completo sem precisar construir a infraestrutura.

O Agent Loop Sem a Infraestrutura

Construir um agent loop confiavel e surpreendentemente dificil:

  • Logica de retry para servidores de ferramentas instavaeis
  • Gerenciamento de segredos para APIs de terceiros
  • Protecao contra injecao de prompt nas saidas das ferramentas
  • Execucao paralela de ferramentas
  • Registro de cada chamada de ferramenta para depuracao
  • Timeouts que nao travam toda a aplicacao

O Floopy cuida de tudo isso. Voce escreve um arquivo YAML descrevendo quais servidores MCP conectar e como. O gateway faz o resto.

version: "1"


mcp_servers:
  - id: pesquisa_web
    url: "https://mcp.brave.com/search"
    auth:
      type: bearer
      secret_ref: "secret.brave_api_key"     # armazenado no Floopy Vault
    timeout_ms: 5000


agent:
  max_rounds: 8
  stream_mode: final_only
  prompt_guard_on_tool_output: true

Isso e uma configuracao agentica pronta para producao. Nenhum codigo de infraestrutura necessario.

Quatro Ferramentas MCP Prontas para Usar

Ao conectar como cliente MCP ao servidor do Floopy, voce obtem quatro ferramentas imediatamente:

route_llm_request

Envie completions pelo seu gateway. Suas regras de roteamento, fallbacks, cache e roteamento de custos sao aplicados — exatamente como seriam da sua aplicacao.

list_models

Consulte quais modelos estao disponiveis na sua conta, com capacidades e precos. Util para agentes que selecionam modelos dinamicamente.

estimate_cost

Antes de enviar uma requisicao grande, pergunte ao Floopy quanto vai custar — e obtenha sugestoes de alternativas mais baratas. Agentes conscientes de orcamento podem usar isso para decidir qual modelo utilizar.

get_analytics

Busque dados de uso para um intervalo de tempo, agrupados por modelo, provider ou API key. Util para agentes de monitoramento ou automacao que acompanham gastos.

Controle de Acesso por Token para MCP

Compartilhar sua API key principal com cada cliente MCP e arriscado. Uma nova funcionalidade acompanha o suporte MCP: os Tokens MCP.

Tokens MCP sao de curta duracao e com escopo definido. Em vez de dar ao Claude Desktop sua API key completa, voce emite um token com apenas o escopo mcp:tools:call e validade de 30 dias. Se for comprometido, voce o revoga com um clique — sem necessidade de rotacao de chaves em todos os seus apps.

Configuracoes → Tokens de Acesso → Novo Token
Selecione escopos: mcp:tools:call, mcp:models:list
Expiracao: 30 dias

Seguranca: Prompt Guard nas Saidas das Ferramentas

Um vetor de ataque sutil em sistemas com agent loop: uma pagina web maliciosa ou resposta de API contem uma injecao de prompt que sequestra o comportamento do seu agente.

O Prompt Guard ja existente do Floopy agora e executado nas saidas das ferramentas antes de serem adicionadas a conversa. Se o resultado de uma ferramenta parecer uma tentativa de jailbreak ou payload de injecao, ele e sinalizado — e voce pode configurar se deseja bloquear ou apenas registrar.

Ative no seu plugin YAML:

agent:
  prompt_guard_on_tool_output: true

O Que e Registrado

Cada sessao agentica e registrada completamente em Observabilidade:

  • Cada chamada de ferramenta: nome, argumentos, duracao, servidor utilizado
  • Cada resultado de ferramenta (com segredos reduzidos)
  • Total de rodadas e tokens em toda a sessao
  • Se o loop atingiu max_rounds

Voce pode filtrar por has_tool_calls: true para isolar o trafego do agent loop das completions padrao.

Comecando

Use o Floopy como servidor MCP pelo Claude Desktop:

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "floopy": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.floopy.ai/mcp",
        "--header",
        "Authorization: Bearer mcp_tbac_seu_token_aqui"
      ]
    }
  }
}

Requer Node.js 18+. Para Claude Code CLI, use claude mcp add floopy --transport http --url https://api.floopy.ai/mcp --header "Authorization: Bearer <token>".

Construa um workflow com agent loop com ferramentas MCP externas:

  1. Va ate Routing no dashboard
  2. Crie uma regra de roteamento
  3. Vincule um plugin YAML com a configuracao do servidor MCP
  4. Armazene seus segredos em Configuracoes > Segredos
  5. Teste no Playground

Documentacao completa: MCP Server · MCP Client · Tokens MCP