> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/cadastrando-o-model-context-protocol-mcp.md).
# Cadastrando o Model Context Protocol (MCP)
O **Model Context Protocol (MCP)** é um padrão aberto de comunicação que funciona como uma API universal de contexto para Inteligência Artificial. Ele permite conectar os Agentes da Fortics AI a sistemas externos, permitindo que eles consultem informações e usem ferramentas de maneira mais inteligente, segura e organizada.
Em termos simples, pense no MCP como um "**plugue de tomada universal"**. Em vez de construir uma integração proprietária e um código exclusivo para cada sistema que você deseja conectar ao seu Agente, o MCP padroniza essa comunicação. Ele permite que o Agente de IA converse de forma nativa e segura com servidores de dados e ferramentas externas, compreendendo instantaneamente quais recursos e capacidades estão disponíveis naquele ecossistema.
Através dessa funcionalidade, é possível ampliar as capacidades dos Agentes e disponibilizar recursos adicionais para automações e integrações da operação.
Neste tutorial, você aprenderá como cadastrar, editar e remover ferramentas MCP na plataforma.
Para acessar a área de gerenciamento do protocolo, clique no menu principal **"Configurações"** na barra lateral esquerda.
Na área superior do painel central, selecione a aba interna "**Ferramentas (MCP)**".
Para adicionar um novo protocolo clique no botão azul **"+ Nova ferramenta**" localizado na extremidade direita do painel.
{% hint style="warning" icon="lightbulb-exclamation-on" %}
**##Dica**
Utilize nomes descritivos para as ferramentas cadastradas. Isso facilita a identificação e o gerenciamento das integrações quando houver múltiplos MCPs configurados na plataforma.
Por exemplo, em vez de utilizar nomes genéricos como "**MCP 1**" ou "**Servidor**", prefira identificações que representem a finalidade da integração, como:
* **MCP - ERP Corporativo**
* **MCP - Consulta de Pedidos**
* **MCP - CRM Salesforce**
* **MCP - Base de Conhecimento Interna**
* **MCP - Sistema Financeiro**
Essa prática torna a manutenção das integrações mais simples e reduz o risco de utilizar a ferramenta incorreta durante a configuração dos Agentes.
{% endhint %}
## Adicionando um novo MCP
**Credencial (Opcional)**: Um menu suspenso onde você pode selecionar uma credencial de segurança previamente salva no sistema, caso o seu servidor MCP exija chaves de autenticação de terceiros.
**Nome:** Caixa de texto obrigatória para você dar uma identificação clara à ferramenta dentro do seu painel (Ex: *Conector ERP Interno*).
**Descrição:** Área de texto informativa. Você pode digitar uma descrição manual ou deixá-la em branco inicialmente, pois o sistema avisa na interface que clicar no botão "Testar" gerará uma descrição automatizada do seu MCP com base nos recursos identificados no servidor conectado.
**Configurações de Conexão - URL**: Campo técnico obrigatório onde você deve inserir o endereço de endpoint completo do seu servidor MCP externo (Ex: \[).
**Configurações de Conexão - Transport:** Menu suspenso para definir o protocolo de transporte de dados do ecossistema. O padrão vem selecionado como **Streamable HTTP.**
**Headers (Cabeçalhos HTTP):** Inicialmente, a seção exibe apenas o botão de ação "Adicionar headers" (batch\_Page 81.png). Ao clicar nele, a interface expande o bloco apresentando os dosi campos de texto **Chave e Valor** (batch\_Page 80.png). Use esta área para embutir metadados e parâmetros customizados de cabeçalho exigidos pela sua infraestrutura (como tokens de autenticação customizados ou *content-types*). Você pode clicar no ícone de mais (+) para abrir novas linhas de cabeçalho ou no ícone de menos (−) para remover um campo inserido.
**Botão Testar:** Um botão de ação azul centralizado na parte inferior do formulário. Você deve clicar nele antes de salvar para fazer uma chamada de teste no servidor externo. Isso serve para validar se as portas e cabeçalhos estão corretos e para alimentar automaticamente o campo de descrição com as capacidades retornadas pelo protocolo.
Após realizar a validação e obter o status de sucesso no teste de conexão, basta clicar no botão **"Salvar"** no canto inferior direito para gravar as configurações e disponibilizar a ferramenta para a esteira de atendimento dos seus agentes de IA.
## Editando o MCP
Caso precise alterar a URL do endpoint, o nome ou a descrição do servidor MCP acesse a aba **Ferramentas (MCP)** dentro do menu **Configurações**.
Na tabela de ferramentas, localize a linha correspondente a ferramenta que deseja modificar. Na coluna **Ações,** clique no **ícone de editar.**
O sistema abrirá o mesmo formulário utilizado na criação da ferramenta, com os dados atuais preenchidos. Altere as informações necessárias e clique em **Salvar** para aplicar as modificações.
## Excluindo uma MCP
Na listagem de ferramentas, localize a integração que deseja remover.
Na coluna **Ações,** clique no **ícone de lixeira (Remover).**
Um modal de confirmação será exibido na tela com a mensagem. Para concluir a remoção definitiva, clique no botão **Confirmar**. Caso tenha clicado por engano, basta selecionar **Cancelar.**
### Resultado esperado
Ao concluir este processo, a ferramenta MCP ficará disponível para utilização pelos Agentes da Fortics AI. Caso seja necessário, as configurações poderão ser editadas ou removidas posteriormente através da aba Ferramentas (MCP).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/cadastrando-o-model-context-protocol-mcp.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.