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