Clientes

Gerenciamento de clientes pelo MCP. Crie, gerencie e acompanhe relacionamentos com clientes com capacidades completas de CRM para agências e prestadores de serviços.

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 client fornece 5 ações para gerenciar relacionamentos com clientes dentro do ClientFlow CRM do GitScrum. Agências, consultorias e prestadores de serviços usam esta ferramenta para manter um banco de dados centralizado de clientes que se conecta diretamente a projetos, propostas e faturas. Toda operação de cliente disponível no aplicativo web GitScrum — criar contatos, atualizar detalhes, revisar métricas do portfólio — é acessível através de conversa em linguagem natural com seu assistente de IA.

Clientes são a base do ClientFlow CRM. Uma vez que um registro de cliente existe, ele pode ser vinculado a projetos para acompanhamento de entregas, propostas para gerenciamento do pipeline de vendas e faturas para automação de faturamento. O MCP Server dá ao seu assistente de IA a capacidade de gerenciar todo este ciclo de vida do cliente sem trocar de contexto.

Visão Geral das Ações

Ação	Propósito	Parâmetros Obrigatórios
`list`	Listar todos os clientes de um workspace	`company_slug`
`get`	Obter detalhes completos de um cliente específico	`uuid`, `company_slug`
`create`	Criar um novo registro de cliente	`company_slug`, `name`
`update`	Modificar detalhes do cliente	`uuid`, `company_slug`
`stats`	Obter métricas gerais de clientes do workspace	`company_slug`

Listando Clientes

A ação list retorna todos os clientes dentro de um workspace. Você pode opcionalmente filtrar por status e paginar resultados. Cada cliente na resposta inclui seu uuid, que é necessário para todas as operações específicas de cliente e para vincular clientes a projetos, propostas e faturas.

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 do cliente: `active`, `inactive`, `archived`
`page`	number	Número da página para paginação
`per_page`	number	Resultados por página (padrão varia por plano do workspace)

Exemplos de Prompts

You:  "Mostre todos os meus clientes"
AI:   Chama client action=list → retorna lista de clientes com UUIDs, nomes e status

You:  "Liste apenas clientes ativos"
AI:   Chama client action=list com status="active"

You:  "Mostre a segunda página de clientes"
AI:   Chama client action=list com page=2

Obtendo Detalhes do Cliente

A ação get retorna o registro completo do cliente — nome, informações de contato, detalhes da empresa, projetos associados, propostas vinculadas, histórico de faturas e linha do tempo de atividades. Esta é a visão completa do perfil do cliente.

Parâmetros Obrigatórios

Parameter	Type	Description
`uuid`	string	UUID do cliente (da resposta `list` ou qualquer referência de cliente)
`company_slug`	string	Identificador do workspace

You:  "Mostre os detalhes da Acme Corp"
AI:   Encontra o cliente pelo nome → chama client action=get → retorna perfil completo do cliente

You:  "Qual é o contato do nosso cliente TechStart?"
AI:   Chama client action=get → extrai email, telefone e endereço

Criando Clientes

A ação create adiciona um novo registro de cliente ao workspace. Todos os campos de contato e empresa podem ser definidos na criação em uma única chamada — sem necessidade de atualizações subsequentes.

Parâmetros Obrigatórios

Parameter	Type	Description
`company_slug`	string	Identificador do workspace
`name`	string	Nome do contato do cliente

Parâmetros Opcionais

Parameter	Type	Description
`email`	string	Endereço de email do cliente
`phone`	string	Número de telefone do cliente
`company_name`	string	Nome da empresa ou organização do cliente
`website`	string	URL do site do cliente
`address`	string	Endereço físico do cliente
`notes`	string	Notas internas sobre o cliente (não visíveis para o cliente)

Exemplos de Prompts

You:  "Adicione um novo cliente 'Acme Corp' com email contact@acme.com"
AI:   Chama client action=create com name="Acme Corp", email="contact@acme.com"

You:  "Crie um registro de cliente para John Smith da TechStart, telefone 555-0100,
       site techstart.io"
AI:   Chama client action=create com name="John Smith", company_name="TechStart",
      phone="555-0100", website="techstart.io"

You:  "Adicione o cliente 'Global Media' com nota: 'Indicado pela Sarah, prefere contato por email'"
AI:   Chama client action=create com name="Global Media",
      notes="Indicado pela Sarah, prefere contato por email"

Atualizando Clientes

A ação update modifica qualquer campo em um registro de cliente existente. Apenas os campos que você especificar são alterados — todos os outros campos permanecem inalterados. Isso é útil para atualizar detalhes de contato, adicionar notas ou corrigir informações.

Parâmetros Obrigatórios

Parameter	Type	Description
`uuid`	string	UUID do cliente
`company_slug`	string	Identificador do workspace

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

Exemplos de Prompts

You:  "Atualize o email da Acme Corp para hello@acme.com"
AI:   Encontra o cliente → chama client action=update com email="hello@acme.com"

You:  "Adicione uma nota à Global Media: 'Contrato renovado para o Q2'"
AI:   Chama client action=update com notes="Contrato renovado para o Q2"

You:  "Mude o site da TechStart para www.techstart.com"
AI:   Chama client action=update com website="www.techstart.com"

Estatísticas de Clientes

A ação stats retorna métricas de clientes no nível do workspace — total de clientes, contagem de ativos vs inativos, receita por cliente, distribuição de projetos e tendências de engajamento. Esses são os números que alimentam o dashboard do ClientFlow CRM.

Parâmetros Obrigatórios

Parameter	Type	Description
`company_slug`	string	Identificador do workspace

You:  "Mostre as estatísticas de clientes"
AI:   Chama client action=stats → retorna total de clientes, contagem de ativos, métricas de receita

You:  "Quantos clientes ativos temos?"
AI:   Chama client action=stats → extrai contagem de clientes ativos

You:  "Mostre a visão geral de clientes da minha agência"
AI:   Chama client action=stats → resume a saúde do portfólio de clientes

Fluxo de Trabalho CRM

Clientes se conectam a todas as partes do ecossistema ClientFlow CRM. Veja como a ferramenta de clientes se integra com outras ferramentas para um fluxo de trabalho completo de agência:

1. Registre o cliente

Comece criando um registro de cliente com todas as informações de contato relevantes.

You:  "Adicione um novo cliente 'Acme Corp', email contact@acme.com, nome da empresa 'Acme Corporation',
       site acme.com. Nota: Conta enterprise, 50+ funcionários"
AI:   Chama client action=create → retorna UUID do cliente para vinculação

2. Crie uma proposta

Use o UUID do cliente para criar uma proposta vinculada a este cliente.

You:  "Crie uma proposta para a Acme Corp: Redesign do Site, $15.000"
AI:   Encontra o UUID do cliente → chama proposal action=create com contact_company_uuid

3. Converta em projeto

Quando a proposta for aprovada, converta-a em um projeto ativo.

You:  "Aprove a proposta da Acme Corp e converta em projeto"
AI:   Chama proposal action=approve → chama proposal action=convert

4. Fature pelo trabalho

Gere faturas vinculadas ao cliente para cobrança.

You:  "Crie uma fatura para a Acme Corp, $5.000 pela entrega da Fase 1"
AI:   Chama invoice action=create com client_uuid → fatura em rascunho pronta para envio

5. Monitore o relacionamento

Acompanhe a saúde do cliente através de estatísticas e dashboards.

You:  "Mostre a visão geral de clientes"
AI:   Chama client action=stats → resume métricas do portfólio

Vinculando Clientes a Projetos

Ao criar um projeto através da ferramenta project, você pode passar o UUID do cliente como parâmetro client_uuid. Isso vincula o projeto ao registro do cliente, habilitando:

Listagens de projetos por cliente
Atribuição de receita por cliente
Acesso ao portal do cliente (se configurado)
Relatórios consolidados de todos os projetos do cliente

You:  "Crie um projeto 'Redesign do Site Acme' vinculado à Acme Corp"
AI:   Encontra o UUID do cliente → chama project action=create com client_uuid

Próximos Passos

Faturas: Crie e gerencie faturas para seus clientes.
Propostas: Construa e envie propostas para converter leads em projetos.
Dashboards ClientFlow: Acesse análises de CRM e relatórios entre workspaces.
Projetos: Gerencie a entrega de projetos para seus clientes.