Conecte Claude, ChatGPT, Cursor e outros clientes de IA ao workspace pelo servidor MCP do Steel, com OAuth, escopos por módulo e as ferramentas do Steel AI.
Nesta página
O Steel tem um servidor MCP (Model Context Protocol)
próprio. Com ele, um cliente de IA (Claude, ChatGPT, Cursor ou qualquer outro
que fale MCP) consulta chamados, leads, oportunidades e conversas do seu
workspace com as permissões de quem conectou, sem chave de API e sem código.
O servidor é um adaptador sobre as ferramentas do Steel AI: as mesmas
ferramentas que o assistente usa dentro do Steel, filtradas pelos módulos, pelo
papel do usuário e pelo escopo que ele concedeu. Uma ferramenta nova no Steel AI
aparece no MCP no mesmo deploy.
Para
Veja
Conectar Claude, ChatGPT, Cursor ou outro cliente
Esta página, a seguir
Uma conversa de exemplo, o confirmUrl e o idempotencyKey
Neste ambiente, o servidor MCP fica em https://homologacao.stratustelecom.com.br/api/mcp. Em outro ambiente, é o
endereço do seu Steel seguido de /api/mcp.
Item
Valor
Transporte
Streamable HTTP, sem estado (sem sessão MCP no servidor)
Método
POST; GET e DELETE respondem 405
Autenticação
OAuth 2.1 do Steel, com PKCE e registro dinâmico de cliente
Descoberta
/.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server
Planos
Todos os planos; não consome a cota mensal do Steel AI, porque o modelo é do cliente
Não há chave para copiar: o cliente de IA se registra sozinho no Steel e abre a
tela de login quando você conecta.
Como a conexão funciona
O cliente chama o servidor sem token e recebe 401 com o header
WWW-Authenticate, que aponta para os metadados do recurso.
Com os metadados, o cliente descobre o servidor de autorização do Steel e se
registra (registro dinâmico de cliente OAuth).
O navegador abre o login do Steel. Quem já está logado vai direto para a tela
de consentimento.
No consentimento, você escolhe o workspace, os módulos e o
escopo (só leitura, ou leitura e escrita).
O cliente recebe um token de acesso e um refresh token, e passa a chamar o
servidor com Authorization: Bearer.
Cada conexão vale para um workspace. Para usar outro workspace no mesmo
cliente, conecte de novo e escolha o outro na tela de consentimento.
Conectar o Claude
No Claude (web e app de desktop):
Abra Configurações › Conectores e clique em Adicionar conector
personalizado (Add custom connector).
Dê o nome Steel e cole o endereço do servidor (https://homologacao.stratustelecom.com.br/api/mcp).
Clique em Conectar, faça login no Steel e confirme o consentimento.
Numa conversa, ligue o conector Steel no menu de ferramentas.
Nos planos Team e Enterprise do Claude, quem adiciona conectores personalizados
é o dono da organização no Claude; depois cada pessoa conecta a própria conta do
Steel.
No Claude Code, adicione o servidor e autentique com /mcp:
claude mcp add --transport http steel https://homologacao.stratustelecom.com.br/api/mcp
Conectar o ChatGPT
O ChatGPT aceita servidores MCP como conectores no modo desenvolvedor:
Abra Configurações › Apps e conectores › Configurações avançadas e ligue
o Modo desenvolvedor (Developer mode).
Em Apps e conectores, clique em Criar (Create).
Dê o nome Steel, cole o endereço do servidor (https://homologacao.stratustelecom.com.br/api/mcp) e
escolha a autenticação OAuth.
Confirme que confia no aplicativo e clique em Criar. O ChatGPT abre o
login do Steel e o consentimento.
Numa conversa, escolha o conector Steel no menu de ferramentas.
A disponibilidade do modo desenvolvedor depende do plano do ChatGPT, e os nomes
dos menus mudam com as versões do aplicativo.
Conectar o Cursor
No Cursor, o servidor entra pelo mcp.json: ~/.cursor/mcp.json vale para
todos os projetos; .cursor/mcp.json na raiz do repositório vale só para ele.
Troque o endereço pelo do seu Steel. Em Cursor Settings › MCP, o servidor
aparece pedindo login: clique para autenticar, faça login no Steel e confirme o
consentimento.
Outros clientes
Qualquer cliente que fale MCP por Streamable HTTP com OAuth (e registro dinâmico
de cliente) conecta do mesmo jeito: basta o endereço do servidor. Se você está
escrevendo o cliente, o fluxo completo está em OAuth e protocolo.
Um cliente que só fala stdio tem duas pontes:
mcp-remote, que faz o OAuth e renova o token sozinho. É a opção para o
dia a dia:
O token é um access token OAuth do MCP (stl_at_), não o stl_pat_ do
steel login: a API v1 e o MCP têm credenciais separadas. Ele sai do fluxo
de OAuth e protocolo e vale 1 hora; o steel mcp não o
renova. Use para testes, automações curtas e clientes que você mesmo
controla; para uso contínuo, prefira um cliente com OAuth ou o mcp-remote.
Passe o token por STEEL_MCP_TOKEN (de preferência) ou --token.
O stdout é do protocolo: avisos e erros saem no stderr, em JSON. Se o Steel
recusar (token vencido ou revogado, sem permissão, fora do ar), o cliente
recebe um erro JSON-RPC na hora, sem ficar esperando.
Revogue em Apps conectados, como qualquer conexão.
Escopos
Escopo
Dá acesso a
mcp:read
Ferramentas de leitura, resources e prompts
mcp:write
Também as ferramentas de criação, edição e ação, se o administrador do workspace ligou Permitir escrita via MCP em Ajustes › Steel IA
Ferramentas de exclusão nunca são expostas pelo MCP, com qualquer escopo.
Com mcp:write, o consentimento explícito faz o papel da confirmação que o
assistente pede dentro do Steel. Ações que enviam algo a um cliente final (uma
mensagem de WhatsApp, um e-mail, um link de aprovação) não executam direto:
o servidor devolve um link para alguém confirmar a ação no Steel.
Escrita
As ferramentas de escrita (readOnlyHint: false) aparecem em tools/list só
quando as duas condições valem: o token tem mcp:writee o administrador
ligou Permitir escrita via MCP. O interruptor independe do modo agente e do
Autopilot do assistente do Steel. Desligado, a conexão continua só leitura, e
uma ferramenta de escrita chamada mesmo assim responde como desconhecida
(-32602).
Ações internas (criar tarefa, registrar nota, mover etapa, atribuir)
executam na hora, com o usuário que conectou, e voltam
status: "executed" com actionId, target e o href do registro.
Ações com cliente final (zap_message_send_text,
sd_reply_to_requester, sd_request_approval, sd_move_ticket_phase e
sd_cancel_ticket) não executam pela chamada: voltam
status: "pending_confirmation" com um confirmUrl. A pessoa que conectou
confirma no Steel, em até 30 minutos.
idempotencyKey (opcional, 1 a 200 caracteres) em qualquer escrita:
repetir com a mesma chave e os mesmos argumentos em até 24 horas devolve o
primeiro resultado em vez de executar de novo.
Todo href nos resultados já vem com o endereço do Steel.
A conversa de exemplo, o fluxo do confirmUrl passo a passo, a tabela de
respostas do idempotencyKey e os erros estão em
Escrita, confirmação e idempotência.
Cada escrita fica no histórico de ações da IA do workspace com a origem MCP e
o cliente OAuth, e na trilha de auditoria.
Módulos e permissões
O cliente só vê as ferramentas que passam por todos estes filtros:
Módulo concedido: você escolhe no consentimento quais módulos (ServiceDesk,
CRM, Comunicação) a conexão alcança. Só aparecem os módulos habilitados no
workspace e a que você tem acesso.
Papel no workspace: a matriz de permissões do workspace vale igual ao
aplicativo. Quem é leitor não ganha ferramentas que o papel não permite.
Escopo e interruptor: sem mcp:write, ou com Permitir escrita via
MCP desligado, só leitura.
Mesmo com a ferramenta na lista, quem decide é o serviço do Steel: a chamada roda
com o usuário que conectou, e o que ele não pode fazer no aplicativo também é
recusado pelo MCP.
Ferramentas
A lista abaixo sai do registro de ferramentas do Steel AI a cada deploy. O que
um cliente recebe em tools/list é o recorte dela pelos filtros acima. Cada
ferramenta leva o rótulo como title e a anotação readOnlyHint quando é de
leitura.
46 ferramentas de leitura e 44 de escrita. As 10 ferramentas de exclusão do Steel AI ficam fora do MCP.
Plataforma (9)
Ferramenta
O que faz
Tipo
Escopo
steel_get_skill
Devolve as instruções de uma skill do Steel AI habilitada no workspace, pelo comando (ex.: "my-work" para /my-work).
Leitura
mcp:read
steel_search
Busca por significado e por palavras na base de conhecimento do workspace: artigos da base de conhecimento do ServiceDesk, páginas da Wiki, chamados resolvidos (título e solução), documentos da IA do WhatsApp e notas e…
Leitura
mcp:read
ws_ai_usage
Consumo de IA do workspace inteiro (só proprietário/administrador), em US$ e dias UTC: gasto do mês e da semana, cota mensal, parcela semanal (cota × 7 ÷ dias do mês), projeção linear para o fim do mês e variação contra…
Leitura
mcp:read
ws_insights
Lista os alertas ativos da IA proativa para o usuário: chamados que devem estourar o SLA nas próximas horas, oportunidades sem contato, etapa do funil travada, previsão do mês abaixo da meta, conversas do WhatsApp aguar…
Leitura
mcp:read
ws_invitations
Convites pendentes para entrar no workspace (só proprietário/administrador): e-mail, papel, quando foi enviado, validade e se já venceu.
Leitura
mcp:read
ws_members
Lista os membros do workspace (nome, e-mail e papel). `query` filtra por nome ou e-mail.
Leitura
mcp:read
ws_notifications
Notificações da caixa de entrada do próprio usuário neste workspace, não lidas primeiro (depois as mais recentes).
Leitura
mcp:read
ws_overview
Visão geral do workspace atual: nome, plano, módulos habilitados (ServiceDesk, CRM, Comunicação) e quantidade de membros.
Leitura
mcp:read
ws_search
Busca global no workspace: chamados (por código como INC-000123 ou número), artigos da base de conhecimento, clientes/contatos/itens de configuração do ServiceDesk, leads, oportunidades, pessoas, empresas, tarefas e pro…
Leitura
mcp:read
ServiceDesk (25)
Ferramenta
O que faz
Tipo
Escopo
sd_catalog
Catálogo de serviços do ServiceDesk (categoria > subcategoria > serviço) com o caminho completo, práticas aceitas e o departamento que atende. `query` filtra por nome em qualquer nível; `practice` pelas práticas aceitas.
Leitura
mcp:read
sd_get_config_item
Detalhes de um item de configuração (nome, código, IP ou id): tipo, status, criticidade, dono, garantia, atributos, hierarquia (pais e filhos) e os últimos chamados vinculados.
Leitura
mcp:read
sd_get_kb_article
Texto completo (até ~6 mil caracteres) e metadados de um artigo da base de conhecimento, por id ou título.
Leitura
mcp:read
sd_get_ticket
Detalhes de um chamado: campos, SLA, risco, as últimas mensagens do histórico, a rastreabilidade recente, tarefas, aprovações e artigos da base vinculados.
Leitura
mcp:read
CRM (33)
Ferramenta
O que faz
Tipo
Escopo
crm_get_competitor_growth
Série histórica de seguidores e estatísticas de posts de um concorrente comparadas com a conta conectada do workspace, com a variação no período.
Leitura
mcp:read
crm_get_forecast
Previsão de receita por responsável e período (mês ou trimestre, pela data de fechamento): receita ganha, pipeline em aberto ponderado pela probabilidade, previsão (ganho + ponderado), meta e atingimento da meta em %. `…
Leitura
mcp:read
crm_get_record
Detalhe de um registro do CRM — lead, oportunidade, pessoa ou empresa — com os itens relacionados (empresa, contato, oportunidades, pessoas, tarefas, notas, propostas e atividades recentes; até 10 de cada, com o total).
Leitura
mcp:read
crm_get_record_timeline
Histórico de um registro do CRM (lead, oportunidade, pessoa ou empresa): atividades registradas (criações, alterações) e notas, das mais recentes para as mais antigas, paginadas.
Leitura
Comunicação (23)
Ferramenta
O que faz
Tipo
Escopo
zap_broadcast_get
Detalhes de uma transmissão do WhatsApp: mensagem, status, estatísticas de entrega e até 20 destinatários com falha (com o erro do provedor).
Leitura
mcp:read
zap_broadcasts_list
Lista as transmissões (envios em massa) do WhatsApp com estatísticas de entrega: destinatários, enviados, falhas, ignorados por opt-out LGPD e pendentes.
Leitura
mcp:read
zap_connections_status
Status das conexões (números) de WhatsApp do workspace: provedor (META = API oficial, com janela de 24 h; ZAPI), número, status e o último erro.
Leitura
mcp:read
zap_contact_get
Dados de um contato do WhatsApp (nome, número, descrição, opt-out LGPD) e as conversas dele (até 10, mais recentes).
Leitura
mcp:read
Uma chamada que o Steel recusa (sem permissão, registro inexistente, argumento
inválido) volta como resultado com isError: true e a mensagem em português,
para o modelo explicar ao usuário. A resposta traz os dados em
structuredContent e um resumo em texto, com tamanho máximo por chamada.
Busca de conhecimento (steel_search)
steel_search responde perguntas com a documentação do workspace: artigos da
base de conhecimento, páginas da Wiki, chamados resolvidos (título e
solução), documentos da IA do WhatsApp e notas e propostas do CRM. Busca por
palavras (português, sem acento, com radical) e, quando o servidor tem o
índice semântico ligado, também pelo sentido da pergunta.
O resultado traz mode (hybrid ou text) e results, cada um com ref,
sourceType, source (rótulo), title, snippet, href (caminho no app,
com o slug do workspace) e updatedAt. Cada fonte segue a regra de acesso do
próprio módulo para o usuário da conexão. Peça ao modelo para citar as
fontes que usou pelo title, com o link href prefixado pelo domínio do
Steel. O mesmo resultado está em
GET /api/workspaces/{id}/ai/knowledge/search?q=.
Alertas da IA proativa (ws_insights)
ws_insights devolve os alertas ativos do usuário da conexão: chamados que
devem estourar o SLA nas próximas horas, oportunidades sem contato, etapa do
funil travada, previsão do mês abaixo da meta, conversas aguardando atendente
e sentimento em queda. Os alertas são calculados por regra, a cada 15
minutos, a partir dos dados do workspace — o modelo deve citar os números
como vieram. Serve para perguntas como "o que precisa da minha atenção?".
Argumento
Tipo
Descrição
module
SERVICE_DESK, CRM ou COMMUNICATION (opcional)
Só os alertas de um módulo
limit
inteiro 1–20 (opcional)
Quantidade de alertas (padrão 10)
O resultado traz enabled (false quando o workspace desligou a IA
proativa), total e insights, cada um com module, severity (Urgente,
Atenção, Informativo), title, body, facts (rótulo e valor) e href
(caminho no app, com o slug). O mesmo conteúdo está em
GET /api/workspaces/{id}/ai/insights.
Quando há muitas ferramentas
Se o acesso concedido expõe mais de 40 ferramentas, o tools/list vem enxuto:
as ferramentas de plataforma, todas as de escrita e até 20 de leitura das
categorias mais usadas no workspace. As demais continuam disponíveis por duas
ferramentas extras:
steel_find_tools (module e/ou query) procura entre todas as
ferramentas do acesso e devolve nome, descrição e o esquema de parâmetros
de cada uma;
steel_call_tool (name, arguments) executa uma ferramenta de leitura
encontrada assim.
Uma ferramenta fora da lista também pode ser chamada direto pelo nome em
tools/call. Ocultar muda só a lista, nunca o que o acesso permite.
Resources e prompts
Resources: os artigos publicados da base de conhecimento do ServiceDesk
e as páginas da Wiki que você pode ler, com listagem paginada. Cada um respeita
o módulo concedido.
Prompts: pontos de partida prontos, em português, por módulo:
Resumo do dia do ServiceDesk, Pipeline da semana (CRM) e Conversas
sem resposta (Comunicação).
Segurança
Revogar: cada pessoa vê e revoga as próprias conexões em Configurações ›
Segurança › Apps conectados. O dono e os administradores do workspace veem
as de todos os membros em Ajustes › Apps conectados, com as chamadas de
cada app nos últimos 7 e 30 dias, e revogam uma conexão, todas de um membro
ou todas de um app. A revogação vale na chamada seguinte do cliente.
Membro removido: quem sai do workspace perde o acesso pelo MCP na chamada
seguinte, sem precisar revogar nada.
Sem exclusão: nenhuma ferramenta de exclusão é exposta.
Auditoria: consentimento, revogação e cada escrita ficam na trilha de
auditoria do Steel, com a origem MCP.
Dados com terceiros: o conteúdo que as ferramentas devolvem (descrição de
chamado, mensagem de WhatsApp, e-mail) vai para o provedor do cliente de IA
que você conectou. Avalie o provedor e conceda só os módulos de que precisa.
Texto de terceiros: mensagens e e-mails de clientes chegam ao modelo como
dados. Por isso exclusão fica fora e ações com cliente final pedem
confirmação no Steel.
Limites
O quê
Limite
Chamadas por pessoa
120 a cada 60 segundos
Chamadas por cliente OAuth (somando todas as pessoas)
Passou do limite de chamadas, a resposta é 429 com Retry-After, como no
resto da API (veja Limites de requisição).
Os clientes de IA costumam esperar e repetir sozinhos. As perguntas pelo MCP
não consomem a cota mensal do Steel AI: o modelo é do cliente.
Solução de problemas
Sintoma
O que fazer
O cliente pede login de novo a cada uso, ou responde 401
A conexão foi revogada, você saiu do workspace ou o refresh token expirou. Remova o conector e conecte de novo
A tela de consentimento não mostra um módulo
O módulo está desligado no workspace ou o seu papel não tem acesso a ele. Peça a um administrador
Uma ferramenta não aparece
O módulo não foi concedido na conexão, o seu papel não permite a ação ou ela é de escrita e a conexão é só leitura. Conecte de novo com os módulos e o escopo certos
Nenhuma ferramenta de escrita aparece com mcp:write
O administrador não ligou Permitir escrita via MCP em Ajustes › Steel IA
A ação voltou com pending_confirmation
É uma ação com cliente final. Abra o confirmUrl e confirme em até 30 minutos
Confirmar responde que a escrita via MCP está desligada
O administrador desligou o interruptor depois do pedido. Peça para ligar e repita a chamada
O cliente lê dados do workspace errado
Cada conexão vale para um workspace. Revogue em Apps conectados e conecte escolhendo o outro
405 no endereço do servidor
O cliente tentou GET (fluxo SSE antigo). Use um cliente com Streamable HTTP, ou a ponte mcp-remote
A resposta demora a chegar inteira, ou chega toda de uma vez no fim
Algum proxy entre o cliente e o Steel está segurando a resposta. Na sua rede, libere /api/mcp sem buffering
429
Limite de requisições. Espere o Retry-After
steel mcp sai com "Falta o token do MCP do Steel"
Defina STEEL_MCP_TOKEN com um access token stl_at_ (não o stl_pat_ do steel login)
steel mcp funcionava e passou a dar 401
O access token passou de 1 hora. Gere outro, ou troque para o mcp-remote
O modelo diz que não há ferramenta para o pedido
Com muitas ferramentas, a lista é enxuta: peça para ele usar steel_find_tools
A IA chamou a ação duas vezes
Use idempotencyKey nas escritas; para ações com cliente final, só a confirmação no Steel executa
Fila do usuário autenticado (agente do ServiceDesk): chamados abertos atribuídos a ele (scope "mine", padrão) ou sem responsável nos departamentos dele ("unassigned_in_my_departments"), ordenados pelo prazo de resolução…
Leitura
mcp:read
sd_search_config_items
Busca itens de configuração (CMDB) por nome, código, série, fabricante, modelo, local ou IP; filtros de status (PLANNED, IN_STOCK, ACTIVE, MAINTENANCE, RETIRED) e cliente.
Leitura
mcp:read
sd_search_contacts
Busca contatos do ServiceDesk por nome, cargo, e-mail, telefone ou WhatsApp, opcionalmente só de um cliente/empresa (nome ou id).
Leitura
mcp:read
sd_search_customers
Busca clientes (kind "client") e empresas (kind "company") do ServiceDesk por nome, nome fantasia, e-mail ou cidade.
Leitura
mcp:read
sd_search_kb
Busca artigos da base de conhecimento do ServiceDesk por relevância (texto), com filtros de status (DRAFT, IN_REVIEW, PUBLISHED — só agentes), visibilidade (INTERNAL, PORTAL), categoria e tag.
Leitura
mcp:read
sd_search_tickets
Busca chamados do ServiceDesk com filtros (texto/código, prática, fase, prioridade, responsável incluindo "me", departamento, solicitante, cliente/empresa, SLA em risco/violado, período de criação).
Leitura
mcp:read
sd_sla_at_risk
Resumo de SLA dos chamados abertos: contagens (minha fila, sem responsável, em risco, violados, criados hoje) e as listas dos chamados em risco e violados, do prazo mais próximo para o mais distante.
Leitura
mcp:read
sd_ticket_counts
Indicadores no estilo dashboard: chamados abertos por fase, prioridade, departamento e prática, e criados × resolvidos num período (`from`/`to`, padrão últimos 30 dias).
Leitura
mcp:read
sd_add_internal_note
Adiciona uma nota interna ao histórico do chamado — só agentes veem; o solicitante não é avisado.
Criação
mcp:write
sd_assign_ticket
Atribui ou reatribui um chamado: `assignee` (agente: "me", nome, e-mail ou id; "none" remove) e/ou `department` (nome ou id; "none" remove).
Edição
mcp:write
sd_cancel_ticket
Cancela um chamado (move para a fase de cancelamento do fluxo, encerrando-o).
Ação
mcp:write
sd_complete_ticket_task
Marca uma tarefa do chamado como concluída (id ou título).
Edição
mcp:write
sd_create_kb_draft_from_ticket
Fluxo KCS: cria um RASCUNHO de artigo da base a partir de um chamado (problema, causa, solução) e já o vincula ao chamado. `useAi` (padrão true) escreve o rascunho com a IA do ServiceDesk, sem dados pessoais; false entr…
Criação
mcp:write
sd_create_ticket
Abre um chamado no ServiceDesk.
Criação
mcp:write
sd_create_ticket_task
Cria uma tarefa no chamado: título, descrição, responsável (agente: "me", nome, e-mail ou id) e prazo (ISO 8601).
Criação
mcp:write
sd_link_config_item
Define o item de configuração (CMDB) do chamado: nome, código, IP ou id; "none" remove o vínculo.
Edição
mcp:write
sd_link_kb_article
Vincula um artigo da base de conhecimento ao chamado (aparece nos artigos vinculados; o solicitante não é avisado). `article`: id ou título (busca na base).
Criação
mcp:write
sd_move_ticket_phase
Move o chamado para outra fase do fluxo da prática (nome ou id da fase).
Edição
mcp:write
sd_reply_to_requester
Envia uma resposta PÚBLICA ao solicitante no histórico do chamado.
Ação
mcp:write
sd_request_approval
Pede aprovação do chamado por e-mail: cada aprovador (membro do workspace por nome/e-mail/id, ou e-mail externo) recebe um link próprio para aprovar ou reprovar; a primeira resposta decide. `expiresInDays` padrão 7 (1–6…
Ação
mcp:write
sd_update_ticket
Altera campos de um chamado: título, descrição, impacto/urgência (a prioridade é recalculada pela matriz), prioridade, severidade, catálogo (categoria/subcategoria/serviço), tags (substitui a lista) e campos customizado…
Edição
mcp:write
mcp:read
crm_get_trending_posts
Ranking dos posts publicados hoje (Instagram conectado e TikTok) por velocidade de engajamento — quanto mais visualizações/interações em menos tempo, mais em alta.
Leitura
mcp:read
crm_list_companies
Lista as empresas (contas) do CRM com filtros e paginação: trecho do nome/domínio/CNPJ, se é ICP (perfil de cliente ideal) e responsável pela conta.
Leitura
mcp:read
crm_list_competitors
Lista os concorrentes rastreados nas redes sociais (Instagram/YouTube) — handle, seguidores e status de sincronização.
Leitura
mcp:read
crm_list_leads
Lista os leads do CRM com filtros e paginação — nome, empresa, contato, origem, etapa, pontuação e responsável, com link.
Leitura
mcp:read
crm_list_opportunities
Lista as oportunidades (negócios) do funil com filtros e paginação: pipeline/etapa (nome ou id), status (OPEN em aberto, WON ganha, LOST perdida — vem da categoria da etapa), responsável, empresa, faixa de valor e de da…
Leitura
mcp:read
crm_list_people
Lista as pessoas (contatos) do CRM com filtros e paginação: trecho do nome/e-mail/telefone/cargo, empresa (nome ou id) e cidade.
Leitura
mcp:read
crm_list_pipelines
Lista os pipelines de vendas do workspace com suas etapas (nome, posição, probabilidade e categoria OPEN/WON/LOST).
Leitura
mcp:read
crm_list_proposals
Lista as propostas comerciais com filtros e paginação — nome, status (DRAFT, SENT, VIEWED, ACCEPTED, REJECTED, EXPIRED), validade, visualizações e vínculos (oportunidade, lead, empresa), com link.
Leitura
mcp:read
crm_list_tasks
Lista as tarefas do CRM com filtros e paginação.
Leitura
mcp:read
crm_assign_owner
Define (ou remove, com owner null) o responsável de um lead, oportunidade, empresa (responsável pela conta) ou tarefa. `owner` aceita "me", nome, e-mail ou id de um membro; nome ambíguo devolve as opções.
Ação
mcp:write
crm_close_lead_lost
Fecha um lead como PERDIDO, com motivo obrigatório (e observação/data para tentar de novo, opcionais).
Ação
mcp:write
crm_close_lead_won
Fecha um lead como GANHO (contrato assinado).
Ação
mcp:write
crm_create_company
Cria uma empresa (conta) no CRM.
Criação
mcp:write
crm_create_dashboard
Cria um dashboard vazio (sem widgets) no CRM; os widgets são montados depois no app do Steel, na tela do dashboard (o `href` devolvido).
Criação
mcp:write
crm_create_form
Cria um formulário público no CRM, com campos. `action` define o que cada envio gera (COMPANY empresa, PERSON pessoa, LEAD lead) e cada campo mapeia para um atributo dessa entidade via `mapping` — atributos válidos: lea…
Criação
mcp:write
crm_create_lead
Cria um lead no CRM (entra na etapa "Lead recebido"; pontuação e responsável vêm das regras do workspace).
Criação
mcp:write
crm_create_note
Cria uma nota no CRM, normalmente vinculada a uma empresa, pessoa ou oportunidade (ids).
Criação
mcp:write
crm_create_opportunity
Cria uma oportunidade (negócio).
Criação
mcp:write
crm_create_person
Cria uma pessoa (contato) no CRM, opcionalmente vinculada a uma empresa (nome, domínio, CNPJ ou id).
Criação
mcp:write
crm_create_proposal_template
Cria um modelo (template) de proposta comercial com o esqueleto de seções, na ordem desejada; o conteúdo de cada seção é editado depois no app do Steel, na tela do modelo.
Criação
mcp:write
crm_create_task
Cria uma tarefa no CRM, com prazo, responsável ("me", nome ou e-mail) e vínculo opcional a empresa, pessoa ou oportunidade (ids).
Criação
mcp:write
crm_move_opportunity_stage
Move uma oportunidade para outra etapa (nome ou id).
Ação
mcp:write
crm_reopen_lead
Reabre um lead PERDIDO (leads ganhos não reabrem).
Ação
mcp:write
crm_update_company
Altera dados de uma empresa.
Edição
mcp:write
crm_update_lead
Altera dados cadastrais de um lead (nome, contatos, empresa, cargo, cidade, LinkedIn, origem, canal).
Edição
mcp:write
crm_update_note
Altera uma nota (título, texto, vínculos).
Edição
mcp:write
crm_update_opportunity
Altera dados de uma oportunidade (nome, valor, probabilidade, previsão de fechamento, empresa, contato, origem).
Edição
mcp:write
crm_update_person
Altera dados de uma pessoa.
Edição
mcp:write
crm_update_task
Altera uma tarefa: título, descrição, status (DONE conclui), prazo e vínculos.
Edição
mcp:write
zap_contacts_search
Busca contatos do WhatsApp por nome ou número (`query`, opcional), em ordem alfabética. `optedOut` filtra quem pediu para sair das transmissões (LGPD).
Leitura
mcp:read
zap_conversation_get
Detalhes de uma conversa do WhatsApp e as últimas `messages` mensagens (padrão 20, máximo 50), da mais antiga para a mais nova.
Leitura
mcp:read
zap_conversation_summary_context
Devolve as últimas `messages` mensagens (padrão 30, máximo 50) de uma conversa do WhatsApp como transcrição, para VOCÊ resumir na resposta (não chama outro modelo).
Leitura
mcp:read
zap_conversations_list
Lista conversas do WhatsApp (mais recentes primeiro, fixadas no topo).
Leitura
mcp:read
zap_dashboard
Indicadores do atendimento por WhatsApp agora: conversas abertas (novas, em atendimento), com/sem responsável, não lidas, sob IA, com sentimento negativo, abertas por atendente e encerradas nos últimos `closedWindowDays…
Leitura
mcp:read
zap_groups_list
Lista os grupos do WhatsApp (só existem em conexões Z-API): nome, descrição, participantes e última mensagem. `query` filtra pelo nome; `archived` mostra os arquivados.
Leitura
mcp:read
zap_quick_replies_list
Lista as mensagens rápidas do WhatsApp (atalho, título e texto). `query` busca em atalho, título e texto.
Leitura
mcp:read
zap_templates_list
Lista os modelos de mensagem (templates da Meta) com status de aprovação (APPROVED, PENDING, REJECTED), idioma, categoria e texto.
Leitura
mcp:read
zap_broadcast_create_draft
Cria uma transmissão do WhatsApp como RASCUNHO (texto, sem mídia) para até 1000 contatos (`contactIds`, obtidos com zap_contacts_search) na conexão `connectionId`.
Criação
mcp:write
zap_contact_create
Cria um contato do WhatsApp. `waId` = número com DDI e DDD, só dígitos (ex.: 5511999998888). `name` e `description` são opcionais.
Criação
mcp:write
zap_contact_update
Altera nome e/ou descrição de um contato do WhatsApp.
Edição
mcp:write
zap_conversation_assign
Atribui (ou transfere, se já tiver responsável) uma conversa do WhatsApp a um membro. `userId` = id do usuário ou "me".
Edição
mcp:write
zap_conversation_close
Encerra uma conversa aberta do WhatsApp, com `reason` opcional (até 500 caracteres).
Edição
mcp:write
zap_conversation_reopen
Reabre uma conversa encerrada do WhatsApp (volta para "em atendimento" se tiver responsável, senão "nova").
Edição
mcp:write
zap_conversation_set_ai
Liga (`enabled: true`) ou desliga (`enabled: false`) a resposta automática da IA do WhatsApp na conversa indicada.
Edição
mcp:write
zap_conversation_unassign
Tira o responsável de uma conversa do WhatsApp (ela volta para a fila sem atendente).
Edição
mcp:write
zap_message_send_text
Envia uma mensagem de TEXTO ao cliente numa conversa aberta do WhatsApp (até 4096 caracteres).
Ação
mcp:write
zap_quick_reply_create
Cria uma mensagem rápida do WhatsApp: `shortcut` (atalho, sem a barra), `title` e `body` (texto).
Criação
mcp:write
zap_quick_reply_update
Altera atalho, título e/ou texto de uma mensagem rápida (omitir = sem alteração).
