iClips MCP Bridge
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
iClips MCP Bridge
Servidor MCP que conecta o iClips (dados de projetos/jobs da agência) ao Claude, pra alimentar o "Farol" de capacidade da Vanguarda.
O que ele expõe
4 tools:
capacidade_do_dia— demanda x capacidade de entrega num dia, com déficit e jobs em risco.aging_por_etapa— jobs travados numa etapa (ex: "aprovação interna") há mais tempo que um threshold.custo_do_off— efeito cascata: horas de OFF vs jobs de escopo atrasados no mesmo período.auditoria_classificacao— % de títulos de job que classificam automaticamente como ON/OFF/Mídia Paga.
Related MCP server: Motion MCP Server
⚠️ Antes de rodar em produção
O endpoint principal usado aqui (GET /api/v1/projetos) é citado na Central de
Ajuda do iClips como o recurso de extração de BI, mas não está detalhado
na documentação técnica de referência (iclips.readme.io) — que só documenta
18 endpoints, todos de Financeiro/Jobs/Peças/Templates, sem exemplo de
request/response para esse.
Isso significa que os nomes de campos usados em src/tools/*.js (ex:
pecas, atividades, horasEstimadas, historicoStatus) são estimativas
baseadas na hierarquia descrita (Jobs → Peças → Workflows → Atividades e
Tarefas → Apontamentos de horas), não confirmadas contra uma resposta real.
Antes de usar de verdade:
Faça uma chamada de teste em
/api/v1/projetoscom seu token e confira a forma exata do JSON retornado.Ajuste os mapeamentos em
src/tools/capacidadeDoDia.js,agingPorEtapa.jsecustoDoOff.jspra bater com os nomes reais dos campos.Se o suporte do iClips não conseguir esclarecer a estrutura, considere usar
GET /api/v1/pieces/{id}(documentado oficialmente) como fonte alternativa do histórico de etapas viaworkflowJson/checklistJson.
Setup local
cp .env.example .env
# edite o .env e cole seu ICLIPS_API_KEY
npm install
npm run devO servidor sobe em http://localhost:3000, com o endpoint MCP em /sse.
Deploy no Render (gratuito)
Suba este projeto pra um repositório no GitHub.
Em render.com, crie um New Web Service apontando pro repo.
Configurações:
Build Command:
npm installStart Command:
npm startPlano: Free
Em Environment, adicione as variáveis do
.env.example:ICLIPS_API_KEY(seu token)CAPACIDADE_HORAS_POR_COLABORADOR(opcional, default 6)AGING_THRESHOLD_HORAS(opcional, default 2)
Deploy. A URL final será algo como
https://iclips-mcp-bridge.onrender.com, com o endpoint MCP emhttps://iclips-mcp-bridge.onrender.com/sse.
Nota sobre o plano free: o serviço "dorme" após ~15 min sem uso e demora cerca de 30s pra acordar na primeira chamada seguinte. Para uso interno da agência isso não costuma ser um problema.
Conectando no Claude
Depois de hospedado, use a URL /sse como MCP server customizado nas
configurações de conectores do Claude (ou no cliente MCP que vocês usarem).
Rate limit
A API do iClips permite 10 requisições/minuto no módulo de Extração de
Dados. O iclipsClient.js já implementa uma fila com espaçamento mínimo de
~6.1s entre chamadas pra nunca estourar esse limite — não é necessário (nem
recomendado) reduzir esse intervalo.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
iClips agency ERP for AI: payables, invoices, jobs, pieces and hours logged per person.
Claude connector and ChatGPT connector for trend data: Google, TikTok, YouTube, Reddit, Amazon
AI-native Kanban board — connect Claude to claim, work and move your tasks over MCP.
Your Aurentia workspace — projects, CRM, tasks, deliverables — in Claude, Cursor or any MCP client.
Related MCP Servers
- FlicenseBqualityDmaintenanceExposes Google Ads and Meta Marketing performance data, campaign settings, and change history to Claude (Cowork) for live daily-dashboard workflows.3-
- FlicenseNot gradedqualityDmaintenanceConnects Claude.ai to your Motion workspace, enabling task and project management via natural language.-
- AlicenseAqualityDmaintenanceBridges Microsoft Clarity's analytics API with Claude, enabling custom date ranges and page-level filtering on top of Clarity's native limitations.3MIT
- FlicenseNot gradedqualityDmaintenanceBridges Hyros attribution data to Claude via MCP tools, enabling real ROAS/revenue reconciliation by campaign and ad account.-