Servidores MCP: Conectando Claude à Sua Stack
Instale e configure servidores MCP para dar a Claude acesso ao vivo a Slack, Supabase, Notion e GitHub. Nenhum código de "cola" é necessário.
Uma habilidade é um arquivo markdown com frontmatter em ~/.claude/skills/. Claude descobre habilidades lendo seu campo de descrição; quando sua solicitação corresponde, ele carrega e segue o runbook. Escreva as instruções uma vez, obtenha os mesmos passos todas as vezes.
---
name: translate-pi-jargon
description: Traduzir jargão jurídico de PI para inglês simples. Use quando o usuário colar texto jurídico ou referenciar termos como UM/UIM, carta de demanda ou penhor.
---
# Traduzir Jargão Jurídico de PI
1. Reformule o termo em uma frase simples.
2. Dê um exemplo de uma frase de quando isso importa.
3. Sinalize qualquer coisa com pressão de tempo (estatutos, prazos).Escreva uma habilidade na terceira vez que você colar a mesma receita em Claude.
A descrição é o mecanismo de descoberta. Claude lê as descrições e decide qual habilidade, se houver, se aplica à sua solicitação.
Ruim: "Uma habilidade para trabalhar com documentos." Claude não consegue dizer quando isso se aplica.
Bom: "Use quando o usuário colar um contrato ou pedir para resumir, revisar ou extrair termos de um PDF."
A fórmula: "Use quando [gatilho específico]. Aplica-se a [tipos de conteúdo específicos]."
Habilidade ou regra CLAUDE.md? Habilidades são procedimentos repetíveis de várias etapas; as regras CLAUDE.md são restrições sempre ativas. Um runbook de implantação de 10 etapas é uma habilidade. "Nunca execute migrações contra produção sem um backup" é uma regra. Ambos pertencem ao sistema.
Um MCP (Model Context Protocol) server é um adaptador que expõe ferramentas externas a Claude. Slack, Supabase, Notion, GitHub: Claude chama o MCP, o MCP chama a API, você escreve zero código de "cola". Em vez de copiar e colar dados em prompts, Claude lê dados ao vivo e executa ações diretamente.
MCP de banco de dados: "Mostre-me os usuários que se inscreveram na semana passada, mas não ativaram" é executado como uma consulta ao vivo.
MCP de Slack: "Resuma o que #engenharia discutiu hoje" puxa mensagens ao vivo.
MCP de Notion: "Atualize a wiki do projeto com as decisões de hoje" escreve diretamente.
MCP de GitHub: "Liste os PRs abertos com mais de 7 dias" consulta o estado do repositório ao vivo.
Padrão de instalação: instale o servidor (npx ou uvx), adicione a configuração a ~/.claude/settings.json:
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@your-org/mcp-slack"],
"env": { "SLACK_BOT_TOKEN": "xoxb-your-token-here" }
}
}
}Regras de segurança:
Nunca cole tokens reais em arquivos públicos; injete via variável de ambiente ou armazenamento de segredos.
MCPs de banco de dados obtêm credenciais somente leitura com escopo para as tabelas que Claude precisa. Chaves de função de serviço podem descartar tabelas.
Revise quais ferramentas cada MCP expõe antes de implantar.
MCPs que executam ações obtêm um portão de aprovação.
Escolha seu primeiro MCP perguntando: o que eu atualmente colo em Claude de um sistema externo? Resultados de consultas de banco de dados apontam para o MCP do Supabase; listas de PRs para o GitHub; resumos de canais para o Slack; notas para o Obsidian. Um MCP instalado e ativamente usado é melhor do que quatro configurados e ignorados.
Teste-o: feche e reabra o Claude Code para acionar a descoberta, então pergunte: "Que ferramentas você tem disponíveis do [nome do MCP]?" Se a lista estiver vazia, verifique a sintaxe de settings.json e confirme se npx ou uvx está no seu PATH.
Habilidades e MCPs se combinam. Uma habilidade de runbook de implantação mais um MCP do GitHub mais um MCP do Slack: Claude segue o runbook, lê o status do PR ao vivo, publica atualizações de progresso. Uma implantação manual de 20 minutos se torna 2 minutos. O custo de configuração é de aproximadamente 30 minutos por habilidade e 10 por MCP; os primeiros cinco usos pagam de volta.
Nenhum MCP publicado para sua ferramenta? Um servidor personalizado mínimo usando o SDK oficial do Python expõe uma ferramenta em cerca de 30-40 linhas: defina o nome, a descrição e o esquema de entrada da ferramenta e, em seguida, manipule a chamada. Dê à descrição da ferramenta a mesma especificidade de uma descrição de habilidade. Construa MCPs personalizados para dados ao vivo e frequentemente consultados; para dados de referência estáticos, uma habilidade que pede para você colá-los é suficiente.
Gerenciamento de credenciais para configurações de equipe. Tokens codificados em um settings.json compartilhado são um incidente esperando para acontecer. Dois padrões mais seguros: passagem de variáveis de ambiente ("SLACK_TOKEN": "$SLACK_TOKEN", com o valor real no seu perfil de shell) ou um gerenciador de segredos que o servidor MCP consulta na inicialização (Vault, 1Password CLI), para que nada sensível viva no disco.
Escopo para o mínimo: uma função Postgres somente leitura para Supabase, um token GitHub granular limitado a repositórios específicos, um token de bot Slack limitado aos canais que Claude deve ver.
Auditoria: para MCPs que podem escrever, adicione um hook PostToolUse registrando timestamp, nome da ferramenta, argumentos e status do resultado.
Habilidades são runbooks markdown que Claude descobre por descrição; escreva um na terceira vez que você colar as mesmas instruções. MCPs conectam Claude a APIs externas sem código de "cola"; use credenciais somente leitura e de privilégio mínimo. Melhor primeira habilidade: o procedimento que você explicou duas vezes esta semana. Melhor primeiro MCP: o sistema do qual você mais copia e cola.