Skip to content

Servidores MCP

Los servidores MCP (Model Context Protocol) dan a tus agentes acceso a herramientas y fuentes de datos externas: bases de datos, APIs, clusters de Kubernetes, sistemas de archivos y mas. Configura servidores MCP a nivel de equipo y todos los agentes del equipo podran usarlos.

Como funciona MCP en AgentCrew

MCP es un estandar abierto para conectar modelos de IA con herramientas externas. AgentCrew soporta tres tipos de transporte:

Transporte Descripcion Ejemplo
stdio Proceso local que se comunica via stdin/stdout. El comando se ejecuta dentro del contenedor del agente. npx -y @modelcontextprotocol/server-postgres
http Servidor HTTP remoto que implementa el protocolo MCP. https://mcp.sentry.dev/sse
sse Servidor remoto que usa Server-Sent Events para respuestas en streaming. https://api.example.com/mcp/sse

La configuracion MCP es global por equipo, no por agente. Cuando agregas un servidor MCP, queda disponible para el lider y todos los trabajadores del equipo.

Agregar servidores MCP durante la creacion del equipo

En el asistente de creacion de equipos (Paso 2), desplazate hasta la seccion MCP Servers en la parte inferior. Para cada servidor, proporciona:

  • Name: Un identificador unico (ej: postgres-db, kubernetes)
  • Transport: stdio, http o sse

Luego, segun el transporte:

Servidores stdio

  • Command: El binario a ejecutar (ej: npx, uvx)
  • Args: Argumentos del comando, separados por coma (ej: -y, @modelcontextprotocol/server-postgres)
  • Environment Variables: Pares clave-valor pasados al proceso (ej: DATABASE_URL=postgresql://...)

Servidores http / sse

  • URL: El endpoint del servidor (ej: https://mcp.sentry.dev/sse)
  • Headers: Cabeceras de autenticacion o personalizadas (ej: Authorization: Bearer token)

Agregar servidores MCP a equipos en ejecucion

Puedes agregar, editar o eliminar servidores MCP en equipos que ya estan en ejecucion:

  1. Abre la vista de chat del equipo.
  2. Haz clic en el icono de Settings para abrir el modal de configuracion.
  3. Selecciona la pestana MCP Servers en la barra lateral.
  4. Usa el formulario para agregar un nuevo servidor o haz clic en Edit / Remove en los existentes.
Importante: Despues de agregar o eliminar servidores MCP, el proceso del agente debe reiniciarse para aplicar los cambios. La interfaz muestra un banner de aviso ambar con un boton Redeploy Team cuando se necesita un redespliegue.

Monitoreo de estado MCP

Cada servidor MCP muestra su estado de runtime en el modal de Settings. AgentCrew reporta el estado real de ejecucion de cada servidor MCP parseando eventos de estado del proveedor de IA (eventos init de Claude Code y eventos de runtime de OpenCode). Esto te da visibilidad en tiempo real sobre si cada servidor inicio correctamente o fallo.

Estado Indicador Significado
Running Punto verde El servidor MCP esta ejecutandose y disponible para los agentes. Confirmado por el runtime del proveedor de IA.
Failed Punto rojo El servidor MCP fallo al iniciar. Haz clic en la flecha para expandir los detalles del error reportados por el runtime.
Pending Punto gris El servidor esta esperando el estado de runtime del contenedor del agente. Este es el estado inicial antes de que el proveedor de IA reporte.

Cuando un servidor MCP tiene estado Failed, los detalles del error son expandibles directamente en la lista de servidores. Las causas comunes incluyen:

  • Paquete no encontrado (nombre incorrecto del paquete npm/pip)
  • Servidor remoto inalcanzable (URL incorrecta o problema de red)
  • Comando no encontrado (binario no instalado en la imagen del agente)
  • Fallo de autenticacion (credenciales invalidas o tokens expirados)
  • Timeout durante la descarga de dependencias

Configuracion por proveedor

AgentCrew genera automaticamente el archivo de configuracion correcto segun el proveedor de IA del equipo:

Proveedor Archivo de config Ubicacion
Claude Code .mcp.json /workspace/.mcp.json
OpenCode opencode.json /workspace/opencode.json

No necesitas escribir estos archivos manualmente. El proceso sidecar los genera automaticamente a partir de tu configuracion de servidores MCP.

Ejemplos

Base de datos PostgreSQL

Name:      postgres-db
Transport: stdio
Command:   npx
Args:      -y, @modelcontextprotocol/server-postgres
Env:       DATABASE_URL = postgresql://user:pass@host:5432/mydb

Cluster de Kubernetes

Name:      kubernetes
Transport: stdio
Command:   npx
Args:      mcp-server-kubernetes
Env:       KUBECONFIG_PATH = /path/to/kubeconfig

Sentry Error Tracking

Name:      sentry
Transport: http
URL:       https://mcp.sentry.dev/sse
Headers:   Authorization = Bearer <your-token>

Siguientes pasos

  • Habilidades: Extiende las capacidades de los agentes con paquetes de habilidades instalables.
  • Proveedores: Conoce los proveedores de IA soportados y como funciona MCP con cada uno.
  • Arquitectura: Entiende como el sidecar genera los archivos de configuracion MCP.