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 gestão operacional (leitura), cadastro comercial de peças, gestão de jobs, tabela de preço de veículo, cadastro de mídia exterior e Financeiro:
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).ping: Ferramenta utilitária de diagnóstico — confirma se a conexão com o servidor MCP está ativa.
2. Escrita e Cadastro Comercial de Peças
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).
3. Gestão de Jobs (Projetos, Peças e Tarefas)
Diferente das ferramentas de leitura de Squads, estas não têm escopo por squad: qualquer job da agência pode ser criado, vinculado ou atualizado pelo copiloto.
create_job: Cria um novo job (projeto) do zero — cliente, status, datas, prioridade, verba — com a mesma paridade do endpoint público de criação. Pode já sair com peças do catálogo vinculadas, tarefas manuais e até gerar tudo automaticamente a partir de um modelo de job.create_job_peca: Vincula uma peça já cadastrada no catálogo a um job existente, definindo título, descrição e prioridade específicos daquele job.update_job_peca: Atualiza título, descrição, formato, serviço ou prioridade de uma peça já vinculada a um job.create_job_tarefa: Cria uma tarefa manual (sem peça associada) dentro de um job existente, com datas de início/fim e prioridade.update_job_tarefa: Atualiza título, descrição, datas, prioridade ou ordem de exibição de uma tarefa já vinculada a um job.
4. Tabela de Preço de Veículo — TV e Rádio
list_fornecedores_veiculo: Busca fornecedores marcados como veículo (emissoras de TV, por exemplo) pelo nome — resolve o nome no id usado pelas demais ferramentas desta seção.list_pracas: Busca praças (cidades/regiões de veiculação) pelo nome, para filtrar tabelas específicas de uma praça.list_tabelas_preco_veiculo: Lista as tabelas de preço cadastradas para um fornecedor numa mídia — a vigente de cada combinação praça/cliente e, opcionalmente, o histórico já arquivado.get_tabela_preco_veiculo_ativa: Consulta a grade completa (programas, horários e valores por duração de inserção) da tabela de preço vigente de um fornecedor.cadastrar_tabela_preco_veiculo: Cadastra uma nova tabela de preço — grade de programas × valores por duração de inserção — para um fornecedor numa mídia. Se já existir uma tabela vigente para a mesma combinação, ela é arquivada automaticamente e substituída; ou seja, a mesma ferramenta serve tanto para inserir quanto para atualizar.
5. Mídia Exterior — Bi-semanas
search_bi_semanas: Busca bi-semanas cadastradas — os períodos quinzenais usados para veiculação de Mídia Exterior — por código.import_bi_semanas_bulk: Importa bi-semanas em lote, substituindo o script SQL manual antes usado para esse cadastro.
6. Financeiro — Contas e Caixas
create_cash_account: Cria uma conta bancária (com banco, agência e conta) ou um caixa (sem banco) no módulo Financeiro, com saldo inicial, empresa vinculada e opção de defini-la como conta padrão.update_cash_account: Edita nome, empresa, saldo inicial, dados bancários ou status (ativa/inativa) de uma conta ou caixa já existente.
Limite de escopo: estas duas ferramentas cadastram e editam a conta em si. Elas não configuram boleto, juros ou vínculos com PJBank/TBanks — isso continua sendo feito pelas telas do Financeiro.
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. |
| “Cria um job pra campanha X com essas peças e tarefas” | Novo projeto já com peças e tarefas vinculadas, sem passar pela tela. | Abertura de job mais rápida no início de uma campanha. |
| “Qual é a tabela de preço vigente da Globo pra SP?” | Grade completa de programas, horários e valores por duração. | Consulta de grade e valores sem abrir a tela de cadastro. |
| “Cadastra a nova tabela de preço da [emissora]” | Grade de TV/Rádio cadastrada ou atualizada, com a anterior arquivada. | Atualização de tabela sem digitar linha por linha na tela. |
| “Importa essas bi-semanas de outdoor” | Períodos quinzenais de Mídia Exterior cadastrados em lote. | Substitui o script SQL manual usado até então. |
| “Cria a conta do Bradesco da Agência X” | Conta ou caixa criada no Financeiro, com banco/agência/conta. | Abertura de conta direto pelo chat, sem navegar até a tela. |
| “Inativa a conta Y” | Conta ou caixa existente inativada (ou reativada). | Ajustes rápidos de cadastro financeiro sem abrir o sistema. |
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/mcpinformando 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.