iClips

MCP para iClips, o financeiro e as horas da sua agência em linguagem natural

Converse com o iClips da sua agência a partir do Claude, do ChatGPT ou de qualquer cliente MCP. Roda sobre a API pública oficial do iClips, com a chave da sua própria agência. A cunha aqui é o que costuma virar planilha: o financeiro completo (contas bancárias, contas a pagar e a receber com vencimento por parcela, notas fiscais emitidas com os impostos retidos) e a extração de horas apontadas, descendo até quem executou cada etapa, quanto tempo levou e de qual departamento é. Também cria e atualiza jobs, peças e tarefas, e marca item de checklist de produção. Não afiliado ao iClips.

• 💰 O financeiro que vira planilha — contas bancárias, contas a pagar e a receber com o vencimento de cada parcela, notas fiscais emitidas com ISS, PIS, COFINS, INSS, IR e CSLL retidos
• ⏱️ Horas apontadas por pessoa e por peça — a hierarquia inteira de projeto, peça, workflow e atividade, com executor, departamento e tempo gasto
• 🗂️ Jobs e peças, de ida e volta — cria e atualiza projetos, vincula peças do catálogo, adiciona tarefas e marca item de checklist de produção
• 🎯 Filtra do jeito que a agência pensa — por cliente, fornecedor, categoria, indicador de DRE, centro de custo, conta bancária ou job específico
• 🔒 Financeiro é somente leitura — o iClips não expõe escrita no financeiro, então dinheiro só se mexe dentro do iClips
• 💬 Funciona com qualquer cliente MCP: Claude Desktop, ChatGPT, Cursor, VS Code, Cline, Continue

English version · Documentação completa · Skill pra agentes

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome iClips e URL https://api.mcp.ai/p_iclips.

Cursor

➕ Instalar iClips no Cursor

VS Code (Copilot Chat)

➕ Instalar iClips no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_iclips

Detalhes por cliente: INSTALL.md.

Exemplos de uso

Quanto a agência tem a pagar neste mês, agrupado por fornecedor?
Quantas horas cada pessoa apontou nas peças do cliente X em janeiro?
Liste as notas fiscais emitidas no trimestre com o ISS retido de cada uma
Quais contas a receber vencem nos próximos 15 dias?
Crie um job para o cliente 42 com as tarefas de briefing e aprovação
Quais etapas de workflow tiveram refação no mês passado?

24 ferramentas disponíveis

Detalhe de cada tool: docs/ferramentas.md

O que dá para perguntar

Antes de conectar, três avisos honestos

1. A chave exige plano PRO e permissão de administrador. Ela sai em Avatar, CHAVE DE API, dentro do iClips. Se a opção não aparece para você, ou o seu usuário não é administrador, ou a agência não está no plano PRO. Sem a chave não há o que conectar, com nenhuma ferramenta.
2. O financeiro é somente leitura, e isso é decisão do iClips. A API pública dele não expõe endpoint de escrita no financeiro. Ninguém cria, altera ou apaga lançamento por fora do sistema, nem nós.
3. A extração de horas tem limite de ritmo. O iClips permite 10 requisições por minuto nesse endereço e janelas de até 31 dias por consulta. Relatório de ano inteiro sai mês a mês, não num pedido só. O MCP já respeita as duas regras e avisa antes de gastar a chamada, em vez de devolver erro do servidor.

Preços

Cobrança por conexão ativa. Veja docs/precos.md.

Privacidade & LGPD

• Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
• Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

É o MCP oficial do iClips? Não. Este é um MCP independente, que fala com a API pública oficial do iClips usando a chave da sua própria agência. Não é afiliado ao iClips e não implica parceria. O iClips tem o MCP dele, focado em squads, projetos e peças; este cobre a parte que a API pública expõe e que costuma virar planilha: o módulo financeiro inteiro e a extração de horas apontadas. iClips é marca do seu titular, citada aqui de forma nominativa.

Que dados vocês acessam? Só os que a chave da sua agência já alcança. O financeiro é somente leitura por decisão do próprio iClips. Em projetos e peças há escrita, e ela é explícita: criar job, vincular peça, criar tarefa, marcar checklist. Nada acontece sem você pedir.

Onde fica a minha chave? Cifrada, e usada só no cabeçalho de autenticação das chamadas à API pública do iClips. Ela não aparece em resposta de ferramenta nem em log.

Não acho a opção CHAVE DE API no meu iClips. Ela só aparece para usuários com permissão de administrador, e a API pública está disponível no plano PRO. Se você é administrador e mesmo assim não vê a opção, o caminho é falar com o time do iClips sobre o plano da sua agência.