MCP Servers
Conecte herramientas y servicios externos a AI SmartTalk utilizando el Model Context Protocol (MCP). MCP es un estándar abierto que permite que su asistente de IA interactúe con sistemas externos a través de una interfaz unificada.
Overview
La integración del servidor MCP le permite:
- Conectar múltiples servidores MCP simultáneamente
- Exponer herramientas externas para que su IA las llame durante las conversaciones
- Autenticarse con encabezados HTTP personalizados (claves API, tokens, etc.)
- Probar conexiones antes de salir en vivo
- Ampliar capacidades sin desarrollo personalizado
¿Qué es MCP? El Model Context Protocol es un estándar abierto (desarrollado por Anthropic) que permite a los sistemas de IA conectarse de manera segura a fuentes de datos y herramientas externas. Aprenda más en modelcontextprotocol.io.
Prerequisites
Antes de comenzar, asegúrese de tener:
- Una cuenta activa de AI SmartTalk
- Acceso a uno o más servidores compatibles con MCP
- La URL del servidor para cada servidor MCP
- Cualquier credencial de autenticación requerida (claves API, tokens)
How MCP Works
- El usuario hace una pregunta que requiere datos externos
- AI SmartTalk reconoce que necesita una herramienta MCP
- Se llama al servidor MCP apropiado con la herramienta correcta
- Se devuelve la respuesta y la IA formula una respuesta en lenguaje natural
AI SmartTalk soporta múltiples servidores MCP a la vez. Las herramientas de diferentes servidores se agrupan automáticamente para evitar conflictos.
Step-by-Step Setup
Step 1: Access MCP Integration
- Inicie sesión en su cuenta de AI SmartTalk
- Navegue a Administración → Mis Asistentes → [Su Nombre de Asistente]
- Haga clic en Conectores en la barra lateral izquierda
- Localice MCP Servers y haga clic en él
Step 2: Add an MCP Server
Haga clic en Agregar Servidor para abrir el formulario de configuración del servidor. Complete los siguientes campos:
| Campo | Requerido | Descripción |
|---|---|---|
| Nombre del Servidor | Sí | Un nombre amigable para identificar este servidor (por ejemplo, "CRM de la Empresa", "Wiki Interno") |
| URL del Servidor | Sí | La URL del endpoint del servidor MCP (por ejemplo, https://mcp.example.com) |
| Encabezados HTTP | No | Encabezados personalizados para autenticación u otros requisitos |
AI SmartTalk agrega automáticamente /mcp a su URL si no termina con eso. Por ejemplo, https://example.com se convierte en https://example.com/mcp. Si su servidor utiliza una ruta de endpoint diferente, inclúyala en la URL (por ejemplo, https://example.com/api/mcp).
Step 3: Add Authentication Headers (Optional)
Si su servidor MCP requiere autenticación, haga clic en Agregar Encabezados para configurar encabezados HTTP personalizados:
| Encabezado Común | Caso de Uso |
|---|---|
Authorization | Tokens Bearer (por ejemplo, Bearer sk-xxx...) |
X-API-Key | Autenticación con clave API |
X-Auth-Token | Autenticación con token personalizado |
Para cada encabezado, proporcione:
- Clave: El nombre del encabezado (seleccione de los encabezados comunes o escriba uno personalizado)
- Valor: El valor del encabezado (los valores sensibles se ocultan automáticamente en la interfaz)
Puede agregar múltiples encabezados por servidor. Los encabezados que contienen "secret", "password", "token" o "auth" en el nombre de la clave se ocultan automáticamente por razones de seguridad.
Step 4: Test the Connection
Antes de guardar, haga clic en Probar Conexión para verificar que su servidor sea accesible:
- AI SmartTalk envía una solicitud de inicialización JSON-RPC a su servidor
- La prueba verifica múltiples endpoints en orden:
/mcp,/health, luego la URL base - Los resultados muestran el estado de la conexión, el tiempo de respuesta y la información del servidor
| Resultado de la Prueba | Significado |
|---|---|
| Conectado | El servidor respondió correctamente con el protocolo MCP |
| Autenticación fallida | Verifique su clave API o token en los encabezados |
| Servidor no encontrado | Verifique que la URL sea correcta |
| Conexión rechazada | El servidor puede estar inactivo o el firewall bloqueando el acceso |
| Tiempo de espera | El servidor tardó demasiado en responder (límite de 10s) |
| Error SSL | Verifique que el servidor tenga un certificado SSL válido |
Step 5: Save Configuration
- Haga clic en Agregar para añadir el servidor a su lista
- Repita los Pasos 2-4 para agregar más servidores MCP si es necesario
- Haga clic en Guardar Integración para activar todos los servidores configurados
Multi-Server Support
AI SmartTalk admite conectar múltiples servidores MCP simultáneamente. Esto le permite combinar herramientas de diferentes fuentes:
Tool Namespacing
Las herramientas de cada servidor se prefijan automáticamente con el nombre del servidor para evitar conflictos de nombres. Por ejemplo:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Esto significa que puede conectar servidores que exponen herramientas con el mismo nombre de manera segura.
Managing Multiple Servers
El panel de integración muestra todos los servidores configurados con:
- Nombre y URL del servidor para fácil identificación
- Contador de encabezados si se han configurado encabezados personalizados
- Indicador de estado (Configurado / Incompleto)
- Botones de acción: Probar conexión, Editar o Eliminar servidores individuales
Tool Discovery
Una vez que sus servidores MCP están conectados, AI SmartTalk descubre automáticamente todas las herramientas disponibles expuestas por cada servidor. Estas herramientas se vuelven disponibles para su asistente de IA de inmediato.
El asistente de IA:
- Verá la lista de todas las herramientas disponibles de todos los servidores conectados
- Seleccionará automáticamente la herramienta correcta según las consultas del usuario
- Llamará a la herramienta con los parámetros apropiados
- Procesará la respuesta y proporcionará una respuesta en lenguaje natural
No necesita configurar o habilitar manualmente herramientas individuales. Todas las herramientas expuestas por un servidor MCP conectado están automáticamente disponibles para su asistente de IA.
Use Cases
Customer Relationship Management
Conecte su CRM a través de MCP:
- "Busque al cliente John Smith"
- "¿Cuál es el estado de la cuenta #12345?"
- "¿Cuántos tickets de soporte abiertos tenemos?"
Internal Tools
Acceda a los sistemas de la empresa:
- "Verifique el inventario del producto SKU-123"
- "¿Qué hay en la agenda para mañana?"
- "Busque en nuestra wiki interna los documentos de incorporación"
External Data Sources
Recupere datos en vivo:
- "¿Cuál es el clima actual en París?"
- "Obtenga el último precio de las acciones de AAPL"
- "Verifique el estado del vuelo UA123"
Development Tools
Para equipos técnicos:
- "¿Cuál es el estado de la última compilación?"
- "Busque en nuestros problemas de GitHub errores de autenticación"
- "Verifique la salud de los servidores de producción"
Ejemplos de Servidores MCP
Servidores MCP Populares
| Servidor | Propósito | Enlace |
|---|---|---|
| Filesystem | Leer/escribir archivos locales | Servidor de referencia integrado |
| PostgreSQL | Consultar bases de datos | Servidor comunitario |
| GitHub | Gestión de repositorios | Servidor comunitario |
| Slack | Integración de mensajería | Servidor comunitario |
| Google Drive | Gestión de archivos | Servidor comunitario |
| Brave Search | Búsqueda web | Servidor comunitario |
Encuentra más: Visita el Registro de Servidores MCP para una lista creciente de servidores MCP comunitarios.
Servidores MCP Autoalojados
Puedes crear servidores MCP personalizados para:
- Sistemas internos propietarios
- Lógica de negocio personalizada
- Acceso a datos seguros o privados
Utiliza cualquier SDK de MCP (TypeScript, Python) para construir tu propio servidor.
Consideraciones de Seguridad
Autenticación
Configura la autenticación a través de Encabezados HTTP en la configuración del servidor:
| Método | Ejemplo de Encabezado |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Privacidad de Datos
- Las solicitudes de MCP pueden contener datos de conversación del usuario
- Asegúrate de que tu servidor MCP maneje los datos de acuerdo con tus políticas de privacidad
- Considera los requisitos de residencia de datos
- AI SmartTalk oculta valores sensibles de encabezados en la interfaz de usuario
Seguridad de la Red
- Utiliza HTTPS para todas las conexiones MCP
- Restringe el acceso al servidor MCP a IPs de confianza
- Implementa limitación de tasa en tu servidor MCP
- Asegúrate de que los certificados SSL sean válidos
Solución de Problemas
Problemas de Conexión
| Problema | Solución |
|---|---|
| "Conexión rechazada" | Verifica la URL y el puerto del servidor. Asegúrate de que el servidor esté en funcionamiento |
| "Autenticación fallida" (401) | Verifica tu clave API o token en la configuración de encabezados |
| "Prohibido" (403) | Verifica que tus credenciales tengan los permisos requeridos |
| "Servidor no encontrado" (404) | Verifica la URL. AI SmartTalk añade /mcp automáticamente |
| "Tiempo de espera" | Verifica la conectividad de red y las reglas del firewall. La prueba tiene un tiempo de espera de 10 segundos |
| "Error SSL" | Asegúrate de que tu servidor MCP tenga un certificado SSL válido |
| "Limitado por tasa" (429) | Demasiadas solicitudes. Espera y vuelve a intentarlo, o aumenta los límites del servidor |
Problemas de Herramientas
| Problema | Solución |
|---|---|
| Herramientas no aparecen | Verifica que el servidor MCP exponga las herramientas correctamente. Intenta refrescar |
| Herramientas incorrectas llamadas | Verifica que los nombres de los servidores sean descriptivos para ayudar a la IA a elegir correctamente |
| Fallo en la llamada a la herramienta | Verifica los registros del servidor en busca de errores. Asegúrate de que la herramienta devuelva el formato esperado |
Errores Comunes
- Olvidar
/mcp: AI SmartTalk lo añade automáticamente, pero si tu punto final es diferente, incluye la ruta completa - Formato de encabezado incorrecto: Asegúrate de que los encabezados de autenticación coincidan con lo que tu servidor espera
- Nombres de servidor duplicados: Cada servidor debe tener un nombre único
Gestión de Servidores MCP
| Acción | Cómo |
|---|---|
| Agregar servidor | Haz clic en "Agregar Servidor", completa los detalles, prueba y guarda |
| Editar servidor | Haz clic en el ícono de editar en la tarjeta del servidor |
| Probar conexión | Haz clic en el ícono de prueba en la tarjeta del servidor |
| Eliminar servidor | Haz clic en el ícono de eliminar en la tarjeta del servidor |
| Guardar cambios | Haz clic en "Guardar Integración" para persistir todos los cambios |
Mejores Prácticas
- Usa nombres de servidor descriptivos: Ayuda a la IA a entender qué servidor consultar (por ejemplo, "CRM de la Empresa" en lugar de "Servidor 1")
- Prueba antes de guardar: Siempre prueba las conexiones para detectar problemas de configuración temprano
- Comienza con un servidor: Familiarízate con una integración antes de agregar más
- Asegura tus credenciales: Usa claves API dedicadas para AI SmartTalk, no tokens personales
- Monitorea tus servidores: Rastrea qué herramientas se llaman y su rendimiento
- Mantén los servidores actualizados: Asegúrate de que tus servidores MCP sigan la última especificación del protocolo