> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP (Model Context Protocol)

> Conecte agentes a sistemas y herramientas externas usando el 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

<Warning>
  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.
</Warning>

### 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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:**

```json theme={null}
{
  "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:**

```json theme={null}
{
  "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:**

```json theme={null}
{
  "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

<Card title="Toolkits" icon="toolbox" href="/agents/toolkits/overview">
  Aprenda sobre toolkits e integraciones integradas
</Card>

## Soporte

¿Necesita ayuda con servidores MCP? Contacte soporte en [support@automationanywhere.com](mailto:support@automationanywhere.com).