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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/mcp-servers/mcp-servers-servidores.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.