Como criar seu próprio servidor MCP

Resposta curta: Criar seu servidor MCP é como construir uma ponte que permite ao Claude acessar suas coisas pessoais. Você escreve um pequeno programa que diz ao Claude como buscar informações ou realizar tarefas no seu computador ou em serviços online. Não precisa ser programador experiente!

Você já imaginou poder pedir ao Claude para organizar suas fotos do celular, consultar uma planilha financeira ou até controlar as luzes da sua casa? Tudo isso é possível quando você conecta o Claude ao mundo real. Esse "conector" especial é chamado de servidor MCP. Neste artigo, você vai aprender, passo a passo e em linguagem simples, como criar o seu.

Índice

1. O que é um servidor MCP, afinal?
2. Por que criar um servidor do zero?
3. As peças do quebra-cabeça: o que você precisa saber
4. Passo a passo: mãos à obra
5. O que colocar dentro do seu servidor? Ideias práticas
6. Recomendamos testar estas 3 skills primeiro
7. Perguntas frequentes
8. Leia também

O que é um servidor MCP, afinal?

Vamos começar do começo. MCP significa Model Context Protocol. É um "protocolo", que é basicamente um conjunto de regras para conversar, feito para dar "contexto" (informações do mundo real) aos "modelos" de IA, como o Claude.

Pense no MCP como uma porta USB-C universal para aplicativos de IA. Assim como você conecta o carregador, fones de ouvido ou um pendrive no mesmo tipo de porta do seu celular, o MCP é uma maneira padrão de conectar o Claude a qualquer coisa: seu Google Agenda, uma planilha no computador ou um banco de dados. O servidor MCP é o adaptador específico que você conecta nessa porta. Ele é um programa pequeno que fica entre o Claude e a "coisa" que você quer acessar, traduzindo os pedidos do Claude em ações no mundo real.

Sem ele, o Claude é como uma pessoa muito inteligente, mas trancada em uma sala sem janelas. Ela sabe tudo sobre teoria, mas não pode interagir com nada lá fora. O servidor MCP abre a janela e passa coisas para ela.

Clientes são os aplicativos que usam o MCP, como o Claude Code (a versão do Claude que roda no seu terminal) ou o Claude Desktop. O servidor é o programa que você cria, que expõe ferramentas ou dados.

Por que criar um servidor do zero?

Existem muitos servidores MCP prontos por aí (chamados de Conectores no site do Claude). Então, por que criar o seu?

• Para coisas que são só suas: Imagine ter um arquivo no seu computador com todas as receitas da sua avó, escritas de um jeito único. Nenhum servidor pronto vai saber ler esse arquivo. Criando o seu, você ensina ao Claude como encontrar e entender suas receitas.
• Automação personalizada: Você pode criar um servidor que, quando solicitado, automaticamente: 1) busca a previsão do tempo, 2) verifica o trânsito no seu trajeto para o trabalho e 3) sugere se você deve sair mais cedo. Tudo em um único comando.
• Integrar sistemas diferentes: Digamos que você use uma ferramenta A para tarefas e uma ferramenta B para notas. Você pode criar um servidor que, quando você pedir "Claude, quais são minhas tarefas de hoje e suas anotações relacionadas?", ele busca nas duas ferramentas e junta as informações.
• Aprender de um jeito divertido: É um projeto de programação com um resultado muito tangível e útil. Você vê a "mágica" da IA interagindo com algo que você construiu.

É como preferir montar seu próprio hambúrguer com os ingredientes que você gosta, em vez de sempre pegar o do cardápio.

As peças do quebra-cabeça: o que você precisa saber

Antes de começar, vamos explicar alguns nomes que vão aparecer. Não se assuste!

• Terminal (ou Prompt de Comando): É uma tela preta (ou branca) onde você digita comandos de texto para o computador, em vez de clicar em ícones. É como mandar uma mensagem de texto direto para o sistema operacional, pedindo para ele fazer algo.
• API (Interface de Programação de Aplicações): É um "garçom" entre dois programas. Se um programa (como seu servidor MCP) quer informações de outro (como o Twitter), ele não vai direto à cozinha. Ele pede para a API (o garçom), que traz a resposta de um jeito padronizado.
• Token: A menor unidade de texto que uma IA entende. Não é exatamente uma palavra. Pode ser uma palavra curta, parte de uma palavra longa, um espaço ou um símbolo. Pensando em como criar mcp, é importante saber que as instruções que você escrever para o servidor também consomem tokens da janela de contexto do Claude.
• Servidor: No nosso contexto, é simplesmente um programa que fica "ouvindo" pedidos e responde a eles. Pense em um garçom em um restaurante vazio, esperando que um cliente (o Claude) faça um pedido.
• Repositório: É uma pasta especial na internet (geralmente no GitHub) que guarda todos os arquivos de um projeto, seu histórico de mudanças e permite colaboração. É como um Google Drive inteligente para código.
• JSON (JavaScript Object Notation): Um formato muito comum para organizar e trocar dados entre programas. É basicamente texto estruturado com chaves {}, colchetes [], nomes e valores. Fácil para humanos lerem e máquinas interpretarem.

Passo a passo: mãos à obra

Vamos criar um servidor MCP super simples que dá uma mensagem motivacional aleatória. Você verá que a estrutura é mais importante que a complexidade.

Pré-requisito: Você precisa ter o Claude Code instalado e configurado no seu computador. Se ainda não tem, confira na página oficial os comandos de instalação para o seu sistema (macOS, Windows ou Linux).

1. Crie uma nova pasta para o seu projeto. Abra o terminal, navegue até onde você guarda seus projetos (ex: cd Documentos) e digite: mkdir meu-primeiro-mcp. Entre na pasta: cd meu-primeiro-mcp.

2. Inicialize um projeto Node.js. Vamos usar JavaScript/Node.js, uma linguagem muito comum para isso. No terminal, dentro da sua pasta, digite: npm init -y. Isso cria um arquivo package.json, que é como a "lista de ingredientes e instruções" do seu projeto. Depois rode npm pkg set type=module (isso avisa o Node que o código usa o formato moderno de import; sem isso o exemplo abaixo dá erro).

3. Instale a biblioteca oficial do MCP. A Anthropic (criadora do Claude) oferece uma biblioteca que facilita muito a vida. No terminal, digite: npm install @modelcontextprotocol/sdk Isso baixa o "kit de ferramentas" para construir servidores MCP.

4. Crie o arquivo principal do servidor. Crie um arquivo chamado server.js usando um editor de texto (como Bloco de Notas, VS Code ou qualquer um). Cole o código abaixo:

   // server.js
   import { Server } from '@modelcontextprotocol/sdk/server/index.js';
   import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
   import {
     CallToolRequestSchema,
     ListToolsRequestSchema,
   } from '@modelcontextprotocol/sdk/types.js';
   
   // 1. Cria o servidor MCP, dando um nome e versão pra ele
   const server = new Server(
     {
       name: 'meu-mcp-motivacional',
       version: '1.0.0',
     },
     {
       capabilities: {
         tools: {}, // Diz que nosso servidor vai oferecer ferramentas
       },
     }
   );
   
   // 2. Cria nossa lista de frases motivacionais
   const frasesMotivacionais = [
     "Você é capaz de coisas incríveis!",
     "Um passo de cada vez. Você já chegou até aqui.",
     "O segredo é começar. Você já começou!",
     "Errar é parte do aprendizado. Siga em frente.",
     "Hoje é um ótimo dia para aprender algo novo."
   ];
   
   // 3. Define a ferramenta "dar_motivacao" que o Claude poderá usar
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
       {
         name: 'dar_motivacao', // Nome que o Claude vai conhecer
         description: 'Fornece uma frase motivacional aleatória para animar o usuário.',
         inputSchema: {
           type: 'object',
           properties: {}, // Esta ferramenta não precisa de nenhuma informação extra do usuário
         },
       },
     ],
   }));
   
   // 4. Diz ao servidor O QUE FAZER quando o Claude chamar a ferramenta "dar_motivacao"
   server.setRequestHandler(CallToolRequestSchema, async (request) => {
     if (request.params.name === 'dar_motivacao') {
       // Escolhe uma frase aleatória da lista
       const fraseAleatoria = frasesMotivacionais[Math.floor(Math.random() * frasesMotivacionais.length)];
       return {
         content: [
           {
             type: 'text',
             text: fraseAleatoria, // Esta é a resposta que volta para o Claude
           },
         ],
       };
     }
     // Se pedirem uma ferramenta que não existe, retorna erro
     throw new Error(`Ferramenta não encontrada: ${request.params.name}`);
   });
   
   // 5. Liga o motor do servidor e faz ele começar a ouvir no terminal
   async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error('Servidor MCP Motivacional rodando... (esta mensagem aparece no terminal)');
   }
   
   main().catch((error) => {
     console.error('Algo deu errado:', error);
     process.exit(1);
   });
   

5. Configure o Claude Code para usar seu servidor. Na mesma pasta (meu-primeiro-mcp), crie um arquivo chamado .mcp.json. Este arquivo diz ao Claude Code onde encontrar seu servidor.

   {
     "mcpServers": {
       "meu-mcp-motivacional": {
         "command": "node",
         "args": ["/CAMINHO/COMPLETO/ATE/SUA/PASTA/meu-primeiro-mcp/server.js"]
       }
     }
   }
   

   Importante: Substitua /CAMINHO/COMPLETO/ATE/SUA/PASTA/ pelo caminho real da pasta no seu computador. No terminal, você pode digitar pwd (macOS/Linux) ou cd (Windows) para ver o caminho completo.

6. Teste seu servidor! Agora, abra o Claude Code na sua pasta de projeto. No terminal, na pasta meu-primeiro-mcp, digite claude. Quando a interface abrir, tente perguntar: "Preciso de uma motivação, pode usar a ferramenta que criamos?" O Claude deve reconhecer a ferramenta dar_motivacao e usá-la, retornando uma das frases aleatórias que você programou!

Parabéns! Você criou e conectou seu primeiro servidor MCP.

O que colinar dentro do seu servidor? Ideias práticas

Agora que você sabe a estrutura, pode trocar o "conteúdo" do servidor. Em vez de frases motivacionais, seu servidor pode:

• Ler arquivos locais: Ensinar ao Claude a ler uma planilha CSV com seus gastos do mês e resumir onde você mais gastou.
• Consultar uma API pública: Buscar a cotação do dólar, a previsão do tempo ou os últimos lançamentos de um site de notícias.
• Controlar coisas na sua rede: (Avançado) Enviar comandos para dispositivos inteligentes em sua casa, como uma lâmpada.
• Processar texto: Receber um texto longo do Claude e formatá-lo de um jeito específico para postar em uma rede social.

O limite é basicamente o que você consegue programar para fazer. Comece com algo pequeno e útil para o seu dia a dia.

Recomendamos testar estas 3 skills primeiro

Estas skills ensinam o Claude a te ajudar a montar servidores MCP. Instale uma e peça: "me ajude a criar um servidor MCP simples".

1. Skill: mcp-builder-anthropics: Esta skill ensina o Claude a construir servidores MCP para você. Ela guia você no processo de criação, sugerindo estruturas e códigos. É um ótimo ponto de partida depois deste tutorial.
2. Skill: mcp-server-patterns-affaan-m: Mostra "padrões" comuns de código para servidores MCP. É como um catálogo de receitas (como buscar dados de uma API, como ler arquivos) que você pode copiar e adaptar para o seu projeto.
3. Skill: prepare-mcp-integration-paperclipai: Foca em preparar a integração do MCP, ajudando a estruturar e documentar seu servidor da melhor forma possível. Ensina boas práticas desde o começo.

Perguntas frequentes

Preciso ser um programador experiente para criar um MCP? Não, mas precisa ter noções básicas de lógica de programação e estar disposto a aprender. Saber o básico de JavaScript (ou Python) é suficiente para começar com projetos simples, como o do exemplo acima.

Meu servidor MCP vai consumir muitos tokens? O consumo principal vem da conversa com o Claude em si. O servidor apenas fornece ou recebe pequenos blocos de informação (texto, números). O que gasta tokens são as instruções que você dá ao Claude e as respostas longas que ele gera. As descrições das suas ferramentas no código também ficam na memória do contexto.

Posso vender ou compartilhar o servidor que criei? Sim! Você pode publicar o código em um repositório público (como GitHub) para outros usarem. Se for algo muito específico para sua vida, talvez não faça sentido. Mas se resolver um problema comum (ex: integrar com um app popular de forma única), outros podem achar útil.

É seguro conectar meu servidor a dados pessoais? Você é o responsável pela segurança. Nunca coloque senhas ou chaves de API diretamente no código. Use variáveis de ambiente (um jeito seguro de armazenar segredos no seu computador) para informações sensíveis. Só crie ferramentas que acessem dados que você tem permissão para acessar.

Qual a diferença entre Skill, Conector e Servidor MCP? São nomes para conceitos muito similares. Servidor MCP é o termo técnico geral do protocolo. Skill é como o Claude Code chama um servidor MCP (é uma pasta com scripts e documentação). Conector é como o site Claude.ai (a interface web) chama a mesma coisa. No fundo, todos se referem a programas que seguem as regras do MCP para conectar a IA a algo externo.

Leia também

• Para entender a base de tudo: O que é MCP (Model Context Protocol): explicado de um jeito fácil
• Para aprofundar no conceito técnico: O que é um servidor MCP e como funciona
• Para aprender a usar o que você criou: Como conectar MCP no Claude (Desktop e Code)
• Para se inspirar em servidores úteis: Melhores MCPs para Claude: Figma, Drive, WhatsApp, Power BI
• Para entender o ambiente de trabalho: Claude Code: o que é, como baixar, instalar e quanto custa (guia 2026)

---

Fontes

• O que é o Model Context Protocol (consultado em 16/10/2026)
• Claude Code: MCP (consultado em 16/10/2026)
• Claude Code: plugins (consultado em 16/10/2026)
• Planos e preços do Claude (consultado em 16/10/2026)