Desenvolvimento de servidores MCP: a IA usando o seu produto

O que um projeto de servidor MCP inclui#

Partimos das tarefas que seus usuários querem que um assistente faça, não da referência da sua API. A orientação da OpenAI pede uma ferramenta por ação distinta, com uma descrição que diga quando usá-la, porque o modelo escolhe as ferramentas a partir desse texto; um servidor que espelha cada endpoint dá a ele dezenas de opções quase idênticas. A proposta lista quais entregas estão incluídas e como cada uma é aceita.

• Um mapa de ferramentas: cada tarefa do usuário como ferramenta, recurso ou prompt, com entradas, saídas e permissões
• Um servidor remoto sobre Streamable HTTP, no seu repositório e na sua conta de nuvem
• Login OAuth pelo seu provedor de identidade, ou uma API key restrita para uso interno
• Escopos por ferramenta, validação de entradas, limites de uso, confirmação antes de gravar e um log de auditoria
• Testes automatizados, além de execução de tarefas em cada cliente incluído
• Uma página de configuração para seus usuários e um runbook para as atualizações do protocolo

O que é o Model Context Protocol?#

O Model Context Protocol (MCP) é um padrão aberto para conectar aplicações de IA a ferramentas e dados externos. A Anthropic o apresentou no fim de 2024 e, em dezembro de 2025, o doou à Agentic AI Foundation, um fundo da Linux Foundation cofundado por Anthropic, Block e OpenAI. Um servidor pode oferecer ferramentas (funções que o modelo chama, cada uma com um JSON Schema para suas entradas), recursos (dados lidos como contexto) e prompts (modelos que o usuário escolhe).

A especificação é versionada por data. Em outubro de 2026, a revisão vigente é a 2026-07-28, que tornou cada requisição autossuficiente ao remover o handshake inicial e as sessões no nível do protocolo. Os clientes adotam as revisões no próprio ritmo, então testamos os servidores contra a 2026-07-28 e a anterior, 2025-11-25.

Quando vale a pena construir um servidor MCP?#

Quando seus clientes já pedem para usar o seu produto a partir de um assistente e a sua API consegue atendê-los: um sistema de suporte cujos clientes querem que o Claude leia o histórico de tickets, uma ferramenta para desenvolvedores cujos usuários trabalham no VS Code ou no Cursor, um produto B2B cujos compradores pedem uma integração com o ChatGPT.

É prematuro em três casos. Sem uma API, o primeiro projeto é a própria API, que é desenvolvimento de aplicativos web. Se você quer que a IA execute um processo dentro da empresa, como triar solicitações, a automação com IA é o escopo mais adequado. E um servidor MCP não fará seu negócio ser recomendado: como descobrimos no nosso guia de site pronto para agentes, a documentação dos rastreadores dos principais assistentes não descreve a descoberta automática das ferramentas de um site. Ser citado depende das suas páginas, tema que cobrimos no serviço de otimização para busca com IA e no guia sobre como aparecer nas respostas de IA.

Quais assistentes de IA podem se conectar ao seu servidor?#

A maioria dos assistentes chega a um servidor MCP remoto pela URL, mas cada um define as próprias regras sobre de onde a conexão parte e o que pergunta antes de executar uma ferramenta. Conforme a documentação de outubro de 2026:

Cursor, Gemini e Microsoft Copilot também adotaram o MCP, e conferimos a documentação atual deles quando entram no escopo. Antes do lançamento, conectamos cada cliente com contas de teste, executamos as mesmas tarefas e registramos o que cada um pede para o usuário confirmar.

Como os usuários fazem login e o que o assistente pode fazer?#

Com OAuth, cada pessoa faz login com a própria conta e o assistente recebe apenas o acesso que ela aprova. A autorização é opcional no MCP; quando um servidor remoto a usa, a especificação 2026-07-28 se baseia no OAuth 2.1:

• O servidor publica o Protected Resource Metadata (RFC 9728), que diz aos clientes onde fazer login
• Cada token é solicitado para um único servidor (RFC 8707); o servidor rejeita tokens destinados a outros e nunca repassa o token de um usuário a outra API
• Permissões ausentes retornam um 403 com insufficient_scope, para que o cliente possa pedir mais acesso
• Os Client ID Metadata Documents são preferidos para registrar clientes; o Dynamic Client Registration está obsoleto

Quais escopos existem é uma decisão de produto. Começamos somente leitura, adicionamos um escopo de escrita por ação (drafts:write, não admin) e conectamos o login ao seu provedor de identidade atual.

Nós mesmos fazemos isso. O CMS por trás do dardo.studio é um servidor MCP: uma requisição sem token recebe um 401 apontando para seus metadados de recurso, que listam escopos separados de leitura e escrita para conteúdo, mídia, esquema e configurações. Nossos agentes redigem e editam artigos por ele; o dono decide o que é publicado.

Como proteger um servidor MCP contra injeção de prompt?#

Trate cada chamada de ferramenta como entrada de um modelo que pode ter sido manipulado. A especificação exige que os servidores validem entradas, apliquem controles de acesso, limitem a frequência das chamadas e higienizem as saídas, e orienta os clientes a desconfiar das anotações de ferramentas de servidores em que não confiam; a OpenAI acrescenta que as anotações não substituem as verificações no servidor. O risco específico é a injeção de prompt: o texto dos seus próprios dados, como um ticket de suporte, pode trazer instruções dirigidas ao modelo. Nossos padrões:

• Somente leitura primeiro; ferramentas que enviam, apagam, pagam ou publicam exigem a confirmação do usuário
• Escopos verificados no servidor a cada chamada, não só no login
• Entradas limitadas por esquema e tamanho, com limites de uso por usuário e por cliente
• Resultados restritos aos campos de que a tarefa precisa, e um log de auditoria com dados pessoais ocultados
• Descrições de ferramentas revisadas como código, já que mudar uma descrição muda o que o modelo faz

O servidor público do dardo.studio é a ponta pequena disso: duas ferramentas somente leitura que listam nossos serviços e preparam um briefing de projeto sem enviá-lo, lendo o catálogo publicado sem banco de dados por trás. O corpo das requisições é limitado a 8 KiB, origens de navegador estranhas são rejeitadas e o endpoint tem seu próprio limite de frequência.

Hospedagem, testes e entrega#

Hospedamos o servidor junto à sua API atual ou no Cloudflare Workers, onde roda o nosso. A Cloudflare recomenda o createMcpHandler sem estado para servidores novos, com login pelo Cloudflare Access ou por qualquer provedor OAuth 2.0. Sem sessões de protocolo, o estado que atravessa várias chamadas, como um carrinho, trafega como um identificador que o servidor emite e confere com o usuário logado a cada vez.

Testes com roteiro chamam cada ferramenta com entradas válidas, inválidas e de tamanho excessivo pelo MCP Inspector, que a OpenAI recomenda para verificações locais e de produção, e rodam de novo no CI a cada mudança. Depois executamos tarefas reais em cada cliente, e alguém da sua equipe segue a página de configuração sem a nossa ajuda.

O código fica no seu repositório, o servidor na sua conta de nuvem e os registros OAuth no nome da sua empresa. Pela política de descontinuação da especificação, um recurso descontinuado normalmente permanece por pelo menos doze meses antes de poder ser removido, então o runbook que deixamos transforma as atualizações do protocolo em trabalho planejado.

Quanto custa desenvolver um servidor MCP?#

Não publicamos preço de pacote: um servidor somente leitura sobre uma API documentada é um trabalho bem menor do que um que grava dados de clientes via OAuth. As faixas de orçamento do nosso formulário vão de menos de USD 5.000 a mais de USD 60.000. O que move o valor:

• A API por baixo: documentada e estável, ou ainda por construir
• Quantas ferramentas gravam, apagam ou movimentam dinheiro
• O login: nenhum para dados públicos, uma chave fixa, ou OAuth com o seu provedor de identidade
• Quantos clientes entram no escopo, cada um com configuração e revisão próprias
• Visões interativas renderizadas no chat (MCP Apps) e requisitos de segurança ou auditoria que seus clientes impõem

Seu provedor de nuvem cobra a hospedagem na sua conta. Depois do lançamento, um plano de suporte pode cobrir atualizações de protocolo e de clientes, monitoramento e novas ferramentas, com escopo por escrito como nos nossos planos de manutenção de sites.

Dúvidas antes de escolher#

Do blog#

• O que é um servidor MCP? Guia para fundadores de SaaS saberem se precisam de um

  Um servidor MCP deixa Claude, ChatGPT e Copilot usarem o seu produto para um usuário logado: o que é, o que expor primeiro, os riscos e se alguém quer.