MCP Server (Servidor MCP)
O que é um MCP Server, como funciona e como criar servidores que expõem ferramentas para agentes de IA. Guia completo.
MCP Server (Servidor MCP)
Um MCP Server (Servidor MCP) é um serviço que implementa o Model Context Protocol para expor ferramentas, recursos e prompts que agentes de IA podem utilizar. Pense nele como um “adaptador inteligente” que conecta uma ferramenta ou fonte de dados específica ao ecossistema de IA via um protocolo padronizado.
Cada MCP Server é especializado: existe um para Google Drive, outro para Slack, outro para PostgreSQL, e assim por diante. O agente se conecta a quantos servidores precisar, ganhando acesso às capacidades de cada um.
A arquitetura de um MCP Server segue o padrão definido pelo protocolo:
[Agente de IA / Cliente MCP]
↓ (requisição padronizada)
[MCP Server]
├── Declaração de Capacidades
│ ├── Tools: lista de ações disponíveis
│ ├── Resources: dados acessíveis
│ └── Prompts: templates reutilizáveis
├── Processamento da Requisição
└── Comunicação com Serviço Externo
↓
[Serviço Real: Google Drive, Slack, DB, etc.]
| Transporte | Descrição | Uso Típico |
|---|---|---|
| stdio | Comunicação via entrada/saída padrão | Servidores locais |
| HTTP + SSE | HTTP com Server-Sent Events | Servidores remotos |
- Inicialização — cliente e servidor trocam capacidades
- Descoberta — cliente lista ferramentas, recursos e prompts disponíveis
- Invocação — cliente solicita execução de uma ferramenta
- Resposta — servidor retorna o resultado
- Encerramento — conexão é fechada graciosamente
Veja como um MCP Server de sistema de arquivos funciona com o OpenClaw:
Configuração:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/home/usuario/documentos"
]
}
}
}
Uso na conversa:
Você: “Liste os arquivos da pasta documentos e resuma o relatório mais recente”
OpenClaw:
- Chama tool
list_directorydo MCP Server filesystem- Identifica o arquivo mais recente
- Chama tool
read_filepara ler o conteúdo- Usa o LLM para gerar o resumo
“Encontrei 12 arquivos. O mais recente é ‘relatorio-fev-2026.pdf’. Aqui está o resumo: …”
| Server | Serviço | Capacidades |
|---|---|---|
| filesystem | Sistema de arquivos | Ler, escrever, listar arquivos |
| github | GitHub | Issues, PRs, repositórios |
| google-drive | Google Drive | Buscar e ler documentos |
| slack | Slack | Enviar e ler mensagens |
| postgres | PostgreSQL | Consultas SQL |
| brave-search | Brave Search | Busca na web |
| puppeteer | Navegador | Navegar e capturar páginas web |
| memory | Memória | Persistência de conhecimento |
A criação de um MCP Server personalizado envolve:
- Escolher o SDK — disponível em TypeScript e Python
- Definir ferramentas — nome, descrição, parâmetros e lógica
- Implementar handlers — processar requisições e retornar resultados
- Configurar transporte — stdio para local, HTTP para remoto
- Testar — usar o MCP Inspector ou conectar a um cliente
Exemplo simplificado em Python:
from mcp.server import Server
from mcp.types import Tool
server = Server("meu-server")
@server.tool()
async def consultar_estoque(produto: str) -> str:
"""Consulta o estoque de um produto"""
quantidade = buscar_no_banco(produto)
return f"Produto '{produto}': {quantidade} unidades em estoque"
server.run()
MCP Servers lidam com dados e ações sensíveis, exigindo cuidados:
- Autenticação — verificar identidade do cliente
- Autorização — limitar quais ferramentas cada cliente pode acessar
- Validação — verificar parâmetros antes de executar ações
- Sandboxing — isolar execução para prevenir danos acidentais
- Logging — registrar todas as ações para auditoria
MCP Servers são os blocos de construção do ecossistema de IA agêntica. Cada novo servidor criado expande as capacidades de todos os agentes compatíveis com MCP. A comunidade open-source já mantém centenas de servidores, e esse número cresce semanalmente. Para o OpenClaw, MCP Servers são a forma principal de estender as capacidades do assistente sem modificar seu código-fonte.
Termos Relacionados: