Conectar un agente de IA (Claude) vía MCP

Conecta un agente de IA (como Claude) a tu CRM mediante el servidor MCP nativo. El agente lee y crea registros (leads, contactos, oportunidades) de forma segura, usando tu API key.

El MCP (Model Context Protocol) es el estándar que permite a un agente de IA hablar con sistemas externos. Sellio incluye un servidor MCP nativo: apunta el agente (por ejemplo Claude, en Claude Desktop o en cualquier cliente MCP) a la URL del servidor y podrá consultar y crear registros en tu CRM; es ideal para un agente de prospección que crea leads y contactos automáticamente. Todo se ejecuta en el contexto del tenant dueño de la API key y respeta las validaciones y permisos (RBAC) del CRM.

Requisitos previos

• Un cliente MCP (Claude Desktop, o cualquier app/agente que hable MCP por HTTP).
• En Sellio, ser administrador para generar la API key en Configuración → API y desarrolladores.

1) Genera una API key

1. Abre Configuración → API y desarrolladores (también accesible por el atajo en el menú lateral).
2. Crea una nueva API key y copia el valor (empieza con sk_ y solo aparece una vez; trátalo como una contraseña).
3. La misma clave sirve para la API REST y para el MCP.

2) Apunta el agente al servidor MCP

La URL del servidor MCP es https://TU-CRM/api/mcp y la autenticación es la misma que en REST: el encabezado Authorization: Bearer sk_...

En Claude Desktop (y clientes que usan el puente mcp-remote), añade esto a tu archivo de configuración de servidores MCP:

3) Herramientas que obtiene el agente

• list_objects: descubre los objetos disponibles (leads, contactos, empresas, oportunidades y objetos personalizados).
• describe_object: descubre los campos de un objeto: apiName, etiqueta, tipo, si es obligatorio, las opciones aceptadas por un select y el objeto destino de un lookup. Llámalo antes de crear o actualizar.
• list_records: lista y busca registros de un objeto (búsqueda, filtros de campo, orden, paginación).
• get_record: obtiene un registro por id.
• create_record: crea un registro (por ejemplo, un nuevo lead de prospección).
• update_record: actualiza campos de un registro existente.
• delete_record: mueve un registro a la papelera (reversible). Solo funciona cuando la clave de API tiene habilitado el alcance de eliminación, que viene desactivado por defecto.
• bulk_create_records: crea hasta 500 registros en una sola llamada, con éxito o fallo reportado por elemento.
• bulk_update_records: actualiza hasta 500 registros por id en una sola llamada, con éxito o fallo reportado por elemento.
• export_records: devuelve los registros de un objeto como filas tabulares planas con columnas estables, con updated_since y created_since para sincronización incremental. Hecho para herramientas de BI y automatización.
• list_activities: lista las actividades de un registro (su línea de tiempo) o las más recientes del workspace.
• create_activity: registra una tarea por hacer, o una llamada, correo, reunión o nota que ya ocurrió.
• update_activity: completa, reabre, reprograma, reasigna o registra el resultado de una actividad.
• delete_activity: elimina una actividad. Requiere el alcance de eliminación.
• list_attachments: lista los archivos adjuntos a un registro.
• get_attachment: devuelve los metadatos de un adjunto y un enlace de descarga firmado que expira en 5 minutos.
• create_attachment_upload_url: paso 1 de una subida: devuelve una URL firmada donde se envían los bytes del archivo con PUT (máximo 25 MB).
• register_attachment: paso 2 de una subida: registra el archivo subido en el registro para que aparezca en la línea de tiempo.
• delete_attachment: elimina un adjunto y su archivo. Irreversible, por eso requiere el alcance de eliminación.
• list_inventory: saldo de stock, cantidad reservada y disponible por producto, de un producto, o solo los productos por debajo del mínimo.
• list_line_items: líneas de producto de una oportunidad (cantidad, precio, descuento, impuesto) y el total recalculado.
• add_line_item: agrega una línea de producto a una oportunidad. Los totales y el monto de la oportunidad se recalculan con el mismo motor que usa la pantalla.
• update_line_item: cambia cantidad, precio, descuento, impuesto, plazo o descripción de una línea de producto.
• delete_line_item: elimina una línea de producto de una oportunidad.
• send_marketing_email: envía un correo de marketing (para, asunto, html) a través del proveedor configurado, con el pie de baja agregado automáticamente.

Referencia completa de la API REST y del MCP (endpoints, parámetros, formato de error, rate limit y descubrimiento de campos): consulta el artículo "Referencia para desarrolladores: API REST y MCP", aquí en el Centro de Ayuda.

Cómo probar

1. Conecta el agente y pídele algo como "lista los objetos de mi CRM": debería llamar a list_objects y traer la lista.
2. Pide "crea un lead llamado Ana Souza con correo ana@acme.com": el agente llama a create_record y devuelve el id del registro creado.
3. Confirma en el CRM que el registro aparece en la lista del objeto.

Solución de problemas

• 401 Unauthorized: la API key falta o es incorrecta. Genera una nueva en Configuración → API y desarrolladores y reconfigura el agente con Authorization: Bearer sk_...
• El agente no ve el servidor: confirma la URL https://TU-CRM/api/mcp y, en Claude Desktop, que el bloque mcpServers está en el archivo de configuración y la app se reinició.
• Una acción fue rechazada: el MCP respeta los permisos (RBAC) y las validaciones del CRM; el mensaje de error explica el motivo (campo obligatorio, sin permiso, límite del plan, etc.).
• Solo veo mis datos: correcto, cada API key está aislada a su tenant dueño; el agente nunca ve datos de otra empresa.

Abrir este artículo dentro del sistema →