Saltar al contenido principal

MCP (Model Context Protocol)

El Model Context Protocol (MCP) es un estándar abierto que le permite construir conexiones bidireccionales seguras entre sus fuentes de datos y herramientas impulsadas por IA. Piense en MCP como un traductor universal que permite a los Agentes de IA comunicarse fluidamente con cualquier sistema externo como bases de datos, sistemas de archivos, servicios web y APIs.

Descripción General​

Los servidores MCP extienden las capacidades de su agente proporcionando:

  • Acceso a Herramientas Externas - Conecte con servicios y API de terceros
  • Integración de Fuentes de Datos - Acceda a bases de datos, sistemas de archivos y almacenamiento en la nube
  • Funcionalidad Personalizada - Agregue herramientas especializadas para sus casos de uso específicos
  • Interfaz Estandarizada - Use un protocolo consistente para todas las integraciones
  • Autenticación Segura - Soporte para OAuth 2.0 y encabezados personalizados

Cómo Funciona​

1. Conexión del Servidor MCP​

Cuando agrega un servidor MCP a su agente:

  1. Registro del Servidor - El servidor se registra con la configuración de su agente
  2. Descubrimiento de Herramientas - El agente descubre las herramientas disponibles del servidor MCP
  3. Integración de Herramientas - Las herramientas se vuelven disponibles para el agente durante las conversaciones
  4. Ejecución Dinámica - El agente puede llamar a estas herramientas según sea necesario

2. Flujo de Ejecución de Herramientas​

Consulta del Usuario → Agente → Llamada a Herramienta MCP → Servidor MCP → Sistema Externo → Respuesta → Agente → Usuario

3. Múltiples Servidores​

Puede configurar múltiples servidores MCP por agente:

  • Cada servidor proporciona su propio conjunto de herramientas
  • Las herramientas tienen el prefijo del nombre del servidor (por ejemplo, sentry_get_errors)
  • Los servidores pueden habilitarse o deshabilitarse independientemente

Inicio Rápido​

Agregar Servidores MCP Populares​

  1. Navegue a Agentes en la barra lateral
  2. Seleccione o cree un agente
  3. Haga clic en Editar para abrir el agent builder
  4. Vaya a la pestaña MCP
  5. En la sección Agregar Rápidamente Servidores Populares, haga clic en una tarjeta de servidor para agregarlo

Servidores Populares​

Sentry​

Monitoree errores y problemas de rendimiento en sus aplicaciones.

  • URL: https://mcp.sentry.dev/mcp
  • Transporte: HTTP
  • Autenticación: OAuth 2.0
  • Alcances: org:read project:write team:write event:write

Capacidades:

  • Ver informes de errores
  • Monitorear métricas de rendimiento
  • Gestionar proyectos y equipos
  • Rastrear eventos e incidencias

Video Tutorial​

Mire este video para ver cómo agregar y configurar servidores MCP:

Agregar Servidores MCP Personalizados​

Paso 1: Acceda a la Configuración MCP​

  1. Navegue a Agentes en la barra lateral
  2. Seleccione o cree un agente
  3. Haga clic en Editar para abrir el agent builder
  4. Vaya a la pestaña MCP
  5. Desplácese hasta la sección Configuración Avanzada

Paso 2: Agregar Nuevo Servidor​

  1. Haga clic en el botón Agregar Servidor
  2. Aparecerá el formulario de configuración del servidor

Paso 3: Configurar los Ajustes del Servidor​

Nombre del Servidor​

Ingrese un nombre único para su servidor MCP (por ejemplo, my-custom-server, weather-api, database-connector).

Mejores Prácticas:

  • Use letras minúsculas y guiones
  • Sea descriptivo pero conciso
  • Evite caracteres especiales

Tipo de Transporte​

Seleccione cómo el agente se comunicará con el servidor MCP:

HTTP (streamable_http)

  • Solicitudes HTTP estándar
  • Mejor para REST APIs y servicios web
  • Soporta patrón de solicitud/respuesta

SSE (Server-Sent Events)

  • Comunicación de streaming en tiempo real
  • Mejor para feeds de datos en vivo
  • Soporta streaming unidireccional del servidor al cliente

URL del Servidor​

Ingrese la URL del endpoint para su servidor MCP:

Ejemplos HTTP:

  • https://api.example.com/mcp
  • http://localhost:8000/mcp/
  • https://mcp.example.com/v1

Ejemplos SSE:

  • https://api.example.com/sse
  • https://stream.example.com/events

Paso 4: Configurar Autenticación​

Sin Autenticación​

Seleccione Sin Autenticación si su servidor MCP no requiere autenticación.

OAuth 2.0​

Para servidores protegidos con OAuth:

  1. Seleccione OAuth 2.0 como método de autenticación
  2. Ingrese Alcances OAuth (separados por espacios)
    • Ejemplo: read write admin
    • Ejemplo: org:read project:write team:write

Flujo OAuth:

  • Cuando un usuario interactúa con el agente, se le pedirá autorizar
  • La autorización se maneja automáticamente
  • Los tokens se almacenan de forma segura y se renuevan según sea necesario

Paso 5: Encabezados Personalizados (Opcional)​

Si su servidor MCP requiere encabezados HTTP personalizados:

  1. Haga clic en Agregar Encabezado
  2. Ingrese el nombre del encabezado (por ejemplo, X-API-Key, Authorization)
  3. Ingrese el valor del encabezado
  4. Agregue encabezados adicionales según sea necesario

Encabezados Comunes:

  • X-API-Key: your-api-key
  • Authorization: Bearer token
  • X-Custom-Header: custom-value

Paso 6: Habilitar/Deshabilitar Servidor​

Active la casilla de verificación Habilitado para controlar si el servidor está activo:

  • Habilitado: Las herramientas del servidor están disponibles para el agente
  • Deshabilitado: Las herramientas del servidor están ocultas pero la configuración se conserva

Paso 7: Probar la Conexión​

  1. Haga clic en el botón Probar para verificar la conexión
  2. Espere el resultado de la prueba:
    • Éxito: El servidor es accesible y está configurado correctamente
    • Error: Verifique su configuración y conectividad de red

Paso 8: Guardar Configuración​

  1. Haga clic en Guardar para almacenar la configuración de su servidor MCP
  2. El servidor ahora está disponible para su agente

Gestión de Servidores MCP​

Visualizar Servidores Configurados​

En la pestaña MCP, puede ver:

  • Conteo de Servidores - Número de servidores configurados
  • Estado del Servidor - Estado habilitado/deshabilitado
  • Nombres de Servidores - Lista de todos los servidores configurados

Editar Configuración del Servidor​

  1. Encuentre el servidor en la sección Configuración Avanzada
  2. Haga clic para expandir la configuración del servidor
  3. Modifique cualquier ajuste
  4. Haga clic en Probar para verificar los cambios
  5. La configuración se guarda automáticamente

Eliminar Servidores​

  1. Encuentre el servidor que desea eliminar
  2. Haga clic en el ícono Eliminar (papelera)
  3. Confirme la eliminación
  4. El servidor se elimina de la configuración de su agente
aviso

Eliminar un servidor MCP hará que sus herramientas no estén disponibles para el agente. Asegúrese de que ninguna conversación activa dependa de estas herramientas.

Habilitar/Deshabilitar Servidores​

Active la casilla de verificación Habilitado para cualquier servidor:

  • Habilitar: Hace que las herramientas del servidor estén disponibles
  • Deshabilitar: Oculta las herramientas del servidor pero conserva la configuración

Esto es útil para:

  • Deshabilitar temporalmente servidores con problemas
  • Probar diferentes configuraciones de servidor
  • Gestionar la disponibilidad del servidor sin eliminar la configuración

Tipos de Transporte​

HTTP (streamable_http)​

Úselo Cuando:

  • Conecte con REST APIs
  • Patrones de solicitud/respuesta estándar
  • Servicios web y microservicios

Configuración:

  • La URL debe apuntar al endpoint MCP
  • Soporta métodos HTTP estándar
  • Funciona con la mayoría de servicios web

Ejemplo:

URL: https://api.example.com/mcp
Transporte: HTTP

SSE (Server-Sent Events)​

Úselo Cuando:

  • Flujos de datos en tiempo real
  • Actualizaciones y notificaciones en vivo
  • Comunicación unidireccional del servidor al cliente

Configuración:

  • La URL debe apuntar al endpoint SSE
  • El servidor debe soportar el protocolo SSE
  • Reconexión automática al desconectar

Ejemplo:

URL: https://stream.example.com/sse
Transporte: SSE

Métodos de Autenticación​

Sin Autenticación​

Úselo cuando su servidor MCP no requiere autenticación:

  • API públicas
  • Servicios internos
  • Servidores de desarrollo/pruebas

Configuración:

  • Seleccione Sin Autenticación
  • No se necesita configuración adicional

OAuth 2.0​

Úselo para acceso seguro autorizado por el usuario:

  • Servicios de terceros (Sentry, Canva, etc.)
  • Acceso a datos específicos del usuario
  • Permisos con alcance

Configuración:

  1. Seleccione OAuth 2.0
  2. Ingrese los alcances OAuth (separados por espacios)
  3. Los usuarios autorizarán en el primer uso

Ejemplos de Alcances OAuth:

  • Sentry: org:read project:write team:write event:write
  • Canva: asset:read asset:write design:read design:write
  • Personalizado: read write admin

Flujo OAuth:

  1. El usuario interactúa con el agente
  2. El agente necesita una herramienta MCP de un servidor protegido por OAuth
  3. Se le pide al usuario que autorice
  4. La autorización se completa automáticamente
  5. El token se almacena de forma segura
  6. Las solicitudes futuras usan el token almacenado

Encabezados Personalizados​

Use encabezados personalizados para:

  • Claves API
  • Tokens de autenticación personalizados
  • Encabezados específicos del servicio
  • Metadatos de solicitud

Agregar Encabezados​

  1. En la configuración del servidor, encuentre la sección Encabezados Personalizados
  2. Haga clic en Agregar Encabezado
  3. Ingrese el nombre del encabezado (por ejemplo, X-API-Key)
  4. Ingrese el valor del encabezado
  5. Agregue más encabezados según sea necesario

Patrones Comunes de Encabezados​

Clave API:

Encabezado: X-API-Key
Valor: your-api-key-here

Token Bearer:

Encabezado: Authorization
Valor: Bearer your-token-here

Encabezado de Servicio Personalizado:

Encabezado: X-Service-Name
Valor: your-service-identifier

Casos de Uso​

Monitoreo de Errores​

Servidor MCP Sentry

Monitoree errores y rendimiento de aplicaciones:

{
  "server_name": "sentry",
  "transport": "streamable_http",
  "url": "https://mcp.sentry.dev/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "org:read project:write team:write event:write"
}

Capacidades del Agente:

  • "Muéstreme los errores de las últimas 24 horas"
  • "¿Cuál es la tasa de errores del proyecto X?"
  • "Enumere todas las incidencias sin resolver"

Acceso a Base de Datos​

Servidor MCP de Base de Datos Personalizado

Conecte con su base de datos:

{
  "server_name": "postgres-db",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/database",
  "auth_type": "oauth",
  "headers": {
    "X-Database-Name": "production"
  }
}

Capacidades del Agente:

  • "Consulte la tabla de usuarios"
  • "Muéstreme los pedidos recientes"
  • "Obtenga estadísticas de clientes"

Acceso al Sistema de Archivos​

Servidor MCP de Sistema de Archivos

Acceda a archivos y directorios:

{
  "server_name": "filesystem",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/files",
  "auth_type": "oauth"
}

Capacidades del Agente:

  • "Enumere los archivos en la carpeta de documentos"
  • "Lea el archivo de configuración"
  • "Busque archivos que contengan 'error'"

Flujos de Datos en Tiempo Real​

Servidor MCP SSE

Conecte con feeds de datos en vivo:

{
  "server_name": "live-data",
  "transport": "sse",
  "url": "https://stream.example.com/sse",
  "auth_type": "oauth"
}

Capacidades del Agente:

  • "Muéstreme los precios de acciones en vivo"
  • "Monitoree las métricas del sistema"
  • "Rastree eventos en tiempo real"

Mejores Prácticas​

Nomenclatura de Servidores​

  • Sea Descriptivo: Use nombres claros y significativos
  • Use Minúsculas: Prefiera minúsculas con guiones
  • Evite Caracteres Especiales: Limítese a letras, números y guiones
  • Sea Consistente: Siga una convención de nomenclatura

Buenos Ejemplos:

  • sentry-monitoring
  • postgres-production
  • weather-api

Malos Ejemplos:

  • Server1
  • my_mcp_server
  • MCP-Server!!!

Configuración de URL​

  • Use HTTPS: Siempre prefiera conexiones seguras
  • Incluya la Ruta Completa: Especifique la URL completa del endpoint
  • Pruebe las URLs: Verifique que las URLs sean accesibles antes de guardar
  • Documente los Endpoints: Mantenga documentación de sus endpoints

Autenticación​

  • Use OAuth Cuando Sea Posible: Más seguro que claves API
  • Minimice los Alcances: Solicite solo los permisos necesarios
  • Almacene de Forma Segura: Los tokens se manejan automáticamente
  • Pruebe la Autorización: Verifique que el flujo OAuth funcione correctamente

Manejo de Errores​

  • Pruebe las Conexiones: Use el botón Probar antes de guardar
  • Monitoree los Registros: Verifique errores de conexión
  • Maneje Fallos: Configure respaldos para servidores críticos
  • Deshabilite Servidores con Problemas: Deshabilite temporalmente si es necesario

Rendimiento​

  • Limite la Cantidad de Servidores: Demasiados servidores pueden ralentizar los agentes
  • Deshabilite Servidores No Utilizados: Mantenga habilitados solo los servidores activos
  • Optimice los Encabezados: Solo incluya encabezados personalizados necesarios
  • Monitoree los Tiempos de Respuesta: Observe respuestas lentas del servidor MCP

Solución de Problemas​

Fallos de Conexión​

Problema: La prueba de conexión falla

Causas Posibles:

  • URL incorrecta
  • Problemas de conectividad de red
  • El servidor no está ejecutándose
  • Firewall bloqueando la conexión

Soluciones:

  • Verifique que la URL sea correcta y accesible
  • Verifique la conectividad de red
  • Asegúrese de que el servidor esté ejecutándose
  • Revise las reglas del firewall

Errores de Autenticación​

Problema: La autenticación OAuth falla

Causas Posibles:

  • Alcances OAuth incorrectos
  • El servidor no soporta OAuth
  • El usuario no ha autorizado
  • Token expirado

Soluciones:

  • Verifique que los alcances OAuth sean correctos
  • Verifique la documentación OAuth del servidor
  • Re-autorice la conexión
  • Verifique la configuración de expiración de tokens

Herramientas No Disponibles​

Problema: Las herramientas del servidor MCP no aparecen

Causas Posibles:

  • El servidor está deshabilitado
  • La conexión no se estableció
  • El servidor no responde
  • El descubrimiento de herramientas falló

Soluciones:

  • Habilite el servidor
  • Pruebe la conexión
  • Verifique que el servidor esté ejecutándose
  • Revise los registros del servidor

Errores de Tiempo de Espera​

Problema: Las solicitudes agotan el tiempo de espera

Causas Posibles:

  • Respuesta lenta del servidor
  • Latencia de red
  • Servidor sobrecargado
  • Configuración de tiempo de espera incorrecta

Soluciones:

  • Verifique el rendimiento del servidor
  • Verifique la velocidad de la red
  • Reduzca la carga del servidor
  • Ajuste la configuración de tiempo de espera si es configurable

Prueba de Servidores MCP​

Probar Conexión​

  1. Configure su servidor MCP
  2. Haga clic en el botón Probar
  3. Espere los resultados:
    • Éxito: Indicador verde con mensaje de éxito
    • Error: Indicador rojo con detalles del error

Resultados de la Prueba​

Indicadores de Éxito:

  • Mensaje de conexión exitosa
  • El servidor responde correctamente
  • La autenticación funciona (si aplica)

Indicadores de Error:

  • Tiempo de espera de conexión
  • Autenticación fallida
  • URL inválida
  • El servidor no responde

Interpretación de Resultados​

Éxito:

✓ Conexión exitosa
Conexión del servidor MCP probada exitosamente

Error:

✗ Conexión fallida
No se pudo conectar al servidor: Tiempo de espera de conexión agotado

Consideraciones de Seguridad​

Seguridad OAuth​

  • Almacenamiento de Tokens: Los tokens se almacenan de forma segura
  • Renovación de Tokens: Renovación automática de tokens cuando expiran
  • Limitación de Alcances: Solicite el mínimo de alcances necesarios
  • Autorización del Usuario: Los usuarios deben autorizar explícitamente

Encabezados Personalizados​

  • Datos Sensibles: No ponga datos sensibles en encabezados si es evitable
  • Claves API: Use OAuth cuando sea posible en lugar de claves API
  • Visibilidad de Encabezados: Los encabezados se almacenan en la configuración
  • Control de Acceso: Limite quién puede ver/editar configuraciones MCP

Seguridad de Red​

  • Solo HTTPS: Siempre use HTTPS para servidores de producción
  • Redes Internas: Use URLs internas para servidores privados
  • Reglas de Firewall: Configure los firewalls apropiadamente
  • Acceso VPN: Use VPN para conexiones seguras cuando sea necesario

Ejemplos​

Ejemplo 1: Integración Sentry​

Configuración:

{
  "server_name": "sentry",
  "transport": "streamable_http",
  "url": "https://mcp.sentry.dev/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "org:read project:write team:write event:write",
  "enabled": true
}

Uso:

  • El agente puede monitorear errores
  • Ver métricas de rendimiento
  • Gestionar proyectos Sentry

Ejemplo 2: Integración de API Personalizada​

Configuración:

{
  "server_name": "custom-api",
  "transport": "streamable_http",
  "url": "https://api.example.com/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "read write",
  "headers": {
    "X-Client-ID": "your-client-id"
  },
  "enabled": true
}

Uso:

  • El agente puede llamar a endpoints API personalizados
  • Acceder a recursos protegidos
  • Usar encabezados personalizados para identificación

Ejemplo 3: Servicio Interno​

Configuración:

{
  "server_name": "internal-service",
  "transport": "streamable_http",
  "url": "http://internal-service:8000/mcp",
  "auth_type": "none",
  "headers": {
    "X-Internal-Key": "internal-key-value"
  },
  "enabled": true
}

Uso:

  • El agente puede acceder a servicios internos
  • No se requiere OAuth
  • Encabezado personalizado para autenticación interna

Características Relacionadas​

  • Toolkits - Integraciones y herramientas integradas
  • Herramientas - Herramientas y acciones personalizadas
  • Configuración del Agente - Configure el comportamiento del agente
  • Integración de API - Conecte con API externas
Toolkits

Aprenda sobre toolkits e integraciones integradas

Soporte​

¿Necesita ayuda con servidores MCP? Contacte soporte en support@automationanywhere.com.