Consultar seus clientes por um agente de IA com MCP

Um servidor MCP permite que um agente de IA consulte uma base de dados sem que você copie nada para o chat. O People oferece um: o agente se conecta, entra com login OAuth e lê as fichas das pessoas da sua conta, com a permissão que você conceder. Ele também pode propor notas e ações, mas não envia nada a ninguém sozinho.

Como o agente se conecta

O endereço do servidor é https://people.worker.mycustomers.click/mcp, no transporte Streamable HTTP. Em um cliente que aceita MCP por linha de comando, o cadastro é uma linha:

claude mcp add --transport http customers-people https://people.worker.mycustomers.click/mcp

Na primeira chamada, o navegador abre a tela de login do Auth. Você entra com o código que chega no seu e-mail e autoriza o acesso. O token segue o padrão OAuth 2.1 e só vale para este servidor: um token emitido para outro serviço é recusado aqui. Sem token, a resposta é 401, com a indicação de onde pedir a autorização.

O que o agente pode ler

Três ferramentas de leitura, disponíveis com qualquer permissão:

A conta nunca é um argumento. Ela vem do token, então o agente só enxerga a base de quem autorizou. Uma pessoa que não existe e uma pessoa de outra conta recebem a mesma resposta.

O que o agente pode fazer

Com permissão de escrita, duas ferramentas a mais:

• people_add_note registra uma nota na ficha. Se a nota estiver em "livre" nas suas regras, entra na hora. Se estiver em "confirma", espera a sua aprovação.

• people_propose_action propõe uma ação: uma resposta, um e-mail, uma oferta, uma mudança de estágio, uma etiqueta ou uma fusão de fichas. A proposta traz o título, o motivo, o texto e o evento que se espera depois. Mensagens precisam dizer o que deve acontecer e até quando.

Uma proposta feita pelo agente entra na mesma fila que as que você cria no painel e passa pela mesma checagem, sem IA, antes de existir: o que o Manual da conta proíbe prometer, datas e "em breve" sempre barrados, opt-out da pessoa, limite de contato por semana e horário de silêncio. Oferta de preço e primeira mensagem para quem nunca escreveu sempre ficam com você, qualquer que seja a regra.

O que o agente não faz

Nenhuma ferramenta do servidor envia nada a uma pessoa. Não existe a ferramenta "mande esta mensagem". O agente propõe, a checagem confere, e o que fala com alguém espera o seu clique. Isso vale até para respostas: a ação fica aprovada e aguardando até você liberar o envio pelo canal da conta.

O agente também não cria fonte, não altera o Manual, não cria estratégia, não importa CSV e não funde fichas por conta própria. Tudo isso é feito no painel, por você.

Quem está conectado

Cada cliente MCP que a conta já usou aparece em Equipe. Se você não reconhece um, revogue: as chamadas seguintes dele respondem 401. Também é possível restaurar um cliente revogado. Cada leitura feita pelo MCP fica registrada na trilha da conta.

Perguntas frequentes

Preciso dar a chave de API ao agente?

A conexão MCP usa o login OAuth, com o código do seu e-mail. Para uma rotina automática, como um cron ou um CI, existe uma chave de leitura criada no painel, que só consulta dados e nunca escreve.

Posso dar permissão só de leitura?

Sim. Ao autorizar, o escopo de leitura permite as três ferramentas de consulta, e as duas de escrita não ficam disponíveis para o agente.

O agente pode mandar mensagem sozinho para um cliente novo?

Não. A primeira mensagem para quem nunca escreveu e qualquer oferta de preço ficam sempre com você. Para as demais mensagens, a sua aprovação é necessária antes do envio, conforme a política de cada tipo de ação.

Para continuar lendo

• Lead, prospect e cliente: a diferença e como saber o estágio de cada pessoa

• Próximo passo de venda sugerido por agente, com checagem e aprovação

• O People não é pipeline de vendas: quando usar e quando não usar

Um agente com acesso, e você no comando

Um agente que lê a sua base ajuda a responder perguntas rápidas, como quem parou no meio do caminho ou quem pagou e ainda não usou o produto. A parte que importa é a que ele não faz sozinho, que é falar com o cliente. Conectar o agente e manter a aprovação ajuda a ganhar tempo sem abrir mão do controle sobre o que sai para o cliente. Conhecer o People

Fontes

• Referência do People para pessoas e agentes (llms.txt)

• Página do People