MCP Server Conecta Mirlo con Claude Desktop o Claude Code via Model Context Protocol
Conecta tu CRM, mensajeria, voz y flujos de automatizacion de Mirlo con Claude. Gestiona oportunidades, contactos, tickets, tareas, conversaciones de WhatsApp, llamadas y workflows usando lenguaje natural.
Ingresa a app.mirlo.com
Ve a Mi Organizacion → API Keys
Haz click en + Crear API Key
Copia la key (empieza con sk_live_)
Abre Claude Desktop
Ve a Settings → Developer → Edit Config
Reemplaza el contenido con:
{ "mcpServers" : { "mirlo" : { "command" : "npx" , "args" : [ "-y" , "mirlo-mcp" , "--api-key=TU_API_KEY_AQUI" ] } } }
Reemplaza TU_API_KEY_AQUI con tu API Key
Guarda el archivo y reinicia Claude Desktop
claude mcp add mirlo -- npx -y mirlo-mcp --api-key=sk_live_xxx
Seguridad
Nunca compartas tu API Key publicamente
No incluyas el API Key en repositorios de codigo
Usa variables de entorno si necesitas compartir la configuracion
Accion Ejemplo Listar deals "Dame las oportunidades abiertas ordenadas por monto" Buscar deals "¿Hay deals que cierran esta semana?" Crear deal "Crea una oportunidad para Acme Corp por $50,000" Actualizar deal "Cambia el monto del deal de Acme a $75,000" Mover de etapa "Mueve el deal de Acme a Negociacion" Eliminar deal "Elimina el deal duplicado de prueba" Filtrar por tiempo "¿Que deals llevan mas de 24 horas en Prospecto?"
Accion Ejemplo Buscar contactos "Buscame los contactos de la empresa Cafe Digital" Ver contacto "Dame los datos del contacto Ana Garcia" Crear contacto "Crea un contacto: Ana Garcia, ana@empresa.com " Actualizar contacto "Actualiza el telefono de Ana a +52 55 9876 5432"
Accion Ejemplo Listar cuentas "¿Que cuentas tenemos en la industria Tecnologia?" Ver cuenta "Dame los detalles de la cuenta Farmacias del Ahorro" Crear cuenta "Crea una cuenta para Cafe Digital, industria alimentos" Actualizar cuenta "Actualiza el dominio de Cafe Digital a cafedigital.mx"
Accion Ejemplo Ver tickets abiertos "¿Cuantos tickets abiertos hay?" Ver ticket "Dame los detalles del ticket SOT-1042" Crear ticket "Crea un ticket urgente: Error en la integracion" Actualizar ticket "Cambia la prioridad del ticket a urgente" Agregar nota "Agrega una nota interna al ticket: Ya se contacto al cliente" Filtrar por prioridad "Muestra los tickets de prioridad alta"
Accion Ejemplo Ver tareas pendientes "¿Que tareas tengo para hoy?" Tareas vencidas "¿Hay tareas vencidas?" Crear tarea "Crea una tarea para llamar a Ana Garcia mañana" Actualizar tarea "Cambia la prioridad de la tarea a alta" Completar tarea "Marca como completada la tarea de llamar a Ana"
Accion Ejemplo Ver pipelines "¿Que pipelines tengo y cuales son sus etapas?"
Accion Ejemplo Enviar mensaje "Manda un WhatsApp a +52 55 1234 5678 diciendo: Hola, te contacto de Mirlo" Enviar template "Envia el template de bienvenida a +52 55 1234 5678" Ver conversaciones "Muestra las ultimas conversaciones" Ver mensajes "Muestra los mensajes de la conversacion con Ana"
Accion Ejemplo Ver llamadas "¿Cuantas llamadas entrantes hubo hoy?" Transcripcion "Dame la transcripcion de la ultima llamada"
Accion Ejemplo Listar flujos "¿Que flujos tengo activos?" Ver flujo "Dame los detalles del flujo de bienvenida" Crear flujo "Crea un flujo de mensajeria llamado Seguimiento Postventa" Duplicar flujo "Duplica el flujo de bienvenida" Publicar flujo "Publica el flujo de onboarding" Pausar flujo "Pausa el flujo de cobranza" Archivar flujo "Archiva el flujo de prueba" Ver ejecuciones "¿Cuantas ejecuciones tuvo el flujo esta semana?" Detalle ejecucion "Muestra que paso en la ultima ejecucion fallida" Estadisticas "¿Cual es la tasa de exito del flujo de ventas?" Probar flujo "Prueba el flujo con un payload de prueba" Catalogo de nodos "¿Que tipos de nodos puedo usar en un flujo?" Exportar flujo "Exporta el flujo de bienvenida como JSON" Importar flujo "Importa este flujo desde el JSON" Carpetas "Crea una carpeta llamada Cobranza para organizar mis flujos"
npm install -g mirlo-mcp mirlo-mcp --api-key=sk_live_xxx MIRLO_API_KEY = sk_live_xxx # API key (requerida) MIRLO_BASE_URL = https://... # URL base (opcional, default: api.mirlo.com) MIRLO_ORG_ID = uuid # Organization UUID (opcional, auto-detectado) Modulo Tools CRM — Deals (6)mirlo_list_deals, mirlo_get_deal, mirlo_create_deal, mirlo_update_deal, mirlo_move_deal_stage, mirlo_delete_dealCRM — Contacts (4)mirlo_list_contacts, mirlo_get_contact, mirlo_create_contact, mirlo_update_contactCRM — Accounts (4)mirlo_list_accounts, mirlo_get_account, mirlo_create_account, mirlo_update_accountCRM — Tickets (5)mirlo_list_tickets, mirlo_get_ticket, mirlo_create_ticket, mirlo_update_ticket, mirlo_add_ticket_noteCRM — Tasks (5)mirlo_list_tasks, mirlo_get_task, mirlo_create_task, mirlo_update_task, mirlo_complete_taskCRM — Pipelines (1)mirlo_list_pipelinesMessaging (4)mirlo_send_message, mirlo_send_template, mirlo_list_conversations, mirlo_list_messagesVoice (2)mirlo_list_calls, mirlo_get_call_transcriptFlows (18)mirlo_list_flows, mirlo_get_flow, mirlo_create_flow, mirlo_update_flow, mirlo_delete_flow, mirlo_duplicate_flow, mirlo_publish_flow, mirlo_pause_flow, mirlo_archive_flow, mirlo_list_flow_executions, mirlo_get_flow_execution, mirlo_get_flow_stats, mirlo_test_flow, mirlo_get_node_catalog, mirlo_export_flow, mirlo_import_flow, mirlo_list_flow_folders, mirlo_create_flow_folder
Problema Solucion Claude no encuentra las herramientas de Mirlo Reinicia Claude Desktop despues de editar la configuracion. Verifica que tu API Key es valida en app.mirlo.com → API Keys Error de autenticacion Tu API Key puede haber expirado. Genera una nueva en Mi Organizacion → API Keys npx no se encuentraInstala Node.js desde nodejs.org
¿Necesitas ayuda? Contactanos en mirlo.com o por WhatsApp.
