Propostas

Gerenciamento de propostas pelo MCP. Crie, envie e gerencie propostas de clientes com acompanhamento completo do ciclo de vida, do rascunho à conversão em projeto.

Código Aberto — O GitScrum MCP Server é código aberto sob a licença MIT. Disponível no npm e no GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor e qualquer cliente compatível com MCP têm acesso operacional completo à sua stack de gerenciamento de projetos.

A ferramenta proposal fornece 9 ações cobrindo o ciclo completo de propostas — desde a elaboração e envio de propostas até a aprovação do cliente, tratamento de rejeição e conversão em projetos ativos. Toda operação de pipeline de vendas disponível no aplicativo web GitScrum é acessível através de conversa em linguagem natural com seu assistente de IA.

Propostas fazem a ponte entre vendas e entrega. Quando um cliente aprova uma proposta, a ação convert a transforma em um projeto totalmente configurado, carregando escopo, orçamento e associação com o cliente. O MCP Server dá ao seu assistente de IA a capacidade de gerenciar todo este pipeline — qualificar leads, construir propostas, fechar negócios e iniciar projetos — sem trocar de contexto.

Visão Geral das Ações

Ação	Propósito	Parâmetros Obrigatórios
`list`	Listar propostas de um workspace	`company_slug`
`get`	Obter detalhes completos de uma proposta específica	`uuid`, `company_slug`
`stats`	Obter métricas de pipeline de propostas	`company_slug`
`create`	Criar uma nova proposta em rascunho	`company_slug`, `title`
`update`	Modificar uma proposta em rascunho	`uuid`, `company_slug`
`send`	Enviar uma proposta ao cliente (rascunho → enviada)	`uuid`, `company_slug`
`approve`	Marcar uma proposta como aprovada (enviada → aprovada)	`uuid`, `company_slug`
`reject`	Marcar uma proposta como rejeitada	`uuid`, `company_slug`
`convert`	Converter uma proposta aprovada em projeto	`uuid`, `company_slug`

Ciclo de Vida de Status

Toda proposta segue uma progressão de status definida. O MCP Server aplica transições válidas — você não pode aprovar um rascunho que não foi enviado, e propostas rejeitadas não podem ser convertidas em projetos.

  ┌──────────┐     send      ┌──────────┐    approve     ┌──────────┐    convert    ┌─────────┐
  │ Rascunho │ ─────────────► │ Enviada  │ ─────────────► │ Aprovada │ ────────────► │ Projeto │
  └──────────┘                └──────────┘                └──────────┘              └─────────┘
                                  │
                                  │     reject
                                  ▼
                             ┌───────────┐
                             │ Rejeitada │
                             └───────────┘

Rascunho — Estado inicial. Editável. Pode ser enviada.
Enviada — Entregue ao cliente. Aguardando resposta. Pode ser aprovada ou rejeitada.
Aprovada — Cliente aceitou. Pode ser convertida em projeto.
Rejeitada — Cliente recusou. Estado terminal.
Convertida — Transformada em projeto ativo. Estado terminal.

Listando Propostas

A ação list retorna propostas dentro de um workspace. Filtre por status ou cliente para focar em estágios específicos do pipeline.

Parâmetros Obrigatórios

Parameter	Type	Description
`company_slug`	string	Identificador do workspace (da ferramenta `workspace`)

Parâmetros Opcionais

Parameter	Type	Description
`status`	string	Filtrar por status: `draft`, `sent`, `approved`, `rejected`
`client_uuid`	string	Filtrar por UUID do cliente (da ferramenta `client`)

Exemplos de Prompts

You:  "Mostre todas as propostas"
AI:   Chama proposal action=list → retorna lista de propostas com status e valores

You:  "Liste propostas enviadas aguardando resposta"
AI:   Chama proposal action=list com status="sent"

You:  "Mostre todas as propostas da Acme Corp"
AI:   Encontra UUID do cliente → chama proposal action=list com client_uuid

You:  "Quais propostas foram rejeitadas este mês?"
AI:   Chama proposal action=list com status="rejected" → AI filtra por data

Obtendo Detalhes da Proposta

A ação get retorna a proposta completa — título, cliente, conteúdo, valor, moeda, período de validade, status e linha do tempo de atividades.

Parâmetros Obrigatórios

Parameter	Type	Description
`uuid`	string	UUID da proposta (da resposta `list`)
`company_slug`	string	Identificador do workspace

You:  "Mostre a proposta de redesign do site"
AI:   Encontra a proposta → chama proposal action=get → retorna detalhes completos da proposta

You:  "Qual é o valor total da proposta da TechStart?"
AI:   Chama proposal action=get → extrai total_amount e currency

Estatísticas de Propostas

A ação stats retorna métricas de pipeline no nível do workspace — total de propostas, taxas de conversão, tamanho médio de negócio, valor do pipeline por status e taxas de ganho/perda. Esses números alimentam o dashboard de pipeline de vendas.

Parâmetros Obrigatórios

Parameter	Type	Description
`company_slug`	string	Identificador do workspace

You:  "Mostre as estatísticas de propostas"
AI:   Chama proposal action=stats → retorna valor do pipeline, taxa de conversão, métricas de negócios

You:  "Qual é nossa taxa de conversão de propostas?"
AI:   Chama proposal action=stats → extrai taxa de ganho/perda

You:  "Quanto está no pipeline?"
AI:   Chama proposal action=stats → retorna valor total de propostas enviadas

Criando Propostas

A ação create constrói uma nova proposta em rascunho. Você pode incluir a associação com cliente, conteúdo detalhado em formato Markdown, termos financeiros e período de validade em uma única chamada.

Parâmetros Obrigatórios

Parameter	Type	Description
`company_slug`	string	Identificador do workspace
`title`	string	Título da proposta ou nome do projeto

Parâmetros Opcionais

Parameter	Type	Description
`contactcompanyuuid`	string	UUID do cliente para associar (da ferramenta `client`)
`content`	string	Corpo da proposta em formato Markdown — escopo, entregas, cronograma
`total_amount`	number	Valor total da proposta (ex: `15000`)
`currency`	string	Código da moeda: `USD`, `EUR`, `BRL` (padrão: moeda do workspace)
`valid_until`	string	Data de expiração da proposta no formato `YYYY-MM-DD`

Exemplos de Prompts

You:  "Crie uma proposta para a Acme Corp: Redesign do Site, $15.000, válida até 30 de março"
AI:   Encontra UUID do cliente → chama proposal action=create com title="Website Redesign",
      contact_company_uuid, total_amount=15000, currency="USD",
      valid_until="2026-03-30"

You:  "Elabore uma proposta para a TechStart — Desenvolvimento de App Mobile, €25.000"
AI:   Chama proposal action=create com title="Mobile App Development",
      contact_company_uuid, total_amount=25000, currency="EUR"

You:  "Crie uma proposta para a Global Media com escopo detalhado:
       ## Entregas
       - Redesign de identidade visual
       - Site (10 páginas)
       - Templates de redes sociais
       Total: $8.500"
AI:   Chama proposal action=create com title, content (Markdown),
      total_amount=8500, contact_company_uuid

Atualizando Propostas

A ação update modifica uma proposta em rascunho. Apenas propostas no status Rascunho podem ser atualizadas — uma vez enviadas, a proposta é bloqueada para preservar o registro do que foi apresentado ao cliente.

Parâmetros Obrigatórios

Parameter	Type	Description
`uuid`	string	UUID da proposta
`company_slug`	string	Identificador do workspace

Todos os parâmetros opcionais de create estão disponíveis em update.

You:  "Atualize o valor da proposta do site para $18.000"
AI:   Chama proposal action=update com total_amount=18000

You:  "Estenda a validade da proposta até 15 de abril"
AI:   Chama proposal action=update com valid_until="2026-04-15"

You:  "Adicione detalhes de escopo à proposta da TechStart"
AI:   Chama proposal action=update com content (Markdown)

Enviando Propostas

A ação send transiciona uma proposta de Rascunho para Enviada. Isso entrega a proposta ao cliente e bloqueia edições. A mudança de status é registrada com um timestamp.

Parâmetros Obrigatórios

Parameter	Type	Description
`uuid`	string	UUID da proposta
`company_slug`	string	Identificador do workspace

You:  "Envie a proposta de redesign do site para a Acme Corp"
AI:   Chama proposal action=send → proposta transiciona de Rascunho para Enviada

You:  "Envie todas as propostas em rascunho"
AI:   Lista propostas em rascunho → chama proposal action=send para cada uma

Aprovando Propostas

A ação approve marca uma proposta enviada como aprovada pelo cliente. Isso desbloqueia a ação convert, que transforma a proposta em projeto.

Parâmetros Obrigatórios

Parameter	Type	Description
`uuid`	string	UUID da proposta
`company_slug`	string	Identificador do workspace

You:  "A Acme Corp aprovou a proposta de redesign do site"
AI:   Chama proposal action=approve → proposta transiciona para Aprovada

You:  "Marque a proposta da TechStart como aprovada"
AI:   Chama proposal action=approve → pronta para conversão em projeto

Rejeitando Propostas

A ação reject marca uma proposta enviada como rejeitada. Você pode opcionalmente fornecer o motivo da recusa do cliente, que é armazenado no histórico da proposta para análise de pipeline.

Parâmetros Obrigatórios

Parameter	Type	Description
`uuid`	string	UUID da proposta
`company_slug`	string	Identificador do workspace

Parâmetros Opcionais

Parameter	Type	Description
`reason`	string	Motivo da rejeição pelo cliente (armazenado no histórico da proposta)

You:  "A Global Media rejeitou a proposta — restrições orçamentárias"
AI:   Chama proposal action=reject com reason="Restrições orçamentárias"

You:  "Marque a proposta do app mobile como rejeitada"
AI:   Chama proposal action=reject → proposta transiciona para Rejeitada

Convertendo Propostas em Projetos

A ação convert é a ponte entre vendas e entrega. Ela transforma uma proposta aprovada em um projeto totalmente configurado, carregando o título, associação com cliente e escopo. Este é o momento em que um negócio se torna trabalho ativo.

Parâmetros Obrigatórios

Parameter	Type	Description
`uuid`	string	UUID da proposta (deve estar no status Aprovada)
`company_slug`	string	Identificador do workspace

You:  "Converta a proposta da Acme Corp em projeto"
AI:   Chama proposal action=convert → cria projeto vinculado ao cliente

You:  "Aprove e converta a proposta da TechStart"
AI:   Chama proposal action=approve → depois chama proposal action=convert

You:  "O redesign do site foi aprovado — configure o projeto"
AI:   Encontra a proposta aprovada → chama proposal action=convert → retorna novo projeto

Fluxo de Trabalho do Pipeline de Vendas

Para agências gerenciando seu pipeline de vendas através do MCP, este fluxo cobre o ciclo completo de propostas:

1. Crie a proposta

Elabore uma proposta com escopo, preço e associação com cliente.

You:  "Crie uma proposta para a Acme Corp: Plataforma E-commerce, $45.000,
       válida até 30 de março. Inclua escopo: design, desenvolvimento, QA, deploy."
AI:   Uma única chamada de create com todos os campos e conteúdo em Markdown

2. Revise e refine

Revise o rascunho antes de apresentar ao cliente.

You:  "Mostre a proposta da Acme Corp"
AI:   Chama proposal action=get → exibe proposta completa para revisão

You:  "Aumente o valor para $48.000 e estenda a validade até 15 de abril"
AI:   Chama proposal action=update com novo valor e data

3. Envie ao cliente

Entregue a proposta.

You:  "Envie a proposta de e-commerce para a Acme Corp"
AI:   Chama proposal action=send → proposta é entregue e bloqueada

4. Trate a resposta

Registre a decisão do cliente.

You:  "A Acme Corp aprovou a proposta"
AI:   Chama proposal action=approve → pronta para conversão

You:  "Converta em projeto"
AI:   Chama proposal action=convert → projeto criado e vinculado ao cliente

5. Monitore o pipeline

Acompanhe a saúde geral do pipeline de vendas.

You:  "Mostre o pipeline de propostas"
AI:   Chama proposal action=stats → resume valor do pipeline, taxas de conversão, ganhos/perdas

You:  "Quais propostas ainda aguardam resposta?"
AI:   Chama proposal action=list com status="sent" → mostra propostas pendentes

Próximos Passos

Clientes: Gerencie registros de clientes vinculados às suas propostas.
Faturas: Crie faturas para propostas aprovadas e convertidas.
Dashboards ClientFlow: Acesse análises de pipeline e métricas de conversão.
Projetos: Gerencie entregas de projetos após conversão de propostas.