Criando Ferramentas MCP
O Model Context Protocol (MCP) é um protocolo aberto que permite conectar modelos de IA a ferramentas e fontes de dados externas. Com o transporte HTTP Streamable, é possível expor um servidor MCP via HTTP, permitindo que clientes de IA se conectem a ele de forma simples, segura e escalável.
Esta forma de conexão com servidores MCP faz parte do formato legado de habilidades, usado por habilidades criadas antes de julho de 2026.
Imagine que você tem um assistente de IA e quer que ele consiga fazer coisas além do que já sabe — por exemplo, consultar o estoque da sua empresa, buscar dados de clientes, ou criar tarefas num sistema interno.
Para isso, você pode usar um servidor MCP: um programa que fica "escutando" pedidos da IA e executa ações no seu sistema. O bloco mcp/install é a forma de dizer para a ferramenta de IA: "ei, existe um servidor lá nesse endereço — conecte-se a ele!"
Sintaxe de Instalação
Para conectar um servidor MCP ao seu agente, é necessário criar uma ferramenta dentro da competência com a seguinte sintaxe:
```mcp/install
url: <endereço_do_seu_servidor>/mcp
prefix: <apelido_para_suas_ferramentas>
headers: # opcional — só use se precisar de senha/token
Authorization: Bearer <seu_token>
<outro_campo_de_acesso>: <valor>
```
O que preencher em cada campo
url — O endereço do servidor
É como o endereço de um site. Aponte para onde o seu servidor está rodando, sempre terminando com /mcp.
Exemplo: https://minha-empresa.com/mcp
prefix — O apelido das ferramentas
Quando o servidor disponibiliza ferramentas para a IA, cada uma delas recebe esse apelido na frente do nome. Isso evita confusão caso você conecte mais de um servidor ao mesmo tempo.
Exemplo: se o apelido for estoque e a ferramenta se chama consultar_produto, ela aparecerá para a IA como estoque_consultar_produto.
headers — Informações de acesso (opcional)
Alguns servidores exigem uma "senha" ou identificação para aceitar conexões. Essa identificação é enviada aqui. Se o seu servidor não exige autenticação, pode ignorar essa parte.
Exemplos práticos
Servidor aberto (sem senha)
```mcp/install
url: https://ferramentas.minha-empresa.com/mcp
prefix: empresa
```
Servidor com token de acesso
```mcp/install
url: https://api.minha-empresa.com/mcp
prefix: empresa
headers:
Authorization: Bearer abc123meutokenaqui
```
Servidor com mais de um campo de identificação
```mcp/install
url: https://sistema.minha-empresa.com/mcp
prefix: sistema
headers:
Authorization: Bearer abc123meutokenaqui
X-API-Key: minha-chave-secreta
```
Algo não está funcionando?
| O que está acontecendo | O que pode ser | O que fazer |
|---|---|---|
| A ferramenta não aparece para a IA | O servidor pode estar desligado | Verifique se o servidor está rodando e acessível |
| Erro de "acesso negado" | Token errado ou ausente | Confira o token no campo headers |
| A conexão cai no meio do caminho | Problema de rede ou servidor sobrecarregado | Tente novamente ou fale com quem mantém o servidor |
| Duas ferramentas com o mesmo nome | Dois servidores com o mesmo prefix | Mude o prefix de um deles |
Quer saber mais sobre MCP?
Consulte a documentação oficial do Model Context Protocol.