Propuestas

Gestión de propuestas a través de MCP. Crea, envía y gestiona propuestas de clientes con seguimiento completo del ciclo de vida desde borrador hasta conversión en proyecto.

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 proposal proporciona 9 acciones que cubren el ciclo completo de propuestas — desde redactar y enviar propuestas hasta la aprobación del cliente, manejo de rechazos y conversión en proyectos activos. Cada operación del pipeline de ventas disponible en la aplicación web de GitScrum es accesible a través de conversación en lenguaje natural con tu asistente de IA.

Las propuestas son el puente entre ventas y entrega. Cuando un cliente aprueba una propuesta, la acción convert la transforma en un proyecto completamente configurado, trasladando alcance, presupuesto y asociación de cliente. El MCP Server le da a tu asistente de IA la capacidad de gestionar todo este pipeline — calificar leads, construir propuestas, cerrar acuerdos e iniciar proyectos — sin cambiar de contexto.

Resumen de acciones

Acción	Propósito	Parámetros requeridos
`list`	Listar propuestas en un workspace	`company_slug`
`get`	Obtener detalles completos de una propuesta específica	`uuid`, `company_slug`
`stats`	Obtener métricas del pipeline de propuestas	`company_slug`
`create`	Crear un nuevo borrador de propuesta	`company_slug`, `title`
`update`	Modificar un borrador de propuesta	`uuid`, `company_slug`
`send`	Enviar una propuesta al cliente (borrador → enviada)	`uuid`, `company_slug`
`approve`	Marcar una propuesta como aprobada (enviada → aprobada)	`uuid`, `company_slug`
`reject`	Marcar una propuesta como rechazada	`uuid`, `company_slug`
`convert`	Convertir una propuesta aprobada en proyecto	`uuid`, `company_slug`

Ciclo de vida del estado

Cada propuesta sigue una progresión de estado definida. El MCP Server aplica transiciones válidas — no puedes aprobar un borrador que no ha sido enviado, y las propuestas rechazadas no pueden convertirse en proyectos.

  ┌───────────┐    send     ┌──────────┐    approve    ┌──────────┐   convert   ┌───────────┐
  │ Borrador  │ ──────────► │ Enviada  │ ────────────► │ Aprobada │ ──────────► │ Proyecto  │
  └───────────┘             └──────────┘               └──────────┘             └───────────┘
                                │
                                │     reject
                                ▼
                           ┌──────────┐
                           │ Rechazada│
                           └──────────┘

Borrador (Draft) — Estado inicial. Editable. Puede enviarse.
Enviada (Sent) — Entregada al cliente. Esperando respuesta. Puede aprobarse o rechazarse.
Aprobada (Approved) — El cliente aceptó. Puede convertirse en proyecto.
Rechazada (Rejected) — El cliente declinó. Estado terminal.
Convertida (Converted) — Transformada en proyecto activo. Estado terminal.

Listar propuestas

La acción list devuelve las propuestas dentro de un workspace. Filtra por estado o cliente para enfocarte en etapas específicas del pipeline.

Parámetros requeridos

Parámetro	Tipo	Descripción
`company_slug`	string	Identificador del workspace (de la herramienta `workspace`)

Parámetros opcionales

Parámetro	Tipo	Descripción
`status`	string	Filtrar por estado: `draft`, `sent`, `approved`, `rejected`
`client_uuid`	string	Filtrar por UUID del cliente (de la herramienta `client`)

Ejemplos de prompts

You:  "Muestra todas las propuestas"
AI:   Llama a proposal action=list → devuelve lista de propuestas con estado y montos

You:  "Lista las propuestas enviadas esperando respuesta"
AI:   Llama a proposal action=list con status="sent"

You:  "Muestra todas las propuestas de Acme Corp"
AI:   Encuentra UUID del cliente → llama a proposal action=list con client_uuid

You:  "¿Qué propuestas fueron rechazadas este mes?"
AI:   Llama a proposal action=list con status="rejected" → la IA filtra por fecha

Obtener detalles de propuesta

La acción get devuelve la propuesta completa — título, cliente, contenido, monto, moneda, período de validez, estado y línea de tiempo de actividad.

Parámetros requeridos

Parámetro	Tipo	Descripción
`uuid`	string	UUID de la propuesta (de la respuesta de `list`)
`company_slug`	string	Identificador del workspace

You:  "Muéstrame la propuesta de rediseño del sitio web"
AI:   Encuentra la propuesta → llama a proposal action=get → devuelve detalles completos de la propuesta

You:  "¿Cuál es el valor total de la propuesta de TechStart?"
AI:   Llama a proposal action=get → extrae total_amount y currency

Estadísticas de propuestas

La acción stats devuelve métricas del pipeline a nivel de workspace — total de propuestas, tasas de conversión, tamaño promedio de acuerdos, valor del pipeline por estado y ratios de ganancia/pérdida. Estos números impulsan el dashboard del pipeline de ventas.

Parámetros requeridos

Parámetro	Tipo	Descripción
`company_slug`	string	Identificador del workspace

You:  "Muestra las estadísticas de propuestas"
AI:   Llama a proposal action=stats → devuelve valor del pipeline, tasa de conversión, métricas de acuerdos

You:  "¿Cuál es nuestra tasa de victoria en propuestas?"
AI:   Llama a proposal action=stats → extrae el ratio de ganancia/pérdida

You:  "¿Cuánto hay en el pipeline?"
AI:   Llama a proposal action=stats → devuelve el valor total de propuestas enviadas

Crear propuestas

La acción create construye un nuevo borrador de propuesta. Puedes incluir la asociación de cliente, contenido detallado en formato Markdown, términos financieros y un período de validez en una sola llamada.

Parámetros requeridos

Parámetro	Tipo	Descripción
`company_slug`	string	Identificador del workspace
`title`	string	Título de la propuesta o nombre del proyecto

Parámetros opcionales

Parámetro	Tipo	Descripción
`contactcompanyuuid`	string	UUID del cliente a asociar (de la herramienta `client`)
`content`	string	Cuerpo de la propuesta en formato Markdown — alcance, entregables, cronograma
`total_amount`	number	Valor total de la propuesta (ej. `15000`)
`currency`	string	Código de moneda: `USD`, `EUR`, `BRL` (predeterminado: moneda del workspace)
`valid_until`	string	Fecha de expiración de la propuesta en formato `YYYY-MM-DD`

Ejemplos de prompts

You:  "Crea una propuesta para Acme Corp: Rediseño de Sitio Web, $15,000, válida hasta el 30 de marzo"
AI:   Encuentra UUID del cliente → llama a proposal action=create con title="Website Redesign",
      contact_company_uuid, total_amount=15000, currency="USD",
      valid_until="2026-03-30"

You:  "Redacta una propuesta para TechStart — Desarrollo de App Móvil, €25,000"
AI:   Llama a proposal action=create con title="Mobile App Development",
      contact_company_uuid, total_amount=25000, currency="EUR"

You:  "Crea una propuesta para Global Media con alcance detallado:
       ## Entregables
       - Rediseño de identidad de marca
       - Sitio web (10 páginas)
       - Plantillas de redes sociales
       Total: $8,500"
AI:   Llama a proposal action=create con título, content (Markdown),
      total_amount=8500, contact_company_uuid

Actualizar propuestas

La acción update modifica un borrador de propuesta. Solo las propuestas en estado Borrador pueden actualizarse — una vez enviadas, la propuesta se bloquea para preservar el registro de lo que se presentó al cliente.

Parámetros requeridos

Parámetro	Tipo	Descripción
`uuid`	string	UUID de la propuesta
`company_slug`	string	Identificador del workspace

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

You:  "Actualiza el monto de la propuesta del sitio web a $18,000"
AI:   Llama a proposal action=update con total_amount=18000

You:  "Extiende la validez de la propuesta hasta el 15 de abril"
AI:   Llama a proposal action=update con valid_until="2026-04-15"

You:  "Agrega detalles de alcance a la propuesta de TechStart"
AI:   Llama a proposal action=update con content (Markdown)

Enviar propuestas

La acción send transiciona una propuesta de Borrador a Enviada. Esto entrega la propuesta al cliente y la bloquea de futuras ediciones. El cambio de estado se registra con una marca de tiempo.

Parámetros requeridos

Parámetro	Tipo	Descripción
`uuid`	string	UUID de la propuesta
`company_slug`	string	Identificador del workspace

You:  "Envía la propuesta de rediseño del sitio web a Acme Corp"
AI:   Llama a proposal action=send → la propuesta transiciona de Borrador a Enviada

You:  "Envía todas las propuestas en borrador"
AI:   Lista los borradores de propuestas → llama a proposal action=send para cada una

Aprobar propuestas

La acción approve marca una propuesta enviada como aprobada por el cliente. Esto desbloquea la acción convert, que transforma la propuesta en un proyecto.

Parámetros requeridos

Parámetro	Tipo	Descripción
`uuid`	string	UUID de la propuesta
`company_slug`	string	Identificador del workspace

You:  "Acme Corp aprobó la propuesta de rediseño del sitio web"
AI:   Llama a proposal action=approve → la propuesta transiciona a Aprobada

You:  "Marca la propuesta de TechStart como aprobada"
AI:   Llama a proposal action=approve → lista para conversión a proyecto

Rechazar propuestas

La acción reject marca una propuesta enviada como rechazada. Opcionalmente puedes proporcionar la razón del cliente para declinar, que se almacena en el historial de la propuesta para análisis del pipeline.

Parámetros requeridos

Parámetro	Tipo	Descripción
`uuid`	string	UUID de la propuesta
`company_slug`	string	Identificador del workspace

Parámetros opcionales

Parámetro	Tipo	Descripción
`reason`	string	Razón del cliente para el rechazo (almacenada en el historial de la propuesta)

You:  "Global Media rechazó la propuesta — restricciones presupuestarias"
AI:   Llama a proposal action=reject con reason="Budget constraints"

You:  "Marca la propuesta de app móvil como rechazada"
AI:   Llama a proposal action=reject → la propuesta transiciona a Rechazada

Convertir propuestas en proyectos

La acción convert es el puente entre ventas y entrega. Transforma una propuesta aprobada en un proyecto completamente configurado, trasladando el título, la asociación de cliente y el alcance. Este es el momento en que un acuerdo se convierte en trabajo activo.

Parámetros requeridos

Parámetro	Tipo	Descripción
`uuid`	string	UUID de la propuesta (debe estar en estado Aprobada)
`company_slug`	string	Identificador del workspace

You:  "Convierte la propuesta de Acme Corp en un proyecto"
AI:   Llama a proposal action=convert → crea proyecto vinculado al cliente

You:  "Aprueba y convierte la propuesta de TechStart"
AI:   Llama a proposal action=approve → luego llama a proposal action=convert

You:  "El rediseño del sitio web está aprobado — configura el proyecto"
AI:   Encuentra la propuesta aprobada → llama a proposal action=convert → devuelve nuevo proyecto

Flujo del pipeline de ventas

Para agencias que gestionan su pipeline de ventas a través de MCP, este flujo cubre el ciclo completo de propuestas:

1. Crear la propuesta

Redacta una propuesta con alcance, precios y asociación de cliente.

You:  "Crea una propuesta para Acme Corp: Plataforma E-commerce, $45,000,
       válida hasta el 30 de marzo. Incluye alcance: diseño, desarrollo, QA, despliegue."
AI:   Una sola llamada create con todos los campos y contenido en Markdown

2. Revisar y refinar

Revisa el borrador antes de presentarlo al cliente.

You:  "Muéstrame la propuesta de Acme Corp"
AI:   Llama a proposal action=get → muestra la propuesta completa para revisión

You:  "Aumenta el monto a $48,000 y extiende la validez hasta el 15 de abril"
AI:   Llama a proposal action=update con nuevo monto y fecha

3. Enviar al cliente

Entrega la propuesta.

You:  "Envía la propuesta de e-commerce a Acme Corp"
AI:   Llama a proposal action=send → la propuesta se entrega y bloquea

4. Manejar la respuesta

Registra la decisión del cliente.

You:  "Acme Corp aprobó la propuesta"
AI:   Llama a proposal action=approve → lista para conversión

You:  "Conviértela en proyecto"
AI:   Llama a proposal action=convert → proyecto creado y vinculado al cliente

5. Monitorear el pipeline

Da seguimiento a la salud general del pipeline de ventas.

You:  "Muéstrame el pipeline de propuestas"
AI:   Llama a proposal action=stats → resume valor del pipeline, tasas de conversión, ganancia/pérdida

You:  "¿Qué propuestas siguen esperando respuesta?"
AI:   Llama a proposal action=list con status="sent" → muestra las propuestas pendientes

Próximos pasos

Clientes: Gestiona registros de clientes vinculados a tus propuestas.
Facturas: Crea facturas para propuestas aprobadas y convertidas.
Dashboards ClientFlow: Accede a analíticas del pipeline y métricas de conversión.
Proyectos: Gestiona la entrega de proyectos después de la conversión de propuestas.