Publicado originalmente em claudeguide.io/claude-mcp-custom-server-build

Construa um Servidor MCP Personalizado para Claude Code: Guia Completo (2026)

Um servidor MCP (Modelo de Protocolo de Contexto) personalizado permite que o Claude Code chame suas próprias ferramentas, APIs e fontes de dados de forma tão natural quanto comandos embutidos — um servidor funcional mínimo leva menos de 60 minutos para ser construído. Para construir um: crie um projeto Node.js/TypeScript, implemente a classe Server do @modelcontextprotocol/sdk, defina ferramentas com JSON Schema e registre o servidor nas configurações do Claude Code. Este guia passa por cada etapa com padrões prontos para produção.

O que é MCP e por que construir um servidor personalizado?

O MCP é um padrão aberto que define como modelos de IA se comunicam com ferramentas externas. O Claude Code vem com servidores MCP embutidos (sistema de arquivos, navegador, memória), mas servidores personalizados permitem que você:

• Conecte-se a APIs internas (JIRA, Confluence, Salesforce)
• Consultas em bancos de dados privados
• Envolva ferramentas de linha de comando como funções chamáveis pelo Claude
• Construa kits de ferramentas específicos para seu domínio para sua equipe

Benchmark: equipes que usam servidores MCP personalizados relatam redução de 40–60% nos passos manuais de copiar e colar por sessão de desenvolvimento, com base em pesquisas internas em primeiros adotantes do MCP.

Pré-requisitos

• Node.js 20+ e npm/bun
• Claude Code instalado e em execução
• Conhecimento básico de TypeScript

Estrutura do Projeto

mkdir my-mcp-server && cd my-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk zod
npm install -D typescript @types/node tsx
npx tsc --init

Atualize tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./dist",
    "strict": true
  }
}

Adicione ao package.json:

{
  "scripts": {
    "dev": "tsx src/index.ts",
    "build": "tsc",
    "start": "node dist/index.js"
  }
}

Servidor MCP Mínimo

Crie src/index.ts:

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
  ListToolsRequestSchema,
  CallToolRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";
import { z } from "zod";

const server = new Server(
  { name: "meu-servidor-personalizado", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

// Defina as ferramentas disponíveis
server.setRequestHandler(ListToolsRequestSchema, async () =

---

## Registre o Servidor no Claude Code

Adicione ao `~/.claude/settings.json` (ou projeto `.claude/settings.json`):

json
{
"mcpServers": {
"meu-servidor-personalizado": {
"command": "node",
"args": ["/caminho/absoluto/para/meu-mcp-server/dist/index.js"],
"env": {
"MY_API_KEY": "sua-chave-aqui"
}
}
}
}

Para desenvolvimento com recarregamento automático:

json
{
"mcpServers": {
"meu-servidor-personalizado": {
"command": "npx",
"args": ["tsx", "/caminho/absoluto/para/meu-mcp-server/src/index.ts"]
}
}
}