Tu primer stack MCP: Claude Code y Cursor paso a paso

Un stack mínimo viable para un agente interno tiene tres MCPs: uno que lee datos, uno que ejecuta acciones y uno que notifica. No necesitás quince integraciones el día uno. Con Linear + Postgres + Slack cubrís el flujo clásico de “¿hay bloqueos en los tickets y en la base?” — y aprendés el patrón para cualquier otro caso.

Stack de ejemplo: Linear + Postgres + Slack

Rol	Categoría	Para qué
Datos	databases	Consultar Postgres (bloqueos, métricas, estado)
Acción	workplace-and-productivity	Leer/actualizar tickets en Linear
Notificación	communication	Avisar por Slack cuando hay algo urgente

Buscá cada pieza por intención en el directorio. Elegí MCPs con install_ref confiable y último commit reciente — la guía anterior tiene el checklist.

Los nombres exactos de los repos pueden variar; lo importante es el patrón: una fuente de verdad (DB), un sistema de trabajo (issues), un canal de salida (chat).

Usar el stack builder

En Savante no copiás config MCP por MCP a mano si no querés:

1. Buscá los MCPs en el directorio.
2. Clic en ＋ Agregar al stack en cada card.
3. Abrí el drawer Tu stack (esquina inferior).
4. Elegí tab Claude Code o Cursor / Desktop.
5. Copiá o descargá la config combinada.

El stack builder mergea los servers en un solo bloque. Si un MCP no tiene install_ref confiable, aparece marcado como <TODO> — ahí tenés que ir al repo y completar manualmente.

Config para Claude Code (ejemplo)

Este snippet combina tres servers con nombres hipotéticos — reemplazá por los que elegiste en el directorio:

claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://user:pass@localhost:5432/mydb
claude mcp add linear -- npx -y @linear/mcp-server-linear
# <TODO: see repo> — slack MCP sin install_ref confiable en el catálogo
claude mcp add slack -- npx -y @hypothetical/slack-mcp-server

La tercera línea ilustra el patrón <TODO>: si el catálogo no tiene un comando verificado, el stack builder te avisa y te manda al README del repo. No inventes comandos — usá los que muestra la card o la documentación oficial.

Para variables de entorno (tokens de Linear, Slack, connection string de Postgres), configurá .env o el mecanismo que use tu MCP. Algunos servers requieren LINEAR_API_KEY, SLACK_BOT_TOKEN, etc. — el directorio marca <TODO> cuando no puede inferir el valor.

Config para Cursor

Cursor usa JSON en ~/.cursor/mcp.json o la config del proyecto. El stack builder genera algo así (estructura simplificada):

El formato es { "mcpServers": { "nombre": { "command": "...", "args": [...] } } }. Copiá desde el drawer — no dupliques keys manualmente.

Reiniciá Cursor después de editar la config. Verificá que los tres servers aparecen en la lista de MCPs disponibles antes de pedirle al agente una tarea compuesta.

Cuándo usar <TODO> en install_ref

El catálogo de Savante enriquece repos con señales de GitHub, pero no todos tienen un comando npx verificado. Cuando ves <TODO>:

• Andá al repo_url de la card
• Seguí las instrucciones de instalación del README
• Agregá el server manualmente a tu config
• Considerá reportar o elegir un MCP alternativo con install_ref listo

Instalar un MCP sin documentación clara es la causa #1 de “funcionó en la demo del README pero no en mi máquina”.

Probar el stack end-to-end

Antes de confiarle tareas reales, probá:

1. Conexión individual: “Listá las tablas de Postgres” / “Mostrá mis issues abiertos en Linear”
2. Flujo compuesto: “Buscá tickets bloqueados en Linear y cruzá con registros pendientes en Postgres”
3. Notificación: “Si hay más de 3 bloqueos, avisá en #dev-alerts”

Si el agente se pierde en el paso 2, el problema suele ser contexto (demasiadas tools) o permisos (el MCP de Slack no puede postear). Ajustá antes de escalar.

Siguiente paso

Con el stack funcionando en local, el salto a producción introduce permisos, verificación y un catálogo que no se pudra — eso es la guía 4.

Si preferís que armemos el stack por vos — MCPs + arquitectura + puntos de falla típicos — usá la banda de síntesis: describí tu agente en 2–4 oraciones y te lo mandamos por email.