Conecte seu servidor MCP ao Claude Desktop em 5 minutos

Você construiu um servidor MCP. E agora? Aqui está como conectá-lo ao Claude Desktop para que você possa realmente usar essas ferramentas.

Passo 1: Construa-o

ash
git clone https://github.com/zhirenhun-stack/mcp-server-starter.git
cd mcp-server-starter
npm install && npm run build


Passo 2: Encontre a configuração do Claude Desktop

No Mac:
json
~/Library/Application Support/Claude/claude_desktop_config.json


No Windows:
json
%APPDATA%\Claude\claude_desktop_config.json


Passo 3: Adicione seu servidor

json
{
"mcpServers": {
"my-starter": {
"command": "node",
"args": ["/path/to/mcp-server-starter/dist/index.js"]
}
}
}


Reinicie o Claude Desktop. Você deve ver um ícone de martelo no canto inferior direito.

O que você pode fazer agora

Uma vez conectado, Claude pode:

• ler arquivos do seu computador
• listar diretórios
• buscar padrões de código

Tudo isso através da linguagem natural. Pergunte "encontre todos os comentários TODO no meu projeto" e ele executa grep, lê os arquivos e resume.

Adicione suas próprias ferramentas

O starter tem três ferramentas. Você vai querer mais. O padrão é sempre:

ypescript
server.setRequestHandler(CallToolRequestSchema, async (request) => {
const { name, arguments: args } = request.params;
// seu código aqui
});


Cada ferramenta precisa: de um nome, de um esquema de entrada (JSON Schema descrevendo quais argumentos ela espera) e de uma função manipuladora. É isso.

Do starter à produção

O starter gratuito oferece o básico. Se você está construindo algo para clientes ou produção, a versão premium adiciona:

• Integração de API com tratamento de timeout
• Pesquisa na web via DuckDuckGo
• Dockerfile para implantação
• Script de implantação VPS com um comando
• Licença comercial

Para onde o MCP está indo

Todo cliente LLM importante está adicionando suporte ao MCP. O Claude Desktop já tem. O Cursor está adicionando. O VS Code tem isso via extensões. Escreva suas ferramentas uma vez, e elas funcionam em todos os lugares.

O protocolo é simples o suficiente que o starter tem cerca de 80 linhas de TypeScript. Você pode ler tudo em 10 minutos.