Ctrlk

MCP Servers - Servidores

📍 Como configurar um Servidor MCP na Hyperflow

🚀 Passo 1 – Criar um novo Servidor MCP

  1. Acesse o menu lateral.

  2. Vá até MCP Servers > Servidores.

  3. Clique em + Adicionar Servidor MCP.

  4. Informe:

    • Nome do Servidor (obrigatório)

    • Descrição (recomendado para identificar a finalidade)

  5. Clique em Criar Servidor.

Após a criação, você poderá configurar ferramentas, clientes e segurança.

Imagem 1 - Criando o servidor MCP.

⚙️ Passo 2 – Configurações Gerais

Na aba Geral, você encontrará:

🔗 URL do Servidor A plataforma gera automaticamente a URL pública do seu servidor MCP. Exemplo: https://runtime.hyperflowapis.global/mcp/{host_id}

🔐 Métodos de Autenticação Suportados A Hyperflow permite múltiplas formas de autenticação quando a opção Requerer Autenticação estiver habilitada:

  • a) Autenticação Básica HTTP: Authorization: Basic base64(clientId:clientSecret)

  • b) Token Bearer: Authorization: Bearer base64(clientId:clientSecret)

  • c) Cabeçalhos customizados: x-api-key, token, api_key.

  • d) Parâmetros via Query: ?token=... ou ?client_id=...&client_secret=...

Imagem 2 - Configurações gerais e métodos de autenticação ao editar um server MCP.

🛠️ Passo 3 – Selecionar as Ferramentas Disponíveis

  1. Acesse a aba Ferramentas.

  2. Visualize a lista de ferramentas disponíveis.

  3. Selecione quais estarão expostas neste servidor MCP.

  4. Clique em Salvar.

Exemplos de ferramentas: consulta_cep, buscar_cards_kanbanize, cadastrar_lead.

Imagem 3 - Seleção de ferramentas(tools) para ficarem disponíveis nesse server MCP.

👥 Passo 4 – Criar e Gerenciar Clientes

  1. Acesse a aba Clientes.

  2. Clique em + Adicionar Cliente.

  3. Informe Nome, Descrição e Propriedades (JSON).

  4. Ao salvar, o Client ID e o Client Secret serão gerados automaticamente.

Imagem 4 - Criação de clientes com geração de client id e secret automaticas pela Hyperflow.

🛡️ Passo 5 – Configurações de Segurança

Acesse a aba Segurança:

  1. 1️⃣ Requerer Autenticação: Quando ativado, todas as requisições precisam de credenciais.

  2. 2️⃣ Restrição de IP: Limita o acesso apenas a IPs específicos da sua infraestrutura.

  3. 3️⃣ Limitação de Taxa (Rate Limit): Define o número máximo de requisições por período para evitar abusos.

Imagem 5 - Configuração de controle de acessos e limitação de requisições.

✅ Fluxo Completo de Configuração

  1. Criar o servidor MCP.

  2. Definir as ferramentas.

  3. Criar clientes e obter credenciais.

  4. Configurar método de autenticação.

  5. Aplicar regras de segurança.

  6. Integrar a URL ao assistente de IA.

💡 Boas Práticas

  • 🌟 Utilize servidores diferentes para produção e homologação.

  • 📂 Separe servidores por domínio funcional (ex: consultas vs. operações críticas).

  • 🔒 Sempre ative a autenticação.

  • 🚫 Nunca compartilhe o Client Secret em código frontend.

Last updated