As APIs da Sua Empresa Estão Coletando Poeira. Os Agentes Estão Morrendo de Fome. Nós Fizemos a Conexão.

Adicionamos um projeto. Os agentes conseguiram empregos. Ninguém verificou se eles os queriam.

Resumo

Sua empresa tem APIs. Agentes de IA querem usá-las. Os agentes não têm ideia de que elas existem. Nós envolvemos as nossas em MCP em uma tarde, não tocamos na lógica de negócios existente e, de repente, um agente estava fazendo um trabalho que costumava levar a um humano quatro abas do navegador e uma planilha com muitos formatos condicionais. Esta é a história.

Ok, Então Imagine Isso

Você passou anos construindo APIs. Verdadeiras. Com lógica de negócios real. Manipuladores cuidadosamente escritos, modelos de domínio, toda a configuração de arquitetura limpa da qual sua equipe se orgulha em silêncio.

E então os agentes de IA aparecem.

Eles querem automatizar as coisas. Eles estão muito entusiasmados com isso. E eles não conseguem encontrar um único um de seus endpoints porque — e não podemos enfatizar isso o suficiente — agentes não navegam na documentação do Swagger.

Eles precisam de ferramentas. Expostas em um protocolo que eles falam. Sem isso, todo o seu portfólio de APIs pode muito bem não existir.

Descobrimos isso da maneira divertida.

MCP. O Que É. Por Que Você Se Importa.

Modelo de Contexto de Protocolo. A Anthropic o tornou de código aberto. Pense no USB-C para ferramentas de IA.

Antes do MCP, conectar uma IA à sua API significava escrever um wrapper personalizado. Toda. Única. Vez. Modelo diferente? Novo wrapper. Nova equipe? Novo wrapper. Era miserável e todos fingiam que estava tudo bem.

O MCP diz: um padrão. Um servidor. Qualquer agente que fale o protocolo descobre suas ferramentas automaticamente e sabe o que chamar e com quais parâmetros.

Você escreve uma descrição. O agente a lê. O agente faz a coisa. Nenhum humano no meio explicando a API como se fosse o primeiro dia de um novo estagiário.

"Você teve o poder o tempo todo." — Glinda, a Boa Bruxa, definitivamente falando com sua camada de Aplicação

A Parte Onde a Arquitetura Limpa Acidentalmente Nos Salvou

Então aqui está a coisa sobre Arquitetura Limpa que ninguém coloca nos slides da conferência.

A API REST? É apenas um mecanismo de entrega. Ela está do lado de fora. Não é o cérebro. É o carteiro. Você poderia trocá-la e a lógica de negócios não notaria.

      Domínio
        ↑
    Aplicação       ← o verdadeiro cérebro
     ↑       ↑
   REST     MCP       ← ambos apenas recebendo ordens

Adicionamos o servidor MCP no mesmo nível que a API REST. Ambos falam com os mesmos manipuladores existentes. Nenhum deles sabe que o outro existe. Toda a lógica de negócios permaneceu completamente intocada.

Ficamos satisfeitos com isso pelo resto do dia. Com razão.

E o Fatiamento Vertical Tornou Cada Recurso uma Ferramenta Gratuita

Cada recurso em nosso código já é uma fatia autônoma. Manipulador, solicitação, resposta — tudo junto, tudo organizado.

O controlador REST o chama:

var resultado = await _bus.InvokeAsync<GetProductDetails.Response>(
    new GetProductDetails.Request { ProductId = productId }, ct);

A ferramenta MCP chama o mesmo manipulador exato:

[McpServerTool, Description("Obtém detalhes do produto, incluindo preço e nível de estoque.")]
public Task<GetProductDetails.Response?> GetProductDetails(
    [Description("O ID do produto")] Guid productId, CancellationToken ct)
    => _bus.InvokeAsync<GetProductDetails.Response>( 
        new GetProductDetails.Request { ProductId = productId }, ct);

Mesmo manipulador. Mesma resposta. Três novas linhas de código.

A fatia do recurso já era uma unidade. Nós apenas lhe demos uma nova porta de entrada.

O Servidor Inteiro Em Uma Captura De Tela De Código

builder.Services.AddApplication(builder.Configuration); // seu aplicativo inteiro, já conectado
builder.Services.AddMcpServer().WithHttpTransport().WithToolsFromAssembly();
app.MapMcp("/");

AddApplication — a mesma chamada que sua API REST faz. Cada manipulador, cada repositório, cada serviço. Tudo isso apenas... lá.

WithToolsFromA