Aqui, você vai saber mais sobre:
O iClips MCP (Model Context Protocol) funciona como uma ponte inteligente de alta performance entre a base de dados do iClips ERP e os assistentes ou ambientes com Inteligência Artificial — como Claude Desktop, Claude.ai, Cursor, Codex, plataformas de automação (como n8n) ou qualquer outra ferramenta compatível com o protocolo MCP. Seu principal objetivo é transformar a relação com os dados operacionais e comerciais da sua agência: em vez de navegar por telas e relatórios manuais, você passa a interagir em linguagem natural e em tempo real no ambiente de IA da sua escolha.
O que é o iClips MCP?
O protocolo MCP permite que a IA leia o contexto operacional, analise gargalos e até execute cadastros comerciais sem que você precise sair da sua interface de trabalho ou IDE. Ele atua como um verdadeiro copiloto para diretores, gestores de tráfego, líderes de equipe e desenvolvedores.
A arquitetura opera com transporte Stateless (HTTP/SSE). A cada instrução enviada, a permissão do usuário é validada em tempo real contra os sistemas do iClips, garantindo que ninguém acesse ou altere informações de Squads ou Agências fora do seu escopo.
O que você consegue consultar e criar?
Diferente de consultas tradicionais, o iClips MCP expõe um conjunto avançado de ferramentas (Tools) que abrangem tanto a gestão operacional (leitura) quanto o cadastro comercial (escrita):
1. Leitura e Diagnóstico de Operações (Squads)
- list_squads: Identificação imediata dos Squads aos quais o usuário autenticado possui acesso.
- get_projects: Consulta de projetos ativos ordenados por nível de urgência e contagem exata de dias de atraso (SLAs).
- get_pieces: Monitoramento de peças em andamento no fluxo, identificando a etapa atual do workflow, tempo de permanência e recursos emprestados (CrossSquadResource).
- get_squad_availability: Visão detalhada da capacidade e horas alocadas por membro da equipe para determinada semana.
- get_rework_summary: Inteligência de qualidade que identifica o acumulado de refações e aponta membros com taxa de retrabalho acima da média do Squad.
- get_workflow_bottlenecks: Mapeamento de gargalos operacionais e peças estagnadas na mesma etapa há 3 ou mais dias.
- get_squad_summary: Painel executivo consolidado que analisa em tempo real o status de saúde do Squad (healthy, attention ou critical).
2. Escrita e Cadastro Comercial
- create_piece: Cadastro direto de novas peças comerciais na agência, definindo valores base e tabelas sindicais (Sindrapro, Fenapro e Sindicato) divididos em Criação, Finalização e Adaptação.
- create_pieces_bulk: Importação e criação em massa de até 5.000 peças em uma única chamada. Possui controle de idempotência e validação automática de duplicatas, sendo ideal para atualização de tabelas de preços completas (ex: Tabela SINAPRO).
Como é Calculada a Capacidade do Squad?
Para garantir precisão no diagnóstico de sobrecarga e prevenção de burnout, a API calcula a utilização com base na seguinte estrutura:
| Métrica / Conceito | Origem e Lógica de Cálculo |
|---|---|
| Capacidade Semanal Nominal | Derivada da carga horária mensal do funcionário (padrão de 176h/mês). Calculada pela fórmula: Capacidade Semanal = Horas Produtivas × (5.0 / 22.0). |
| Horas Alocadas | Soma o tempo estimado de Atividades de Peças no workflow com as Tarefas de Job ativas no período. |
| Zonas de Alerta de Capacidade | Disponível: Alocação abaixo de 60%.Saudável: Carga de trabalho equilibrada.Em Risco / Sobrecarga: Membros com alocação superior a 90% geram alertas de severidade alta (high). |
Dica de Especialista (Next Action Hint): Sempre que o MCP identifica um risco operacional (como atrasos críticos ou alocação >90%), a ferramenta anexa automaticamente uma sugestão de próxima ação recomendada para orientar o gestor na tomada de decisão.
Métodos de Autenticação e Segurança
A arquitetura foi desenvolvida para oferecer flexibilidade e total controle de acesso conforme o cliente/ferramenta utilizado:
- OAuth 2.1 com PKCE + DCR (Dynamic Client Registration): Método primário ideal para assistentes de chat como Claude Desktop e Claude.ai. O conector realiza o registro dinâmico e direciona o usuário para o login seguro do iClips v2.
- API Keys Públicas (iclips_sk_…): Chaves geradas diretamente no painel da agência, perfeitas para conexões em IDEs de desenvolvimento (Cursor, Codex, VS Code), scripts de automação, webhooks ou fluxos no n8n.
Toda a execução de regras de negócio ocorre de forma isolada no banco de dados SQL Server da agência, garantindo que nenhuma informação seja compartilhada entre contas diferentes.
Tabela Prática: O que perguntar ao Copiloto
| O que perguntar | Informação obtida | Benefício para a Gestão |
|---|---|---|
| “Como está o squad esta semana?” | Status consolidado e alertas de severidade (High, Medium, Low). | Identificação imediata de riscos antes que se tornem crises. |
| “Quais projetos estão atrasados?” | Lista de projetos ordenados por nível de urgência e dias de atraso. | Foco total na priorização e no cumprimento de SLAs. |
| “Quais peças estão com problema?” | Identifica peças paradas há 3+ dias ou com prazos vencidos. | Identifica gargalos invisíveis no workflow diário. |
| “Quem pode absorver demanda?” | Zonas de capacidade: Disponível (<60%), Saudável ou Em Risco (>90%). | Prevenção de burnout e otimização da distribuição de carga. |
| “Como está o retrabalho?” | Refações internas e de clientes por membro, comparadas à média. | Controle de qualidade e identificação de gaps de briefing ou técnica. |
| “Cadastre a nova tabela do SINAPRO” | Criação e atualização em lote de até 5.000 peças comerciais. | Automação e agilidade no cadastro comercial sem trabalho manual. |
Como Começar a Usar
A implementação varia de acordo com o ambiente escolhido:
Via Clientes com Suporte OAuth (ex: Claude Desktop / Claude.ai)
- Esteja logado no seu iClips.
- Acesse o Claude e clique em Personalizar.
- Clique em Conectores e depois em Adicionar.
- Dê um nome para o conector e no campo URL do servidor MCP Remoto digite https://public-api.iclips.com.br/mcp
- Clique em Continuar e depois em Adicionar.
- Clique em Vincular. Será aberta uma nova aba com a mensagem Claude quer acessar a sua conta iClips. Clique em Autorizar.
- A conexão será realizada e você já pode interagir com o chat do Claude fazendo perguntas relacionadas ao iClips. Em alguns casos pode ser necessário autorizar o Claude a realizar a consulta em iClips.
Via IDEs e Ferramentas de Desenvolvimento (ex: Cursor, Codex, n8n)
- Gere uma chave de API pública no painel da sua agência no iClips (iclips_sk_…).
- Configure o servidor MCP apontando para https://public-api.iclips.com.br/mcp informando a sua API Key nos headers de autenticação.
Para manter a agilidade, o sistema exibe por padrão 5 itens (limite de 50). No entanto, o gestor estratégico utiliza o Bypass: ao buscar por nomes exatos (de projetos, usuários ou IDs específicos), o sistema ignora os limites de paginação e entrega o dado profundo instantaneamente. Esta é a forma preferida de trabalho para resoluções rápidas.