MCP (Model Context Protocol)

​

Descripción General

• 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

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

• 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

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

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

​

Video Tutorial

​

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

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

​

Tipo de Transporte

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

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

​

URL del Servidor

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

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

​

Paso 4: Configurar Autenticación

​

Sin Autenticación

​

OAuth 2.0

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

• 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)

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

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

​

Paso 6: Habilitar/Deshabilitar Servidor

• 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

• 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

​

Habilitar/Deshabilitar Servidores

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

• 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)

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

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

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

​

SSE (Server-Sent Events)

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

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

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

​

Métodos de Autenticación

​

Sin Autenticación

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

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

​

OAuth 2.0

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

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

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

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

• 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

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

Encabezado: Authorization
Valor: Bearer your-token-here

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

​

Casos de Uso

​

Monitoreo de Errores

{
  "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"
}

• “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

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

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

​

Acceso al Sistema de Archivos

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

• “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

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

• “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

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

• 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

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

• 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

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

• 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

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

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

​

Errores de Tiempo de Espera

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

• 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

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

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

​

Interpretación de Resultados

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

✗ 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

{
  "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
}

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

​

Ejemplo 2: Integración de API Personalizada

{
  "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
}

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

​

Ejemplo 3: Servicio Interno

{
  "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
}

• 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

​

Soporte