iClips

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.

Dá para puxar o relatório de horas do ano inteiro de uma vez? Não em um pedido só, e o limite é do iClips: a extração aceita janelas de até 31 dias e 10 requisições por minuto por chave. Peça mês a mês. O MCP valida a janela antes de chamar, então você recebe uma orientação clara em vez de um erro do servidor.

Minha agência tem mais de uma conta no iClips. Funciona? Funciona. Conecte uma chave por agência e diga na conversa qual delas você quer. Cada conexão fica separada, e uma chave que expira não derruba as outras.

Dá para lançar uma conta a pagar pelo chat? Não. O iClips não expõe escrita no módulo financeiro na API pública, então esse caminho não existe para nenhuma integração. Consulta, sim; lançamento, dentro do iClips.

Suporte

• 📧 iclips@mcp.ai
• 🐛 GitHub Issues
• 📄 docs/

Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_iclips é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.