> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/mcp-servers/mcp-servers-servidores.md).

# 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.

<figure><img src="/files/AEZfZDNa6TBKwDd513b1" alt=""><figcaption><p>Imagem 1 - Criando o servidor MCP.</p></figcaption></figure>

***

#### ⚙️ 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=...`

<figure><img src="/files/BnUT5Rxbdlv6QoLmCCWJ" alt=""><figcaption><p>Imagem 2 - Configurações gerais e métodos de autenticação ao editar um server MCP.</p></figcaption></figure>

***

#### 🛠️ 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`.*

<figure><img src="/files/ok31UZUgG4vGshvbaSfo" alt=""><figcaption><p>Imagem 3 - Seleção de ferramentas(tools) para ficarem disponíveis nesse server MCP.</p></figcaption></figure>

***

#### 👥 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.

<figure><img src="/files/SuC8Lxl9twXeWJoCKQJ9" alt=""><figcaption><p>Imagem 4 - Criação de clientes com geração de client id e secret automaticas pela Hyperflow.</p></figcaption></figure>

***

#### 🛡️ 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.

<figure><img src="/files/FMuOlHgFoGUJ6Gip7dTj" alt=""><figcaption><p>Imagem 5 - Configuração de controle de acessos e limitação de requisições.</p></figcaption></figure>

***

#### ✅ 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.