Protocolo de Contexto do Modelo (MCP) para Websites

Publicado originalmente em thatdevpro.com. Esta referência de framework é parte da pilha de Otimização de Motor de 14 camadas da ThatDevPro, um estúdio de engenharia web + IA de propriedade de veteranos certificado como SDVOSB. Você está lendo o espelho do dev.to; a versão canônica da fonte da verdade com ferramentas de validação incorporadas está no link acima.

Sites Endereçáveis por Agentes — Expondo Ferramentas, Recursos e Prompts para que Agentes de IA Possam Ler, Pesquisar, Reservar, Comprar e Transacionar em um Site Sem um Humano no Processo

Uma referência abrangente de instalação, auditoria e arquitetura para implementar servidores do Protocolo de Contexto do Modelo (MCP) em sites. O MCP é o protocolo aberto lançado pela Anthropic em novembro de 2024 e adotado em todos os principais ecossistemas de agentes de IA até 2025 e 2026. Ele padroniza como os agentes de IA (Claude, ChatGPT através de clientes compatíveis, frameworks agentes) se conectam a fontes de dados externas e ferramentas. Originalmente construído para integração de agente a aplicação (Asana, Slack, GitHub, sistemas de arquivos), o MCP está se estendendo rapidamente para integração de agente a site. Sites que expõem servidores MCP tornam-se diretamente endereçáveis por agentes de IA realizando tarefas em nome dos usuários: reservar, comprar, comparar, agendar, consultar. Sites que não se tornam invisíveis a essa superfície. Este documento especifica como construir, hospedar, validar e operar um servidor MCP para qualquer tipo de site, com um rubrica de auditoria de 30 pontos e padrões de implementação específicos da pilha. Dupla finalidade: manual de instalação e auditoria arquitetônica.

Nota de implementação cruzada de pilha: exemplos de código são escritos em TypeScript usando o @modelcontextprotocol/sdk oficial e Python usando a biblioteca mcp oficial. Para frontends React, Vue, Svelte, o MCP é executado no lado do servidor e é independente do framework frontend. Para Next.js, Nuxt, Astro e outras pilhas compatíveis com Node, veja a Seção 10. Para PHP/WordPress, Shopify, Webflow, veja a Seção 10.6 para padrões de MCP hospedados. A doutrina em framework-contentfirst.md continua a se aplicar: o substrato do site é HTML renderizado no servidor; o servidor MCP é uma superfície paralela para agentes.

Pré-requisito da doutrina: framework-contentfirst.md é o axioma arquitetônico. O MCP se sobrepõe. Um site que é invisível para crawlers de IA porque seu substrato não está no primeiro byte também falhará com agentes, porque os agentes normalmente ainda verificam contra o HTML do site antes de confiar nas respostas do MCP. Construa o Conteúdo Primeiro primeiro. Construa o MCP em segundo lugar.

1. Propósito do Documento

Este sistema de framework sistematiza a implementação do Protocolo de Contexto do Modelo para sites de clientes. O documento cobre o que é o MCP, por que os sites devem expor servidores MCP em 2026, a mecânica do protocolo, quais ferramentas e recursos expor por vertical, onde hospedar o servidor MCP, como anunciá-lo para descoberta, como autenticar operações de escrita, como validar de ponta a ponta com clientes de agentes reais, e a rubrica de auditoria que determina se um site é genuinamente endereçável por agentes.

A suposição de enquadramento: dentro de 12 a 24 meses, agentes de IA atuando em nome dos usuários serão o canal de entrada dominante para muitas consultas de intenção transacional. Um usuário dizendo a Claude ou ChatGPT para "reservar um guia de pesca no Lago Taneycomo para sábado ao amanhecer" resultará no agente consultando servidores MCP disponíveis diretamente, comparando disponibilidade e preços reais, reservando a viagem e confirmando de volta ao usuário. O site cujo servidor MCP retorna disponibilidade recebe a reserva. O site sem um servidor MCP não recebe nada. Esta é a próxima superfície após as citações de IA.

O MCP para sites ainda não é um tópico saturado. Nenhuma grande plataforma de SEO lançou um framework opinativo para isso. A adoção precoce estabelece uma vantagem durável de endereçamento por agentes que se acumula à medida que o uso de IA agente cresce.

1.1 Compreensão Necessária

Antes de ler este framework, o construtor deve estar familiarizado com:

• JSON-RPC 2.0 — o protocolo de solicitação/resposta no qual o MCP é construído
• Servidores HTTP e roteamento — Node.js, Python (FastAPI/Flask) ou equivalente
• Padrões de Autenticação — OAuth 2.1, chaves de API, tokens portadores, tokens assinados
• Design de Esquema — Esquema JSON para validação de entrada de ferramentas
• Arquitetura Primeiro o Conteúdo — framework-contentfirst.md, porque o MCP suplementa o substrato, não o substitui
• Citações de IA — framework-aicitations.md, porque o tráfego de agentes e o tráfego de citações se sobrepõem na fonte
• SEO Técnico — framework-technicalseo.md, porque os padrões de descoberta paralelam robots.txt e sitemaps

1.2 Escopo do Documento

Cobre: a mecânica do protocolo MCP, os três primitivos (ferramentas, recursos, prompts), camadas de transporte (stdio, HTTP, SSE), opções de hospedagem, design de ferramentas específicas por vertical, padrões de descoberta e anúncio, autenticação e segurança, metodologia de validação, estratégias de retrofit e greenfield, rubrica de auditoria. Toca, mas não esgota: design de API de backend (tratado como infraestrutura), processamento de pagamentos (tratado como integração), integração de sistemas de CRM e reserva (coberto em framework-conversiontracking.md), UX de agentes de IA (coberto em framework-agenticaisearch.md).

2. Coleta de Variáveis do Cliente

mcp_intake:

  site_type: ""                           # "local_business" | "service_business" | "ecommerce" | "saas" | "content_site" | "b2b" | "nonprofit"
  primary_intent_categories: []           # "booking" | "purchase" | "inquiry" | "information" | "comparison" | "subscription"
  has_existing_api: false                 # já existe uma API de backend
  api_authentication: ""                  # "none" | "api_key" | "oauth2" | "session" | "custom"
  booking_system: ""                      # "none" | "owner_rez" | "calendly" | "acuity" | "custom" | "square_appointments"
  ecommerce_platform: ""                  # "none" | "shopify" | "woocommerce" | "stripe" | "square" | "custom"
  primary_stack: ""                       # "static_html" | "nextjs" | "astro" | "wordpress" | "shopify" | "webflow" | "custom_node" | "custom_python"
  hosting_environment: ""                 # "bubbles" | "vercel" | "netlify" | "cloudflare_workers" | "shared_hosting" | "vps"
  expected_agent_traffic: ""              # "low" | "medium" | "high"
  high_value_tools_required...