MCP

O SoftCS MCP permite consultar e atualizar dados da sua conta SoftCS usando
linguagem natural. Você pode conectar um assistente de IA compatível e fazer
pedidos como “encontre as tarefas vencidas da conta”, “resuma os chamados mais
urgentes” ou “prepare uma automação para clientes com health score baixo”.

O assistente usa ferramentas da SoftCS para buscar ou alterar informações. O
acesso continua limitado às permissões do seu usuário.

O que você pode fazer

Com o SoftCS MCP, você pode:

pesquisar clientes, contatos, tarefas, chamados, oportunidades, contratos e
eventos em toda a conta;
consultar campos personalizados, alterações contratuais, health score,
produtos do catálogo, séries e registros históricos, eventos de tracking e
respostas de pesquisas;
criar, atualizar ou excluir, de uma só vez, até 50 clientes, contatos,
tarefas, chamados, oportunidades, contratos, produtos do catálogo,
alterações contratuais, registros de health score, valores históricos, itens
do roadmap ou eventos manuais;
consultar e validar automações, além de criar, atualizar ou excluir até 50
automações por vez;
consultar jornadas, funis e etapas, mover registros entre etapas e organizar
clientes matriz e filiais.

Antes de começar

Você precisa de:

uma conta ativa na SoftCS;
permissão para acessar os dados e as ações que pretende usar;
um assistente de IA que aceite servidores MCP remotos.

Como conectar

Abra as configurações do seu assistente de IA.
Procure por Conectores, Integrações, MCP ou Adicionar servidor.
Adicione um servidor MCP remoto ou personalizado.
Informe o nome SoftCS.
No campo de endereço, informe:
```
https://mcp.softcs.com.br/mcp
```
Se o assistente perguntar pelo tipo de conexão, escolha Streamable HTTP.
Clique em Conectar.
Na página aberta no navegador, entre na SoftCS, revise as permissões e
autorize a conexão.
Volte ao assistente de IA.

Você não precisa copiar senhas, tokens ou chaves de API para a conversa.

Teste a conexão

Depois de conectar, experimente um pedido somente de leitura:

Use a SoftCS para encontrar até 5 clientes ativos e mostre apenas nome, status
e health score.

Como usar

Escreva o pedido como faria para uma pessoa. Inclua o período, os filtros e o
resultado esperado sempre que essas informações forem importantes.

Pesquisar em toda a conta

As buscas de clientes, contatos, tarefas, chamados, oportunidades, contratos e
eventos de analytics não exigem que você saiba primeiro o ID de um cliente. O
assistente pode combinar texto livre, filtros, ordenação e paginação.

Encontre em toda a conta as tarefas vencidas, ainda não concluídas, e ordene da
mais antiga para a mais recente.

Pesquise chamados que contenham “integração” e tenham prioridade P0 ou P1.

Liste as oportunidades abertas com receita acima de R$ 10.000 e vencimento
neste trimestre.

Se você pedir condições alternativas, deixe isso claro. Por exemplo: “status
ativo ou health score abaixo de 40”.

Consultar histórico e atividades

Mostre a evolução do health score do cliente Acme neste trimestre.

Liste os contratos ativos do cliente Acme e destaque os que tiveram alterações
recentes.

Resuma os eventos de analytics do cliente Acme relacionados a tarefas e
oportunidades nos últimos 30 dias.

Liste os valores individuais mais recentes do campo histórico de receita do
cliente Acme e mostre também a evolução mensal deste ano.

Criar ou atualizar informações

Crie uma tarefa de acompanhamento para o cliente Acme, com prioridade alta e
vencimento amanhã às 14h. Mostre os dados e aguarde minha confirmação antes de
criar.

Crie uma tarefa interna para revisar o planejamento na sexta-feira, sem
vincular a nenhum cliente. Mostre os dados antes de salvar.

Prepare um novo contato para o cliente Acme com nome, e-mail e cargo. Mostre o
que será salvo antes de criar.

Atualize a oportunidade Renovação 2027 para a etapa Proposta. Não altere os
outros campos e mostre a mudança antes de executar.

Encontre o produto recorrente Suporte Premium no catálogo e use-o para preparar
um contrato para o cliente Acme. Mostre os itens, valores e datas antes de criar.

Crie um item de melhoria no roadmap para o cliente Acme, com prioridade P2.
Mostre o título, a descrição e os clientes vinculados antes de salvar.

Fazer alterações em lote

As ferramentas de criação, atualização e exclusão aceitam de 1 a 50 itens por
pedido. Basta descrever os registros e a alteração em comum:

Atualize para prioridade alta todas as tarefas em aberto que vencem amanhã.
Mostre a lista completa e aguarde minha confirmação antes de executar.

Crie estas três oportunidades para o cliente Acme: Expansão Nordeste por
R$ 15.000, Renovação anual por R$ 24.000 e Treinamento por R$ 5.000. Revise os
dados comigo antes de salvar.

Encontre a jornada de Onboarding e suas etapas. Mostre os clientes que serão
movidos para Em andamento e aguarde minha confirmação antes de executar.

Antes da primeira alteração, a SoftCS valida o lote inteiro. Depois que a
execução começa, cada item passa pelo fluxo normal da entidade, preservando
históricos, notificações, integrações e demais efeitos esperados.

Se um item falhar durante a execução, os anteriores não são desfeitos. Ao
final, o assistente recebe quantos itens foram solicitados, concluídos ou
falharam e o resultado individual de cada um. Peça sempre um resumo das falhas
antes de tentar novamente, para não repetir os itens já concluídos.

Preparar uma automação

Prepare uma automação para clientes que ficarem com health score abaixo de 40.
Valide a configuração e mostre o público estimado, mas não crie nada ainda.

Dados, permissões e confirmação

O SoftCS MCP não dá ao assistente acesso maior do que o seu:

você visualiza apenas os registros permitidos para o seu usuário;
dados financeiros continuam protegidos pelas permissões financeiras da
SoftCS;
criar ou editar informações exige permissão de escrita;
excluir informações exige uma permissão específica e pode ser permanente.

O aplicativo de IA pode exibir uma confirmação própria antes de uma escrita.
Mesmo assim, em alterações e exclusões, peça para o assistente mostrar todos os
registros, a quantidade de itens e um resumo do que será modificado antes de
executar.

Se você concedeu novas permissões ou uma ferramenta nova não aparece,
desconecte e conecte novamente para renovar as permissões e o catálogo de
ferramentas.

Ferramentas disponíveis

Você não precisa memorizar os nomes das ferramentas. Descreva o que deseja e o
assistente escolherá a opção adequada. A lista abaixo mostra tudo o que está
disponível atualmente.

Clientes e campos personalizados

Ferramenta	O que faz
`clients_search`	Pesquisa clientes em toda a conta com texto, filtros e ordenação.
`clients_get`	Obtém os dados de um cliente pelo ID.
`fields_list`	Lista campos personalizados de clientes ou oportunidades, incluindo tipo, opções e restrições.
`clients_create`	Cria de 1 a 50 clientes.
`clients_update`	Atualiza de 1 a 50 clientes existentes.
`clients_delete`	Exclui permanentemente de 1 a 50 clientes e seus dados vinculados.

Antes de criar ou atualizar campos personalizados, o assistente deve consultar
fields_list para descobrir as chaves, os tipos e as opções aceitas. A mesma
consulta deve ser feita antes de pedir a evolução histórica de um campo.

Clientes matriz têm type: "MATRIZ"; clientes comuns têm type: "STANDARD".
Uma filial é um cliente comum com parentClientId apontando para a matriz.
Esses campos aparecem nas consultas de clientes e podem ser usados em filtros
de clients_search. Para associar ou trocar uma filial, atualize
parentClientId; envie null para desassociar. Antes de voltar uma matriz a
STANDARD, desassocie todas as filiais.

Encontre a matriz Acme e liste as filiais vinculadas a ela. Prepare a mudança
da filial Acme Recife para outra matriz e mostre o vínculo atual e o novo.

Tarefas

Ferramenta	O que faz
`tasks_search`	Pesquisa tarefas em toda a conta com texto, filtros e ordem.
`tasks_get`	Obtém uma tarefa pelo ID.
`tasks_create`	Cria de 1 a 50 tarefas.
`tasks_update`	Atualiza de 1 a 50 tarefas existentes.
`tasks_delete`	Exclui permanentemente de 1 a 50 tarefas.

As tarefas podem incluir prioridade, status, tipo, responsável, período,
checklist, participantes e visibilidade para o cliente. Em tasks_create,
clientId é opcional: omita para criar uma tarefa sem cliente. tasks_get,
tasks_update e tasks_delete usam apenas taskId. Participantes precisam
pertencer ao cliente da tarefa; uma tarefa sem cliente não aceita participantes.

Contatos

Ferramenta	O que faz
`contacts_search`	Pesquisa contatos em toda a conta com texto, filtros e ordem.
`contacts_get`	Obtém um contato pelo ID.
`contacts_create`	Cria de 1 a 50 contatos.
`contacts_update`	Atualiza de 1 a 50 contatos existentes.
`contacts_delete`	Exclui permanentemente de 1 a 50 contatos.

Chamados

Ferramenta	O que faz
`tickets_search`	Pesquisa chamados em toda a conta com texto, filtros e ordem.
`tickets_get`	Obtém um chamado pelo ID.
`tickets_create`	Cria de 1 a 50 chamados.
`tickets_update`	Atualiza de 1 a 50 chamados existentes.
`tickets_delete`	Exclui permanentemente de 1 a 50 chamados.

Ao criar um chamado, o assistente também pode relacionar outros clientes e
contatos existentes da conta.

Oportunidades

Ferramenta	O que faz
`opportunities_search`	Pesquisa oportunidades em toda a conta com texto, filtros e ordem.
`opportunities_get`	Obtém uma oportunidade pelo ID.
`opportunities_create`	Cria de 1 a 50 oportunidades.
`opportunities_update`	Atualiza de 1 a 50 oportunidades existentes.
`opportunities_delete`	Exclui permanentemente de 1 a 50 oportunidades.

Valores financeiros de oportunidades só aparecem e só podem ser alterados
quando o usuário possui a permissão correspondente na SoftCS.

Contratos e alterações contratuais

Ferramenta	O que faz
`contracts_search`	Pesquisa contratos em toda a conta com texto, filtros e ordenação.
`contracts_get`	Obtém um contrato pelo ID.
`contracts_create`	Cria de 1 a 50 contratos.
`contracts_update`	Atualiza de 1 a 50 contratos existentes.
`contracts_delete`	Exclui permanentemente de 1 a 50 contratos, seus históricos e anexos.
`contract_products_list`	Lista produtos do catálogo para localizar os itens de um contrato.
`contract_products_get`	Obtém um produto do catálogo pelo ID.
`contract_products_create`	Cria de 1 a 50 produtos no catálogo.
`contract_products_update`	Atualiza de 1 a 50 produtos do catálogo.
`contract_products_delete`	Exclui de 1 a 50 produtos do catálogo.
`contract_changes_list`	Lista o histórico de alterações de um contrato.
`contract_changes_get`	Obtém uma alteração específica do histórico.
`contract_changes_create`	Registra de 1 a 50 alterações em históricos de contratos.
`contract_changes_update`	Atualiza de 1 a 50 alterações contratuais.
`contract_changes_delete`	Cancela de 1 a 50 alterações e recalcula os contratos quando possível.

Valores financeiros de contratos e alterações contratuais respeitam as
permissões financeiras do usuário. O cancelamento de uma alteração contratual
pode recalcular os valores do contrato; revise o resultado antes de executar.
Para criar um contrato, selecione antes pelo menos um produto recorrente do
catálogo. Cada item precisa do ID do produto, nome, quantidade maior que zero,
preço unitário e desconto. O catálogo pode ser consultado por nome, SKU, ID
externo ou tipo (recorrente ou avulso). Produtos avulsos são cobrados
separadamente.

Health score

Ferramenta	O que faz
`health_scores_list`	Lista o histórico de health score de um cliente.
`health_scores_get`	Obtém um registro específico de health score.
`health_scores_create`	Cria de 1 a 50 observações históricas de health score.
`health_scores_update`	Atualiza de 1 a 50 observações históricas de health score.
`health_scores_delete`	Exclui permanentemente de 1 a 50 observações de health score.

Jornadas, funis e roadmap

Ferramenta	O que faz
`workflow_options_list`	Lista jornadas, funis e etapas disponíveis.
`clients_set_journey_stage`	Move até 50 clientes entre etapas de jornada.
`tasks_set_journey_stage`	Move até 50 tarefas entre etapas de jornada.
`opportunities_set_funnel_stage`	Move até 50 oportunidades entre etapas de funil.
`roadmap_items_set_stage`	Move até 50 itens do roadmap entre etapas.
`roadmap_items_list`	Lista itens do roadmap com filtros e paginação.
`roadmap_items_get`	Obtém um item do roadmap por ID.
`roadmap_items_create`	Cria de 1 a 50 itens do roadmap.
`roadmap_items_update`	Atualiza de 1 a 50 itens do roadmap.
`roadmap_items_delete`	Exclui de 1 a 50 itens do roadmap.

Consulte workflow_options_list antes de escolher uma etapa. Mostre os itens e
as etapas de destino antes de executar a mudança. A consulta também lista
etapas de chamados, que podem ser usadas ao criar ou atualizar um chamado.
Informe a jornada ou o funil para limitar a busca às suas etapas. Para clientes
e tarefas, remover uma etapa desfaz apenas o vínculo com a jornada escolhida.
Uma oportunidade pode permanecer em outros funis. Para mover um item do roadmap,
informe seu ID; a mudança também atualiza o status do item.

Você pode listar itens do roadmap por cliente, etapa, status, tipo, prioridade
ou texto. Ao criar ou atualizar, é possível informar prazo, cliente principal,
outros clientes vinculados e visibilidade para o cliente. Consulte as etapas
antes de escolher uma para o item. Para desvincular o cliente principal, peça
para removê-lo; os outros clientes vinculados são tratados separadamente.

Eventos de analytics

Ferramenta	O que faz
`analytics_event_types_list`	Lista os tipos de evento consultáveis e seus nomes em português.
`analytics_events_search`	Pesquisa eventos em toda a conta por texto, tipo, data e relacionamentos.
`analytics_events_get`	Obtém um evento de analytics pelo ID.
`analytics_events_create`	Cria de 1 a 50 eventos manuais.
`analytics_events_update`	Atualiza de 1 a 50 eventos manuais.
`analytics_events_delete`	Exclui permanentemente de 1 a 50 eventos manuais.

Antes de filtrar eventos por tipo, o assistente deve consultar
analytics_event_types_list. Eventos automáticos e de sistema podem ser
consultados, mas somente eventos manuais podem ser criados, atualizados ou
excluídos.

Histórico, tracking e pesquisas

Ferramenta	O que faz
`historical_data_get`	Consulta a evolução agregada de um campo do cliente.
`historical_data_entries_list`	Lista registros individuais e seus IDs.
`historical_data_entries_get`	Consulta um registro individual por ID.
`historical_data_entries_create`	Grava de 1 a 50 valores numéricos datados.
`historical_data_entries_update`	Edita valor ou data de 1 a 50 registros.
`historical_data_entries_delete`	Exclui permanentemente de 1 a 50 registros.
`tracking_events_get`	Consulta um resumo de tracking por período e tipo de evento.
`survey_responses_list`	Lista respostas de pesquisas de um cliente.

Para as ferramentas de histórico, o assistente deve usar a chave informada por
fields_list, e não apenas o nome visível do campo. historical_data_get
retorna a série agregada; historical_data_entries_list fornece os IDs para
editar ou excluir. Gravar outro valor no mesmo dia substitui a entrada daquele
dia; revise a data antes de salvar. As datas usam ISO 8601 com fuso horário.

Automações

Ferramenta	O que faz
`automation_capabilities`	Mostra os campos, condições, ações e frequências aceitos para uma automação.
`automation_options`	Busca opções como usuários, jornadas, etapas e integrações.
`automation_list`	Lista automações independentes.
`automation_get`	Obtém a configuração completa de uma automação.
`automation_validate`	Valida uma automação sem salvá-la e mostra o público estimado e o agendamento.
`automation_create`	Cria e agenda de 1 a 50 automações independentes.
`automation_update`	Atualiza a configuração e o agendamento de 1 a 50 automações.
`automation_delete`	Exclui permanentemente de 1 a 50 automações e remove seus agendamentos.

Ao criar ou alterar uma automação, o assistente deve primeiro consultar as
capacidades disponíveis, buscar as opções necessárias e validar cada
configuração. Só depois da sua revisão ele deve criar ou atualizar as
automações.

Boas práticas

Informe períodos e condições de busca de forma clara.
Quando houver registros parecidos, peça para o assistente mostrar as opções e
escolha o registro correto antes de continuar.
Em atualizações, diga quais campos devem mudar e peça para preservar os
demais.
Em alterações e exclusões, peça para visualizar todos os itens antes de
executar.
Depois de uma escrita em lote, confira os itens concluídos e tente novamente
apenas os que falharam.
Use datas com horário e fuso quando o momento exato for importante.
Depois de uma busca longa, peça para continuar da página seguinte em vez de
repetir a consulta do início.

Solução de problemas

Não encontro a opção para adicionar um servidor MCP

Seu assistente pode não oferecer servidores MCP remotos ou o recurso pode estar
desativado pelo administrador da sua organização. Consulte a documentação do
assistente utilizado.

O navegador não abre ou o login volta para o início

Confirme se o endereço foi informado exatamente como
https://mcp.softcs.com.br/mcp. Depois, remova a conexão e conecte novamente.
Verifique também bloqueadores de pop-up e as políticas do navegador.

A conexão funciona, mas uma ferramenta nova não aparece

Desconecte e conecte novamente para atualizar as ferramentas e permissões da
conexão.

O assistente informa que a ação não está autorizada

Seu usuário pode não ter acesso ao tipo de dado ou à ação solicitada. Refaça a
conexão e, se o erro continuar, peça ao administrador da conta SoftCS para
revisar suas permissões.

Um cliente ou registro não aparece

Confirme se você está na conta correta, se possui acesso ao registro e se o
pedido não aplicou filtros muito restritivos. Tente primeiro uma busca mais
ampla por texto ou remova um filtro.

Um campo personalizado foi rejeitado

Peça ao assistente para consultar novamente os campos personalizados antes de
tentar criar ou atualizar o registro.

Um evento de analytics não pode ser alterado

Eventos automáticos e de sistema são somente leitura. Apenas eventos manuais
podem ser atualizados ou excluídos.

Alguns itens de uma alteração em lote falharam

Peça ao assistente para mostrar o resultado individual de cada item. Os itens
anteriores podem ter sido concluídos mesmo quando outro falha; tente novamente
somente os que não foram concluídos.