Como Implementar um Servidor MCP na Cloudflare

Procurando implantar um servidor de Protocolo de Contexto de Modelo (MCP) de alto desempenho e acessível globalmente? Cloudflare fornece a plataforma perfeita para lançar, proteger e escalar sua infraestrutura MCP. Este guia abrangente orienta você por todo o processo de implantação, aproveitando a rede de ponta de última geração da Cloudflare, robustas funcionalidades de segurança e arquitetura sem servidor para maximizar o desempenho e a confiabilidade do seu servidor.

O que é um Servidor MCP?

Um servidor MCP atua como uma ponte, permitindo que aplicações se comuniquem usando um protocolo padronizado, facilitando a integração de diferentes sistemas. É especialmente valioso ao integrar Modelos de Linguagem em Grande Escala (LLMs) com outros serviços ou aplicações.

Por que implantar na Cloudflare?

A implantação na Cloudflare garante escalabilidade global e baixa latência, graças à sua rede de ponta que abrange mais de 300 cidades. Ao contrário de provedores de nuvem tradicionais, o Cloudflare Workers utiliza um modelo sem servidor, executando código mais próximo dos usuários—ideal para aplicações em tempo real como chatbots impulsionados por LLM, que se beneficiam de tempos de resposta mais rápidos.

A Cloudflare oferece segurança robusta, incluindo um Firewall de Aplicações Web (WAF) personalizável para bloquear ameaças como ataques de injeção de prompt. Sua proteção contra DDoS mitiga automaticamente picos de tráfego, enquanto a criptação SSL/TLS protege os dados por padrão. Políticas rígidas de HTTPS previnem ataques man-in-the-middle, tornando-a uma escolha segura para aplicações sensíveis.

Do ponto de vista de custo, a Cloudflare é altamente eficiente. O nível gratuito suporta 100.000 solicitações diárias, enquanto projetos maiores podem usar Workers Unbound para computação ilimitada por apenas $0,15 por milhão de solicitações—mais barato que o AWS Lambda. Isso torna a Cloudflare uma opção amigável ao orçamento para escalar implantações de LLM e servidores MCP.

No geral, implantar um servidor MCP na Cloudflare é uma decisão estratégica para desenvolvedores que priorizam desempenho, segurança e eficiência de custo. Suas capacidades de computação de borda, combinadas com segurança de nível empresarial e preços competitivos, tornam-na uma excelente plataforma para aplicações modernas e escaláveis.

Pré-requisitos

Antes de começar, certifique-se de que você tenha o seguinte:

Conta Cloudflare: Inscreva-se para uma conta Cloudflare visitando seu site oficial se ainda não tiver uma.

Nome de Domínio: Um domínio é essencial para roteamento de tráfego através do DNS da Cloudflare. Se você não possui um, a Cloudflare oferece um subdomínio *.workers.dev como solução temporária.

Node.js e npm: Certifique-se de que possui o Node.js e o npm instalados em sua máquina local para a configuração e implantação do servidor.

Código do Servidor MCP: Certifique-se de que seu código seja sem estado, pois os Workers da Cloudflare não mantêm conexões persistentes. Por exemplo, evite armazenar dados de sessão na memória—use a Cloudflare KV ou Objetos Duráveis em vez disso.

Passo 1: Configurando o Projeto MCP

Antes de implantar, precisamos criar uma estrutura de projeto para o servidor MCP. Esta servirá como a base para desenvolvimento e integração.

Criar um Novo Diretório de Projeto

1. Abra seu terminal ou prompt de comando.

2. Crie uma nova pasta para seu projeto MCP:

mkdir MCP-Project
cd MCP-Project

Este diretório conterá todos os arquivos e configurações necessários para seu servidor MCP.

Inicializar um Worker da Cloudflare

1. Execute o seguinte comando para criar um novo projeto de Worker da Cloudflare:

npx create-cloudflare@latest mcp-demo

Este comando inicializa um novo worker da Cloudflare com templates predefinidos.

2. Selecione "Exemplo Hello World" como o template. Isso fornece uma estrutura básica de worker.

3. Escolha TypeScript como a linguagem do projeto. TypeScript oferece melhores ferramentas e manuseio de erros.

4. Se solicitado para configurar o Git para controle de versão, selecione Não (opcional, mas recomendado para rastreamento de versões).

5. Quando perguntado se deseja implantar imediatamente, você pode selecionar Sim ou opcionalmente selecionar Não (ainda iremos implantar mais tarde).

6. Navegue até o diretório do projeto:

# Substitua "mcp-demo" pelo nome do seu projeto
cd mcp-demo 

7. Configure o servidor MCP executando:

npx workers-mcp setup

8. Quando solicitado, pressione Enter para confirmar "Sim".

9. Pressione Enter novamente para substituir o conteúdo de src/index.ts.

10. Seu worker agora está implantado com sucesso no servidor MCP.

Passo 2: Integrando o Servidor MCP com Claude

Claude é um assistente de IA que pode interagir com servidores MCP. A integração garante que Claude possa se comunicar com o servidor MCP implantado (isto é uma continuação dos passos acima).

1. Você será solicitado a nomear seu servidor MCP (por exemplo, mcp-demo).

2. Se Claude Desktop estiver instalado, a configuração será automaticamente adicionada ao seu arquivo de configuração (.json).

3. O arquivo .json mantém um registro de todos os servidores MCP que você instalou, permitindo a interação contínua entre Claude e múltiplos ambientes MCP.

4. Esta integração permite que Claude acesse as ferramentas e funções do seu servidor MCP.

Passo 3: Explorando as Funções do Servidor MCP

O servidor MCP fornece várias ferramentas que podem ser exploradas e documentadas para melhorar a usabilidade.

1. Abra index.ts na pasta do seu projeto.

2. Use docstrings para documentar cada ferramenta em detalhes. A documentação adequada ajuda a IA e os desenvolvedores a entenderem a funcionalidade da ferramenta.

3. Uma docstring deve incluir:

• Uma breve descrição do que a ferramenta faz.
• Os parâmetros necessários, incluindo tipos e valores esperados.
• O formato de retorno esperado, explicando a estrutura da saída.

Exemplo de uma função bem documentada:

/**
 * Adiciona dois números.
 * @param {number} a - O primeiro número.
 * @param {number} b - O segundo número.
 * @returns {number} - A soma dos dois números.
 */
function addNumbers(a: number, b: number): number {
  return a + b;
}

4. Uma documentação bem estruturada garante que as ferramentas possam ser usadas efetivamente no Claude e em outros clientes MCP.

Passo 4: Testando o Servidor MCP

Testar garante que seu servidor MCP funcione corretamente antes de implantá-lo.

1. Abra um novo terminal e execute:

npx @modelcontextprotocol/inspector@latest

Este comando inicia o MCP Inspector, um cliente interativo para testar ferramentas MCP.

2. Abra o MCP Inspector em um navegador web navegando para:

http://localhost:5173

3. Adicione o caminho da URL que aponta para seu servidor MCP e conecte-se.

4. Clique em "Listar Ferramentas" para ver as ferramentas disponíveis que seu servidor MCP expõe.

5. Chame uma ferramenta e verifique se ela responde corretamente.

Passo 5: Executando o Servidor MCP com Claude

Uma vez integrado com Claude, você pode interagir com seu servidor MCP através de comandos acionados por IA.

1. Abra o Claude Desktop.
2. Uma notificação aparecerá: "Você tem uma nova ferramenta MCP disponível."

3. A descrição da docstring será exibida no Claude, explicando a função da ferramenta.

4. Você será solicitado a permitir que Claude se comunique com o servidor MCP. Clique em "Permitir para este chat".

5. Seu servidor MCP agora está conectado e acessível via Claude, permitindo uma automação contínua acionada por IA. Insira um prompt de exemplo para testar a interação e ver a resposta:

>> Diga olá para John Doe.

Passo 6: Implantando seu Servidor MCP

Para acesso remoto, implante seu servidor MCP na Cloudflare.

7. Abra um novo terminal e execute:

npx wrangler@latest deploy

8. Se estiver usando Git, você pode implantar enviando alterações ou mesclando uma pull request para o branch principal.

9. Uma vez implantado, copie a URL da Cloudflare do seu servidor MCP e insira esta URL no MCP Inspector em http://localhost:5173. Seu servidor MCP agora está ao vivo e acessível remotamente.

Passo 7: Conectando Seu Servidor MCP Remoto via Proxy Local

Uma vez implantado, você pode conectar o Claude Desktop ao seu servidor MCP remoto usando um proxy local.

1. Use mcp-remote para permitir que Claude e outros clientes MCP se comuniquem com seu servidor remoto.
2. Atualize seu arquivo de configuração do Claude Desktop (.json) com a URL do seu servidor MCP:

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-worker-name.your-account.workers.dev/sse"
      ]
    }
  }
}

3. Reinicie o Claude Desktop e complete o fluxo de autenticação.

4. Teste a integração perguntando ao Claude:

>> Você poderia usar a ferramenta de matemática para adicionar 23 e 19?

5. O Claude deve invocar a ferramenta de matemática e retornar o resultado correto do seu servidor MCP.

Conclusão

Implantar seu servidor MCP na Cloudflare pode melhorar significativamente sua escalabilidade, segurança e desempenho. Ao seguir este guia passo a passo, você poderá aproveitar a infraestrutura da Cloudflare para gerenciar seu servidor MCP de forma eficaz e você terá conseguido:

✔ Configurar um servidor MCP. ✔ Integrá-lo com Claude. ✔ Explorar e documentar funções do servidor. ✔ Testar o servidor localmente usando o MCP Inspector. ✔ Implantar o servidor MCP na Cloudflare. ✔ Conectar o servidor MCP remoto ao Claude Desktop.

Seu servidor MCP agora está escalável, seguro e acessível globalmente através da Cloudflare! Esta configuração é ideal para integrar LLMs e outros serviços que requerem um ambiente de servidor robusto e confiável. 🚀