Clientes

Código Abierto — GitScrum MCP Server es código abierto bajo la licencia MIT. Disponible en npm y en GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor y cualquier cliente compatible con MCP tienen acceso operacional completo a tu stack de gestión de proyectos.

La herramienta client proporciona 5 acciones para gestionar relaciones con clientes dentro de ClientFlow CRM de GitScrum. Agencias, consultorías y proveedores de servicios usan esta herramienta para mantener una base de datos centralizada de clientes que se conecta directamente con proyectos, propuestas y facturas. Cada operación de clientes disponible en la aplicación web de GitScrum — crear contactos, actualizar detalles, revisar métricas del portafolio — es accesible a través de conversación en lenguaje natural con tu asistente de IA.

Los clientes son la base de ClientFlow CRM. Una vez que existe un registro de cliente, puede vincularse a proyectos para seguimiento de entrega, propuestas para gestión del pipeline de ventas y facturas para automatización de facturación. El MCP Server le da a tu asistente de IA la capacidad de gestionar todo este ciclo de vida del cliente sin cambiar de contexto.

Resumen de acciones

Listar clientes

La acción list devuelve todos los clientes dentro de un workspace. Puedes filtrar opcionalmente por estado y paginar los resultados. Cada cliente en la respuesta incluye su uuid, que es necesario para todas las operaciones específicas del cliente y para vincular clientes a proyectos, propuestas y facturas.

Parámetros requeridos

Parámetros opcionales

Ejemplos de prompts

You:  "Muestra todos mis clientes"
AI:   Llama a client action=list → devuelve lista de clientes con UUIDs, nombres y estado

You:  "Lista solo los clientes activos"
AI:   Llama a client action=list con status="active"

You:  "Muestra la segunda página de clientes"
AI:   Llama a client action=list con page=2

Obtener detalles del cliente

La acción get devuelve el registro completo del cliente — nombre, información de contacto, detalles de la empresa, proyectos asociados, propuestas vinculadas, historial de facturas y línea de tiempo de actividad. Esta es la vista completa del perfil del cliente.

Parámetros requeridos

You:  "Muéstrame los detalles de Acme Corp"
AI:   Encuentra el cliente por nombre → llama a client action=get → devuelve perfil completo del cliente

You:  "¿Cuál es la información de contacto de nuestro cliente TechStart?"
AI:   Llama a client action=get → extrae email, teléfono y dirección

Crear clientes

La acción create agrega un nuevo registro de cliente al workspace. Todos los campos de contacto y empresa pueden establecerse en el momento de creación en una sola llamada — no se requieren actualizaciones posteriores.

Parámetros requeridos

Parámetros opcionales

Ejemplos de prompts

You:  "Agrega un nuevo cliente 'Acme Corp' con email contact@acme.com"
AI:   Llama a client action=create con name="Acme Corp", email="contact@acme.com"

You:  "Crea un registro de cliente para John Smith en TechStart, teléfono 555-0100,
       sitio web techstart.io"
AI:   Llama a client action=create con name="John Smith", company_name="TechStart",
      phone="555-0100", website="techstart.io"

You:  "Agrega cliente 'Global Media' con nota: 'Referido por Sarah, prefiere contacto por email'"
AI:   Llama a client action=create con name="Global Media",
      notes="Referido por Sarah, prefiere contacto por email"

Actualizar clientes

La acción update modifica cualquier campo en un registro de cliente existente. Solo los campos que especifiques se modifican — todos los demás campos permanecen intactos. Es útil para actualizar datos de contacto, agregar notas o corregir información.

Parámetros requeridos

Todos los parámetros opcionales de create están disponibles en update.

Ejemplos de prompts

You:  "Actualiza el email de Acme Corp a hello@acme.com"
AI:   Encuentra el cliente → llama a client action=update con email="hello@acme.com"

You:  "Agrega una nota a Global Media: 'Contrato renovado para Q2'"
AI:   Llama a client action=update con notes="Contrato renovado para Q2"

You:  "Cambia el sitio web de TechStart a www.techstart.com"
AI:   Llama a client action=update con website="www.techstart.com"

Estadísticas de clientes

La acción stats devuelve métricas de clientes a nivel de workspace — total de clientes, conteo activos vs inactivos, ingresos por cliente, distribución de proyectos y tendencias de engagement. Estos son los números que alimentan el dashboard de ClientFlow CRM.

Parámetros requeridos

You:  "Dame las estadísticas de clientes"
AI:   Llama a client action=stats → devuelve total de clientes, conteo activos, métricas de ingresos

You:  "¿Cuántos clientes activos tenemos?"
AI:   Llama a client action=stats → extrae el conteo de clientes activos

You:  "Muéstrame el resumen de clientes de mi agencia"
AI:   Llama a client action=stats → resume la salud del portafolio de clientes

Flujo de trabajo CRM

Los clientes se conectan con cada parte del ecosistema de ClientFlow CRM. Así es como la herramienta de clientes se integra con otras herramientas para un flujo de trabajo completo de agencia:

1. Registrar el cliente

Comienza creando un registro de cliente con toda la información de contacto relevante.

You:  "Agrega un nuevo cliente 'Acme Corp', email contact@acme.com, nombre de empresa 'Acme Corporation',
       sitio web acme.com. Nota: Cuenta enterprise, 50+ empleados"
AI:   Llama a client action=create → devuelve UUID del cliente para vinculación

2. Crear una propuesta

Usa el UUID del cliente para crear una propuesta vinculada a este cliente.

You:  "Crea una propuesta para Acme Corp: Rediseño de Sitio Web, $15,000"
AI:   Encuentra UUID del cliente → llama a proposal action=create con contact_company_uuid

3. Convertir a proyecto

Cuando la propuesta es aprobada, conviértela en un proyecto activo.

You:  "Aprueba la propuesta de Acme Corp y conviértela en proyecto"
AI:   Llama a proposal action=approve → llama a proposal action=convert

4. Facturar el trabajo

Genera facturas vinculadas al cliente para facturación.

You:  "Crea una factura para Acme Corp, $5,000 por entrega de Fase 1"
AI:   Llama a invoice action=create con client_uuid → borrador de factura listo para enviar

5. Monitorear la relación

Da seguimiento a la salud del cliente a través de estadísticas y dashboards.

You:  "Muéstrame el resumen de clientes"
AI:   Llama a client action=stats → resume las métricas del portafolio

Vincular clientes a proyectos

Al crear un proyecto a través de la herramienta project, puedes pasar el UUID del cliente como parámetro client_uuid. Esto vincula el proyecto al registro del cliente, habilitando:

• Listados de proyectos con alcance por cliente
• Atribución de ingresos por cliente
• Acceso al portal del cliente (si está configurado)
• Reportes consolidados de todos los proyectos del cliente

You:  "Crea un proyecto 'Rediseño Web Acme' vinculado a Acme Corp"
AI:   Encuentra UUID del cliente → llama a project action=create con client_uuid

Próximos pasos

• Facturas: Crea y gestiona facturas para tus clientes.
• Propuestas: Construye y envía propuestas para convertir leads en proyectos.
• Dashboards ClientFlow: Accede a analíticas de CRM y reportes entre workspaces.
• Proyectos: Gestiona la entrega de proyectos para tus clientes.