🔌

Handbook 30 min lectura Claude Code Práctico · CLI

MCPs para QA
Guía Práctica con Claude Code CLI

Los MCP Servers son la clave para convertir Claude Code en un agente que conoce tu stack real: tu base de datos, tu repositorio, tu gestor de bugs y tu navegador. Esta guía te enseña qué son, cómo instalarlos desde la terminal y cuáles usar según el proyecto en el que trabajes.

MCPClaude CodeQA AutomationCLITestingAI

Por Rodrigo Campos · 2026-03-10

Tabla de contenidos

1. ¿Qué es MCP?

MCP significa Model Context Protocol — un protocolo abierto creado por Anthropic en 2024 que define cómo los modelos de IA (como Claude) pueden conectarse con herramientas externas de forma estandarizada.

Piénsalo así: Claude Code por sí solo es muy inteligente, pero vive dentro de su contexto. No sabe nada de tu base de datos de producción, no puede abrir tu navegador, no tiene acceso a tu Jira ni a tu repositorio de GitHub. Los MCP Servers son los "enchufes" que conectan a Claude con esas herramientas — por eso el nombre MCP: Model Context Protocol.

💡

La analogía del USB

MCP es al modelo de IA lo que el estándar USB es a los periféricos. En vez de que cada fabricante de teclado inventara su propio conector, USB estandarizó la conexión. MCP hace lo mismo: define un protocolo único para que cualquier herramienta (Playwright, Jira, PostgreSQL, Slack) pueda conectarse con cualquier agente de IA compatible.

Arquitectura MCP — Cómo se conecta Claude Code con tus herramientas

Cuando instalas un MCP Server, le das a Claude Code acceso real a esa herramienta. No le estás describiendo cómo funciona Jira — Claude puede literalmente consultar Jira, buscar tickets existentes, crear nuevos bugs y actualizar estados.

2. ¿Qué problema resuelve?

Sin MCP, para usar Claude en testing tenías que copiar y pegar constantemente: los logs de errores, el código del test, el resultado de la base de datos... todo manualmente al chat. Con MCP, Claude tiene acceso directo.

✗ Sin MCP — Flujo manual

1. Test falla → copias el error del terminal
2. Abres Claude.ai → pegas el error
3. Claude sugiere algo → vuelves al terminal
4. Necesitas datos de la DB → consultas manualmente, copias el resultado
5. Quieres crear un ticket → abres Jira, lo llenas a mano
→ 30-45 minutos por incidente

✓ Con MCP — Flujo asistido

1. Test falla → escribes en Claude Code
2. Claude lee los logs directamente (Filesystem MCP)
3. Consulta la DB para verificar el estado (PostgreSQL MCP)
4. Busca si hay un issue similar en GitHub (GitHub MCP)
5. Crea el ticket en Jira con toda la info (Jira MCP)
→ 3-5 minutos en total

¿Qué industrias se benefician más?

🏦

Banking

Validación de transacciones, logs de auditoría, pruebas de compliance

🛒

Ecommerce

Stock, pagos, flujos de checkout, catálogo de productos

📡

Telecom

Provisioning, billing, SLA monitoring, calidad de servicio

🚀

Startups

CI/CD rápido, GitHub + Jira + Slack integrado, iteración ágil

3. Cómo funciona: arquitectura

MCP sigue una arquitectura cliente-servidor. Claude Code actúa como el cliente — el que hace preguntas y solicita acciones. Cada herramienta que instalas (Playwright, GitHub, PostgreSQL) corre como un servidor MCP separado — el que ejecuta las acciones reales.

Diagrama de secuencia — una interacción MCP completa

petición respuesta actor activo

Los 3 componentes del ecosistema MCP

🖥️

MCP Client

Claude Code CLI

El agente que toma decisiones. Sabe cuándo llamar a cada MCP Server según la tarea. Ya viene integrado en Claude Code — no necesitas instalarlo por separado.

claude (CLI)Claude DesktopCursor IDE

⚙️

MCP Server

Tu herramienta conectada

El adaptador que traduce instrucciones del cliente a llamadas reales a la herramienta. Cada MCP Server expone un conjunto de "tools" (funciones) que el cliente puede invocar.

@playwright/mcpserver-githubserver-postgres

🗄️

Resource

El sistema real

La herramienta o sistema que recibe las acciones: el browser de Playwright, la API de GitHub, la base de datos PostgreSQL, el workspace de Jira.

Chromium browserGitHub REST APITu DB real

🔗

¿Cómo se comunican cliente y servidor?

MCP soporta dos mecanismos de transporte. Cuando usas claude mcp add, Claude Code usa stdio por defecto — el servidor MCP corre como un proceso local en tu máquina y se comunica con Claude Code a través de stdin/stdout. Es la opción más segura para uso local porque no expone ningún puerto de red.

stdio (local)

Proceso local, comunicación por stdin/stdout. Más seguro, sin red. Es el que usa claude mcp add.

SSE (HTTP)

Server-Sent Events sobre HTTP. Para MCPs remotos o compartidos en equipo. Requiere configuración adicional.

4. Instalación paso a paso

Todo se hace desde la terminal. No hay interfaces gráficas, no hay archivos de configuración complejos. Claude Code incluye el cliente MCP — solo necesitas agregar los servers que quieres usar con claude mcp add.

1 Verificar Claude Code instalado

Terminal

# Verificar que tienes Claude Code instalado
claude --version

# Si no lo tienes, instalarlo con npm
npm install -g @anthropic-ai/claude-code

# Autenticarse (abre el browser automáticamente)
claude

2 Instalar MCP de Playwright (automatización E2E)

Terminal

@playwright/mcp

# Agregar MCP de Playwright para automatización E2E
claude mcp add playwright -- npx @playwright/mcp@latest

# Verificar que quedó instalado
claude mcp list

Playwright MCP permite que Claude abra un browser real, navegue páginas, haga clicks y valide elementos — ideal para tests E2E sin escribir una línea de código Playwright manualmente.

3 Instalar MCP de GitHub (gestión de código y bugs)

Terminal

@modelcontextprotocol/server-github

# Agregar MCP de GitHub (requiere Personal Access Token)
# 1. Crea un token en: github.com → Settings → Developer settings → PAT
# 2. Copia el token y úsalo aquí:

claude mcp add github -- env GITHUB_TOKEN=ghp_tutoken npx @modelcontextprotocol/server-github

# Ahora Claude Code puede leer issues, PRs y repositorios de tu cuenta

4 Instalar MCP de Filesystem (acceso a archivos del proyecto)

Terminal

@modelcontextprotocol/server-filesystem

# Agregar MCP de Filesystem — acceso a archivos de tu proyecto
# Reemplaza /ruta/a/tu/proyecto con la ruta real

claude mcp add filesystem -- npx @modelcontextprotocol/server-filesystem /ruta/a/tu/proyecto

# Ejemplo real en macOS:
claude mcp add filesystem -- npx @modelcontextprotocol/server-filesystem /Users/rodrigo/ecommerce-tests

5 Instalar MCP de PostgreSQL (validación de datos)

Terminal

@modelcontextprotocol/server-postgres

# Agregar MCP de PostgreSQL para validar datos en tests
# La URL de conexión tiene el formato: postgresql://user:password@host:5432/database

claude mcp add postgres -- env DATABASE_URL=postgresql://qa_user:password@localhost:5432/mydb npx @modelcontextprotocol/server-postgres

# Ahora puedes pedirle a Claude que verifique el estado de la DB durante tests

6 Instalar MCP de Jira (gestión de bugs y tickets)

Terminal

@modelcontextprotocol/server-jira

# Agregar MCP de Atlassian Jira para gestión de bugs
# Necesitas: URL de tu instancia Jira + API Token

claude mcp add jira -- env JIRA_URL=https://tu-empresa.atlassian.net env JIRA_TOKEN=tu_api_token npx @modelcontextprotocol/server-jira

# Claude podrá crear tickets, buscar bugs y actualizar estados directamente

Verificar todos los MCPs instalados

claude mcp list — output esperado

$ claude mcp list

  Installed MCP Servers:
  ┌─────────────────┬────────────────────────────────────────┬────────┐
  │ Name            │ Command                                │ Status │
  ├─────────────────┼────────────────────────────────────────┼────────┤
  │ playwright      │ npx @playwright/mcp@latest             │ active │
  │ github          │ npx @modelcontextprotocol/server-github│ active │
  │ filesystem      │ npx @modelcontextprotocol/server-...   │ active │
  │ postgres        │ npx @modelcontextprotocol/server-...   │ active │
  └─────────────────┴────────────────────────────────────────┴────────┘

⚠️

Nunca incluyas tokens en scripts compartidos

Los tokens de GitHub, Jira y base de datos son credenciales sensibles. Úsalos solo en tu máquina local. Si trabajas en equipo, documenta cómo configurarlos, no compartas los valores.

5. MCPs y la pirámide de testing

La pirámide de testing define cuántos tests de cada tipo deberías tener. Los MCP Servers encajan de forma natural en cada nivel — algunos son más útiles en unitarios, otros en E2E o en exploración. Aquí el mapa completo:

Pirámide de Testing — MCPs recomendados por nivel

EXPLORATORIO / VISUAL

Playwright MCP · Figma MCP

E2E — MENOS TESTS

Playwright MCP · Filesystem MCP (leer fixtures)

INTEGRACIÓN — TESTS MEDIOS

PostgreSQL MCP · Filesystem MCP · GitHub MCP (specs)

API / CONTRATO

GitHub MCP (leer OpenAPI specs) · Filesystem MCP · PostgreSQL MCP

UNITARIOS — MÁS TESTS (BASE)

Filesystem MCP · GitHub MCP · Git MCP — Leer código, generar tests, revisar cobertura

Nivel	MCP recomendado	Para qué sirve en testing
Unitario	`Filesystem + Git`	Leer archivos fuente, generar unit tests, revisar cobertura, analizar diffs
API / Contrato	`Filesystem + GitHub`	Leer specs OpenAPI/Swagger, generar casos de prueba por endpoint, validar contratos
Integración	`PostgreSQL + Filesystem`	Validar estado de DB antes y después de tests, comparar datos esperados vs reales
E2E	`Playwright`	Abrir browser real, navegar flujos completos, capturar screenshots, validar UI
Exploración	`Playwright + GitHub`	Explorar funcionalidades nuevas, reportar bugs con evidencia, crear issues automáticos
Gestión de bugs	`Jira + GitHub + Slack`	Crear tickets, asignar bugs, notificar al equipo, trackear estado de incidentes

6. MCPs más usados para QA

Estos son los MCP Servers con mayor adopción en equipos de QA. Para cada uno: qué hace, cuándo usarlo y el comando de instalación exacto.

🎭

Playwright MCP

E2E · Exploratorio

El MCP más potente para QA. Abre un browser real (Chromium), navega páginas, hace clicks, llena formularios y captura screenshots. Claude puede ejecutar flujos E2E completos con instrucciones en lenguaje natural.

→ Ideal para: smoke tests rápidos, validación de flujos críticos, exploración de nuevas funcionalidades, captura de evidencias de bugs.

claude mcp add playwright -- npx @playwright/mcp@latest

🐙

GitHub MCP

Unitario · API · Gestión

Acceso completo a la API de GitHub: leer repositorios, issues, PRs, code reviews, archivos fuente y specs. Claude puede buscar bugs existentes, crear issues con contexto completo y revisar cambios de código.

→ Ideal para: triage de bugs, leer specs OpenAPI, revisar PRs con ojos de QA, crear issues con evidencia automática.

claude mcp add github -- env GITHUB_TOKEN=... npx @modelcontextprotocol/server-github

📁

Filesystem MCP

Todos los niveles

Acceso seguro al sistema de archivos de tu proyecto. Claude puede leer archivos de test existentes, analizarlos, generar nuevos tests basándose en el código real, y leer fixtures, configs y logs.

→ Ideal para: generar tests a partir de código existente, analizar logs de fallos, leer fixtures de datos de prueba.

claude mcp add filesystem -- npx @modelcontextprotocol/server-filesystem /tu/proyecto

🐘

PostgreSQL MCP

Integración · E2E

Conexión directa a PostgreSQL. Claude puede consultar tablas, validar que los datos son correctos después de un test, comparar estado antes/después de una operación y detectar inconsistencias.

→ Ideal para: validar estado de DB en tests de integración, verificar que los datos del test quedaron correctos, debugging de datos corruptos.

claude mcp add postgresql -- env DATABASE_URL=... npx @modelcontextprotocol/server-postgres

🎯

Jira MCP

Gestión de bugs

Integración con Atlassian Jira. Claude puede buscar tickets existentes, crear nuevos bugs con toda la información (pasos, evidencia, entorno), actualizar estados y asignar al equipo correspondiente.

→ Ideal para: reportar bugs automáticamente con evidencia, buscar si el bug ya existe, actualizar el estado de tickets desde el terminal.

claude mcp add jira -- env JIRA_URL=... env JIRA_TOKEN=... npx @modelcontextprotocol/server-jira

💬

Slack MCP

Notificaciones · Gestión

Integración con Slack para notificaciones de testing. Claude puede enviar alertas cuando un test crítico falla, publicar resúmenes de ejecución en el canal del equipo y notificar sobre regresiones detectadas.

→ Ideal para: notificar fallos de smoke tests, publicar resúmenes de ejecución, alertar sobre regresiones en CI/CD.

claude mcp add slack -- env SLACK_TOKEN=... npx @modelcontextprotocol/server-slack

7. MCPs por industria

No todos los proyectos son iguales. Aquí el stack de MCPs recomendado según el sector en el que trabajes — con los casos de uso más comunes de cada industria.

🏦

Banking / Fintech

Compliance · Transacciones · Auditoría

PostgreSQL MCP

Validar integridad de transacciones — que los montos, cuentas y estados en DB sean correctos

Filesystem MCP

Leer logs de auditoría y verificar que los eventos de compliance se registraron correctamente

GitHub MCP

Revisar cambios en reglas de negocio críticas antes de aprobar un PR de QA

Playwright MCP

Validar flujos de transferencia, login con 2FA y formularios de compliance

Caso de uso clave

"Ejecuta el test de transferencia entre cuentas y verifica en PostgreSQL que el saldo se descontó correctamente y que el log de auditoría registró la operación."

🛒

Ecommerce

Checkout · Pagos · Inventario

Playwright MCP

Flujos de compra completos: agregar al carrito, checkout, pago con tarjeta de prueba

PostgreSQL MCP

Verificar que el stock decrementó, el pedido se creó y el pago quedó registrado

GitHub MCP

Leer specs de la API de pagos para generar casos de prueba de borde (tarjeta rechazada, saldo insuficiente)

Jira MCP

Crear bugs de UX en el checkout con screenshot automático desde Playwright

Caso de uso clave

"Haz un purchase completo con la tarjeta de prueba Stripe, verifica el stock en PostgreSQL y crea un ticket en Jira si el precio final no coincide."

📡

Telecom

Billing · Provisioning · SLA

PostgreSQL MCP

Validar registros de billing — que los cargos por servicio calcularon correctamente según el plan

Filesystem MCP

Leer logs de provisioning y validar que el servicio activado dejó todos los registros esperados

GitHub MCP

Consultar specs de APIs de provisioning para generar tests de cada endpoint de activación/baja

Slack MCP

Notificar al equipo de operaciones cuando un test de SLA falla en CI/CD

Caso de uso clave

"Analiza los logs de provisioning del último deploy, verifica en la DB que los planes activados tienen el monto correcto y notifica en Slack si hay algún cargo inconsistente."

🚀

Startups

CI/CD rápido · GitHub · Iteración ágil

GitHub MCP

Revisar PRs con ojos de QA, crear issues de bugs directamente desde el terminal sin abrir el browser

Playwright MCP

Smoke tests rápidos post-deploy: las 3-5 funcionalidades core del producto deben seguir funcionando

Filesystem MCP

Generar tests nuevos a medida que se agrega código — sin deuda técnica de cobertura

Slack MCP

Notificar en #deployments cuando hay regresiones — el equipo se entera antes de los usuarios

Caso de uso clave

"Después del deploy, corre los smoke tests con Playwright, crea un issue en GitHub si algo falla y notifica en Slack con el link al issue."

8. Flujo de trabajo práctico

Aquí dos flujos reales que puedes ejecutar hoy mismo. Abre tu terminal, escribe claude y prueba estos prompts con los MCPs instalados.

🏦

Flujo 1 — Banking: fallo en test de transferencia

MCPs usados: Playwright + PostgreSQL + GitHub

claude — Banking QA workflow

# Escenario: falla en tests de transferencia bancaria

$ claude

> Tengo 3 tests de Playwright fallando en el flujo de transferencia.
> Analiza los errores, busca si hay un issue abierto en GitHub y
> si no existe, crea uno con los detalles del fallo.

# Claude Code con MCP Playwright + GitHub hará:
# 1. Lee los archivos de test desde filesystem
# 2. Ejecuta los tests y captura los errores
# 3. Busca en GitHub si ya existe un issue similar
# 4. Crea el issue con screenshot, stack trace y pasos para reproducir

🛒

Flujo 2 — Ecommerce: validación de datos post-deploy

MCPs usados: Playwright + PostgreSQL

claude — Ecommerce QA workflow

# Escenario: validar integridad de datos post-deploy

$ claude

> Corrí las pruebas de smoke del checkout y pasaron todas.
> Pero quiero verificar que los datos en PostgreSQL son correctos:
> - Los pedidos creados tienen status "pending"
> - El stock de productos decrementó correctamente
> Consulta la base de datos y dame un reporte.

# Claude Code con MCP PostgreSQL hará:
# 1. Consulta la tabla orders para los pedidos de los últimos 30 minutos
# 2. Verifica el campo status de cada pedido
# 3. Cruza con la tabla inventory para validar el stock
# 4. Genera un reporte de validación con cualquier anomalía detectada

🗣️

La clave: instrucciones en lenguaje natural

No necesitas saber la sintaxis de la API de Playwright ni conocer el schema exacto de tu base de datos. Describes lo que quieres verificar como si le hablaras a un colega y Claude Code, con los MCPs instalados, determina cómo hacerlo. Cuanto más contexto das (qué feature, qué entorno, qué datos esperabas), mejor será el resultado.

9. Errores comunes

🔑

Poner tokens directamente en el código

El comando claude mcp add incluye el token en la configuración local de Claude Code (en tu máquina). Nunca lo pongas en un script que vayas a compartir, en el repo Git ni en un archivo de configuración del equipo.

→ Cada desarrollador/QA configura sus propios MCPs con sus propios tokens. La configuración es personal.

📂

Dar acceso Filesystem a directorios demasiado amplios

Dar acceso a / (raíz) o a tu directorio home completo expone demasiados archivos. El MCP de Filesystem debería apuntar solo al directorio del proyecto que estás trabajando.

→ Usa rutas específicas: /Users/tu-usuario/proyectos/mi-app-tests, no /Users/tu-usuario.

🔄

No actualizar los MCPs cuando la herramienta cambia versión

Playwright, GitHub y los demás servidores MCP se actualizan constantemente. Si hay errores raros, probablemente el MCP desactualizado tiene incompatibilidades con la versión nueva de la API.

→ Periódicamente: claude mcp remove <nombre> y vuelve a instalarlo con npx (que descarga la última versión automáticamente).

🌐

Usar el MCP de Playwright en entornos sin display (CI headless)

Playwright MCP abre un browser con interfaz gráfica (headful). En servidores de CI sin display gráfico (GitHub Actions, Jenkins) fallará a menos que configures un virtual display como Xvfb.

→ Para CI usa Playwright directamente con scripts. Los MCPs son más útiles en tu máquina local durante desarrollo y exploración.

⏳

Esperar resultados instantáneos en tareas complejas

Cuando le pides a Claude que ejecute un flujo E2E completo + consulte la DB + cree un ticket en Jira, puede tomar 1-3 minutos. El agente trabaja paso a paso, no en paralelo.

→ Sé específico en lo que pides. Tareas más acotadas (solo el flujo E2E, solo la consulta a DB) son más rápidas y precisas.

Para quitar o actualizar un MCP:

Gestión de MCPs instalados

# Quitar un MCP que ya no necesitas
claude mcp remove playwright

# Actualizar un MCP a la última versión
claude mcp remove playwright
claude mcp add playwright -- npx @playwright/mcp@latest

10. Recursos y referencias

Documentación oficial

→

MCP — Documentación oficial Anthropic
modelcontextprotocol.io
→

Claude Code — Configurar MCP Servers
docs.anthropic.com/claude-code/mcp
→

MCP Servers — Repositorio oficial
github.com/modelcontextprotocol/servers

MCPs de testing

→

Playwright MCP — @playwright/mcp
github.com/microsoft/playwright-mcp
→

GitHub MCP Server
github.com/modelcontextprotocol/servers/tree/main/src/github
→

PostgreSQL MCP Server
github.com/modelcontextprotocol/servers/tree/main/src/postgres

Comunidad MCP

→

awesome-mcp-servers — Lista curada de MCPs
github.com/punkpeye/awesome-mcp-servers
→

MCP Discord — Comunidad oficial
discord.gg/modelcontextprotocol
→

Claude Code — GitHub Issues
github.com/anthropics/claude-code

Recursos de este portfolio

🔌

¿Listo para conectar Claude Code con tus herramientas?

Empieza con el MCP que más aplica a tu proyecto — Playwright si haces E2E, PostgreSQL si validas datos, GitHub si gestionas bugs. Un MCP a la vez, sin apresurarse.

Ver más recursos Claude Code para Testers → Contactar