Servidores MCP: Conectando Claude a tu Stack
Instala y configura servidores MCP para darle a Claude acceso en vivo a Slack, Supabase, Notion y GitHub. No se requiere código "glue".
Una habilidad es un archivo markdown con frontmatter en ~/.claude/skills/. Claude descubre habilidades leyendo su campo de descripción; cuando tu solicitud coincide, carga y sigue el manual de procedimientos. Escribe las instrucciones una vez, obtén los mismos pasos cada vez.
---
name: translate-pi-jargon
description: Translate PI legal jargon into plain English. Use when the user pastes legal text or references terms like UM/UIM, demand letter, or lien.
---
# Translate PI Jargon
1. Restate the term in one plain sentence.
2. Give a one-sentence example of when it matters.
3. Flag anything with time-pressure (statutes, deadlines).Escribe una habilidad la tercera vez que pegues la misma receta en Claude.
La descripción es el mecanismo de descubrimiento. Claude lee las descripciones y decide qué habilidad, si alguna, se aplica a tu solicitud.
Malo: "Una habilidad para trabajar con documentos." Claude no puede saber cuándo se aplica esto.
Bueno: "Úsalo cuando el usuario pegue un contrato o pida resumir, marcar o extraer términos de un PDF."
La fórmula: "Úsalo cuando [activador específico]. Se aplica a [tipos de contenido específicos]."
¿Habilidad o regla de CLAUDE.md? Las habilidades son procedimientos repetibles de varios pasos; las reglas de CLAUDE.md son restricciones siempre activas. Un manual de despliegue de 10 pasos es una habilidad. "Nunca ejecutes migraciones contra producción sin una copia de seguridad" es una regla. Ambos pertenecen al sistema.
Un MCP (Model Context Protocol) server es un adaptador que expone herramientas externas a Claude. Slack, Supabase, Notion, GitHub: Claude llama al MCP, el MCP llama a la API, tú no escribes código "glue". En lugar de copiar y pegar datos en los prompts, Claude lee datos en vivo y toma acciones directamente.
MCP de base de datos: "Muéstrame los usuarios que se registraron la semana pasada pero no se han activado" se ejecuta como una consulta en vivo.
MCP de Slack: "Resume lo que #engineering discutió hoy" extrae mensajes en vivo.
MCP de Notion: "Actualiza la wiki del proyecto con las decisiones de hoy" escribe directamente.
MCP de GitHub: "Lista los PRs abiertos con más de 7 días" consulta el estado del repositorio en vivo.
Patrón de instalación: instala el servidor (npx o uvx), agrega la configuración a ~/.claude/settings.json:
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@your-org/mcp-slack"],
"env": { "SLACK_BOT_TOKEN": "xoxb-your-token-here" }
}
}
}Reglas de seguridad:
Nunca pegues tokens reales en archivos públicos; inyecta a través de variables de entorno o almacén de secretos.
Los MCP de base de datos obtienen credenciales de solo lectura con alcance a las tablas que Claude necesita. Las claves de rol de servicio pueden eliminar tablas.
Revisa qué herramientas expone cada MCP antes de desplegar.
Los MCP que realizan acciones obtienen una puerta de aprobación.
Elige tu primer MCP preguntando: ¿qué pego actualmente en Claude desde un sistema externo? Los resultados de consultas de base de datos apuntan al MCP de Supabase; las listas de PRs a GitHub; los resúmenes de canales a Slack; las notas a Obsidian. Un MCP instalado y usado activamente es mejor que cuatro configurados e ignorados.
Pruébalo: cierra y vuelve a abrir Claude Code para activar el descubrimiento, luego pregunta: "¿Qué herramientas tienes disponibles de [nombre del MCP]?" Si la lista está vacía, verifica la sintaxis de settings.json y confirma que npx o uvx están en tu PATH.
Las habilidades y los MCP se combinan. Una habilidad de manual de despliegue más un MCP de GitHub más un MCP de Slack: Claude sigue el manual, lee el estado de PRs en vivo, publica actualizaciones de progreso. Un despliegue manual de 20 minutos se convierte en 2 minutos. El costo de configuración es de aproximadamente 30 minutos por habilidad y 10 por MCP; los primeros cinco usos lo amortizan.
¿No hay MCP publicado para tu herramienta? Un servidor personalizado mínimo usando el SDK oficial de Python expone una herramienta en unas 30-40 líneas: define el nombre, la descripción y el esquema de entrada de la herramienta, luego maneja la llamada. Dale a la descripción de la herramienta la misma especificidad que a la descripción de una habilidad. Construye MCP personalizados para datos en vivo y consultados con frecuencia; para datos de referencia estáticos, una habilidad que te pida que los pegues es suficiente.
Gestión de credenciales para configuraciones de equipo. Los tokens codificados en un settings.json compartido son un incidente esperando a ocurrir. Dos patrones más seguros: paso de variables de entorno ("SLACK_TOKEN": "$SLACK_TOKEN", con el valor real en tu perfil de shell) o un gestor de secretos que el servidor MCP consulta al inicio (Vault, 1Password CLI), para que nada sensible viva en el disco.
Alcance al mínimo: un rol de Postgres de solo lectura para Supabase, un token de GitHub de grano fino limitado a repositorios específicos, un token de bot de Slack limitado a los canales que Claude debe ver.
Auditoría: para MCPs que pueden escribir, agrega un hook PostToolUse que registre la marca de tiempo, el nombre de la herramienta, los argumentos y el estado del resultado.
Las habilidades son manuales de procedimientos en markdown que Claude descubre por descripción; escribe uno la tercera vez que pegues las mismas instrucciones. Los MCP conectan a Claude con APIs externas sin código "glue"; usa credenciales de solo lectura y con el menor privilegio. La mejor primera habilidad: el procedimiento que has explicado dos veces esta semana. El mejor primer MCP: el sistema del que más copias y pegas.