{
  "markdown": "# iClips\n\n### MCP para iClips, o financeiro e as horas da sua agência em linguagem natural\n\nConverse 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.**\n\n- 💰 **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\n- ⏱️ **Horas apontadas por pessoa e por peça** — a hierarquia inteira de projeto, peça, workflow e atividade, com executor, departamento e tempo gasto\n- 🗂️ **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\n- 🎯 **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\n- 🔒 **Financeiro é somente leitura** — o iClips não expõe escrita no financeiro, então dinheiro só se mexe dentro do iClips\n- 💬 **Funciona com qualquer cliente MCP**: Claude Desktop, ChatGPT, Cursor, VS Code, Cline, Continue\n\n[English version](README.en.md) · [Documentação completa](docs/) · [Skill pra agentes](skills/)\n\n---\n\n## Instalar em 1 clique\n\n### Claude (Web e Desktop)\n\nA 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):\n\n[➕ Abrir no Claude e conectar](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors)\n\n**Manual** (se o deeplink não abrir): [claude.ai/customize/connectors](https://claude.ai/customize/connectors?surface=cowork) → **+** → **Adicionar conector personalizado** → cole **Nome** `iClips` e **URL** `https://api.mcp.ai/p_iclips`.\n\n### Cursor\n\n[➕ Instalar iClips no Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=iclips&config=eyJ1cmwiOiJodHRwczovL2FwaS5tY3AuYWkvcF9pY2xpcHMifQ==)\n\n### VS Code (Copilot Chat)\n\n[➕ Instalar iClips no VS Code](vscode:mcp/install?name=iclips&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.mcp.ai%2Fp_iclips%22%7D)\n\n### ChatGPT, Manus, OpenClaw e mais 40+ clientes\n\nFunciona em qualquer cliente MCP que suporte **MCP over HTTP**. A URL do servidor é sempre:\n\n```\nhttps://api.mcp.ai/p_iclips\n```\n\nDetalhes por cliente: [INSTALL.md](INSTALL.md).\n\n---\n\n## Exemplos de uso\n\n```\nQuanto a agência tem a pagar neste mês, agrupado por fornecedor?\nQuantas horas cada pessoa apontou nas peças do cliente X em janeiro?\nListe as notas fiscais emitidas no trimestre com o ISS retido de cada uma\nQuais contas a receber vencem nos próximos 15 dias?\nCrie um job para o cliente 42 com as tarefas de briefing e aprovação\nQuais etapas de workflow tiveram refação no mês passado?\n```\n\n---\n\n## 24 ferramentas disponíveis\n\n| Tool | Descrição |\n|---|---|\n| `iclips_list_accounts` | Lista as agências iClips (chaves de API) ligadas a este install, com id, apelido e nome. |\n| `iclips_financial_accounts` | Lista as contas bancárias ativas da agência no iClips (id, nome, isDefault, banco, agência e número da conta). |\n| `iclips_financial_entries_list` | Lê os lançamentos financeiros do iClips (entradas, saídas e o que está em aberto a pagar e a receber). |\n| `iclips_financial_entries_get` | Lê os lançamentos financeiros do iClips (entradas, saídas e o que está em aberto a pagar e a receber). |\n| `iclips_financial_invoices_list` | Lê as notas fiscais de serviço (NFS-e) emitidas pela agência no iClips. |\n| `iclips_financial_invoices_get` | Lê as notas fiscais de serviço (NFS-e) emitidas pela agência no iClips. |\n| `iclips_jobs_write_create` | Cria ou atualiza um job (projeto) no iClips. |\n| `iclips_jobs_write_update` | Cria ou atualiza um job (projeto) no iClips. |\n| `iclips_jobs_delete` | Exclui jobs (projetos) do iClips. |\n| `iclips_job_pieces_write_add` | Vincula uma peça do catálogo a um job existente, ou atualiza uma peça já vinculada a ele. |\n| `iclips_job_pieces_write_update` | Vincula uma peça do catálogo a um job existente, ou atualiza uma peça já vinculada a ele. |\n| `iclips_job_tasks_write_create` | Cria ou atualiza uma tarefa manual dentro de um job existente no iClips. |\n| `iclips_job_tasks_write_update` | Cria ou atualiza uma tarefa manual dentro de um job existente no iClips. |\n| `iclips_pieces_list` | Lê o catálogo de peças da agência no iClips. |\n| `iclips_pieces_get` | Lê o catálogo de peças da agência no iClips. |\n| `iclips_pieces_write_create` | Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist. |\n| `iclips_pieces_write_update` | Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist. |\n| `iclips_pieces_write_checklist` | Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist. |\n| `iclips_pieces_delete` | Exclui peças do catálogo do iClips (o provider faz exclusão lógica). |\n| `iclips_workflow_templates_list` | Lê os modelos de workflow configurados na agência no iClips. |\n| `iclips_workflow_templates_get` | Lê os modelos de workflow configurados na agência no iClips. |\n| `iclips_piece_categories_list` | Lista as categorias de peça disponíveis na agência (id e nome). |\n| `iclips_piece_categories_dropdown` | Lista as categorias de peça disponíveis na agência (id e nome). |\n| `iclips_projects_extract` | Extrai do iClips a hierarquia completa de projetos de um período: Jobs, Peças, Workflows, Atividades e Tarefas, até os apontamentos de hora. |\n\nDetalhe de cada tool: [docs/ferramentas.md](docs/ferramentas.md)\n\n\n---\n\n## O que dá para perguntar\n\n| Área | Cobertura | Escrita |\n|---|---|---|\n| **Financeiro** | Contas bancárias ativas, lançamentos de entrada e saída, contas a pagar e a receber com vencimento por parcela, categorias com indicador de DRE, centros de custo rateados, destinatário e fornecedor | Somente leitura |\n| **Notas fiscais** | Notas emitidas com valor bruto e líquido, base de cálculo, alíquota e valor do ISS, retenções de PIS, COFINS, INSS, IR e CSLL, tomador, emitente, RPS e motivo de cancelamento | Somente leitura |\n| **Jobs (projetos)** | Criar, atualizar e excluir projetos, com cliente ou grupo de clientes, status, prioridade, verba, responsável e auxiliar | Leitura e escrita |\n| **Peças** | Catálogo da agência com busca por nome, categoria e template base, workflow e checklist completos | Leitura e escrita |\n| **Peças e tarefas do job** | Vincular peça do catálogo a um projeto, criar e atualizar tarefas, marcar item do checklist de produção | Leitura e escrita |\n| **Templates e categorias** | Modelos de workflow configurados na agência e categorias de peça, que alimentam a criação de peças novas | Somente leitura |\n| **Extração para BI** | Hierarquia completa de projeto, peça, workflow, atividade e tarefa, com apontamento de horas, executor, departamento e refação | Somente leitura |\n\n### Antes de conectar, três avisos honestos\n\n1. **A chave exige plano PRO e permissão de administrador.** Ela sai em\n   Avatar, CHAVE DE API, dentro do iClips. Se a opção não aparece para você, ou\n   o seu usuário não é administrador, ou a agência não está no plano PRO. Sem a\n   chave não há o que conectar, com nenhuma ferramenta.\n2. **O financeiro é somente leitura, e isso é decisão do iClips.** A API pública\n   dele não expõe endpoint de escrita no financeiro. Ninguém cria, altera ou\n   apaga lançamento por fora do sistema, nem nós.\n3. **A extração de horas tem limite de ritmo.** O iClips permite 10 requisições\n   por minuto nesse endereço e janelas de até 31 dias por consulta. Relatório de\n   ano inteiro sai mês a mês, não num pedido só. O MCP já respeita as duas\n   regras e avisa antes de gastar a chamada, em vez de devolver erro do\n   servidor.\n\n---\n\n## Preços\n\nCobrança por conexão ativa. Veja [docs/precos.md](docs/precos.md).\n\n---\n\n## Privacidade & LGPD\n\n- **Sub-processadores**: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em [docs/privacidade-lgpd.md](docs/privacidade-lgpd.md).\n- 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.\n\n---\n\n## Perguntas frequentes\n\n**É o MCP oficial do iClips?**\nNã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.\n\n**Que dados vocês acessam?**\nSó 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.\n\n**Onde fica a minha chave?**\nCifrada, 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\n**Não acho a opção CHAVE DE API no meu iClips.**\nEla 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.\n\n**Dá para puxar o relatório de horas do ano inteiro de uma vez?**\nNã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.\n\n**Minha agência tem mais de uma conta no iClips. Funciona?**\nFunciona. 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.\n\n**Dá para lançar uma conta a pagar pelo chat?**\nNã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.\n\n\n---\n\n## Suporte\n\n- 📧 [iclips@mcp.ai](mailto:iclips@mcp.ai)\n- 🐛 [GitHub Issues](https://github.com/mcp-dir/iclips-mcp/issues)\n- 📄 [docs/](docs/)\n\n---\n\n## Licença\n\nMIT — veja [LICENSE](LICENSE). O servidor MCP em `api.mcp.ai/p_iclips` é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.\n",
  "bytes": 10932,
  "sha": "a26fe82aaf4b9737228e7ee953c5be5bba209dec6002c8ebf87ce93cc98bd353",
  "repo_slug": "mcp-dir/iclips-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mcp_dir_iclips_mcp_9188c2a2/readme"
}