Como demonstrar um servidor MCP para um cliente

Como é distribuir um servidor MCP hoje

A maioria dos servidores MCP começa como um processo local. O cliente os inicia por stdio — o servidor é um processo filho que fala JSON-RPC por stdin e stdout. Claude Desktop, Cursor e Conduit fazem assim. Não há nada para implantar no sentido de nuvem. O cliente é a implantação.

O Claude Desktop simplificou muito o lado dele: um servidor local empacotado como extensão .mcpb instala com um clique em Settings → Extensions, e um servidor remoto pode ser adicionado como conector personalizado. A configuração escrita à mão é hoje o caminho reserva para o que não está empacotado assim — um trecho para claude_desktop_config.json:

{
  "mcpServers": {
    "your-product": {
      "command": "npx",
      "args": ["-y", "@you/mcp-server"]
    }
  }
}

Você cola isso em uma thread do Slack ou em um PDF. O prospecto instala o Node, instala o Claude Desktop (macOS, Windows e um beta de Linux para Ubuntu e Debian), encontra o arquivo de configuração num caminho diferente por plataforma, cola sem quebrar o JSON, fecha o app por completo — fechar a janela não basta — e abre de novo. Empacotar o servidor como extensão elimina quase tudo isso e, se der para empacotar, empacote. O que nenhum caminho elimina é o resto: ele entra na conta da Anthropic, escolhe um modelo que ele paga e procura o seu servidor numa lista de ferramentas dentro do aplicativo de outra empresa.

Se o servidor for remoto, a receita muda mas o formato não. Você publica uma URL de Streamable HTTP — Render, Fly.io, FastMCP Cloud, Smithery, uma VPS — e ele cola that em um cliente que fala MCP remoto. Hospedar responde a “outra máquina consegue alcançar este processo?”. Não responde a “um prospecto não técnico tem um aplicativo, um modelo e um motivo para abri-lo?”.

Por que “é só mandar a configuração” não funciona

O prospecto não é desenvolvedor

Editar um arquivo JSON numa pasta Application Support, instalar npx, e depurar ENOENT porque o Windows queria npx.cmd é uma terça-feira normal para quem construiu o servidor. Não é uma primeira reunião razoável com um comprador. Os formatos de extensão de um clique tiraram quase toda essa dor, e isso é uma melhoria de verdade — mas um clique ainda é uma etapa que você pede a um comprador dentro de um aplicativo que ele teve de instalar e no qual teve de entrar, e as etapas que sobram não são suas.

Seu produto aparece dentro do cliente de um concorrente

Quando funciona, o prospecto não abriu o seu produto. Ele abriu o Claude, o ChatGPT ou o Cursor. Suas ferramentas são um item sob a marca de outra empresa, na janela de outra empresa, ao lado de tudo o que ele já tinha conectado. Você gastou o orçamento da demonstração no funil de integração de outra companhia. Ele vai lembrar do assistente que já paga, não do conector que você pediu para colar.

Você não controla nem o modelo nem a primeira tela

O Claude Desktop fala com o Claude. Você não pode apontar a demonstração para um modelo mais barato, para uma instância local do Ollama numa sala isolada, nem para o modelo que por acaso chama bem as suas ferramentas. Não pode definir o prompt de sistema, o estado vazio nem o nome na barra de título. A primeira coisa que ele vê é o produto da Anthropic. É uma posição ruim se as ferramentas são o produto.

As opções, comparadas

Três formas de colocar ferramentas MCP na frente de um prospecto. Hospedar o servidor é uma coluna dentro das duas primeiras linhas, não uma quarta opção — uma URL continua precisando de um cliente.

Escolha o chat hospedado quando o prospecto nunca for instalar software e você aceitar ficar no caminho dos dados. Escolha o Claude Desktop quando ele já viver ali e você só precisar provar que as ferramentas existem. Escolha um cliente desktop quando a demonstração for o produto: suas ferramentas, um modelo escolhido por você, numa máquina que você não precisa supervisionar.

Entregar o seu próprio cliente

Conduit é um cliente de IA para desktop e de código aberto. Ele fala MCP por stdio local e streamable HTTP remoto, no Windows, macOS e Linux. O prospecto baixa um instalador, adiciona uma chave de provedor (ou aponta para o Ollama) e adiciona o seu servidor na página de Conectores — comando mais argumentos, ou uma URL. Se o seu servidor remoto estiver publicado no registro oficial de MCP, ele o encontra pelo nome e adiciona com um clique. O conector roda na máquina dele, não na nossa.

Se o seu servidor for remoto e estiver publicado no registro oficial do MCP, , o prospecto não digita nada: ele procura o seu produto pelo nome na página de Conectores e adiciona com um clique. O Conduit filtra o registro para servidores que publicam um remoto por streamable HTTP e recusa entradas apenas com SSE informando o motivo, em vez de falhar depois. Se o servidor exigir autenticação, ele fala OAuth 2.1: o prospecto entra pelo navegador e o token fica no chaveiro do sistema operacional dele, nunca na interface e nunca com você.

Isso já é uma demonstração diferente da do Claude Desktop. Ele não fica preso a uma família de modelos. Pode rodar totalmente local. Uma ferramenta pergunta antes de executar, a menos que o servidor dela a marque como somente leitura. As conversas ficam no SQLite no disco dele. As requisições ao modelo saem da máquina dele para o provedor que ele configurou. Não há servidor do Conduit no meio, e é por isso que usar o Conduit como cliente não faz de you você, por si só, um operador dessa conversa.

Dois limites, ditos com clareza. Primeiro, ele continua instalando o Conduit , a menos que você mude o nome em Configurações → Marca naquela cópia, ou compile um OEM empacotado a partir do código. Segundo, se o seu servidor não estiver no registro, ele mesmo digita o conector, e de todo modo o build não chega já apontado para ele — essa camada de empacotamento não é hoje um instalador para baixar. A página de white-label é o programa para quem precisa das duas coisas. Esta página descreve o problema de distribuição que esse programa existe para resolver.

O que está pronto hoje

O mesmo status da tabela de white-label, reduzido ao que uma demonstração realmente precisa.

Os instaladores não são assinados pelo sistema operacional, então o Windows SmartScreen e o macOS Gatekeeper avisam no primeiro início. Diga isso ao prospecto antes que ele clique, ou compile a partir do código junto com ele. Os detalhes estão na documentação de instalação.

Perguntas

Baixar o Conduit

Se a demonstração só funciona como um build com a sua marca e já conectado, leia o status do white-label and abra uma thread de parceria de design.