The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the IClips listing page.
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.
English version · Documentação completa · Skill pra agentes
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):
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.
Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:
Detalhes por cliente: INSTALL.md.
| Tool | Descrição |
|---|---|
iclips_list_accounts | Lista as agências iClips (chaves de API) ligadas a este install, com id, apelido e nome. |
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). |
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). |
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). |
iclips_financial_invoices_list | Lê as notas fiscais de serviço (NFS-e) emitidas pela agência no iClips. |
iclips_financial_invoices_get | Lê as notas fiscais de serviço (NFS-e) emitidas pela agência no iClips. |
iclips_jobs_write_create | Cria ou atualiza um job (projeto) no iClips. |
iclips_jobs_write_update | Cria ou atualiza um job (projeto) no iClips. |
iclips_jobs_delete | Exclui jobs (projetos) do iClips. |
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. |
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. |
iclips_job_tasks_write_create | Cria ou atualiza uma tarefa manual dentro de um job existente no iClips. |
iclips_job_tasks_write_update | Cria ou atualiza uma tarefa manual dentro de um job existente no iClips. |
iclips_pieces_list | Lê o catálogo de peças da agência no iClips. |
iclips_pieces_get | Lê o catálogo de peças da agência no iClips. |
iclips_pieces_write_create | Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist. |
iclips_pieces_write_update | Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist. |
iclips_pieces_write_checklist | Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist. |
iclips_pieces_delete | Exclui peças do catálogo do iClips (o provider faz exclusão lógica). |
iclips_workflow_templates_list | Lê os modelos de workflow configurados na agência no iClips. |
iclips_workflow_templates_get | Lê os modelos de workflow configurados na agência no iClips. |
iclips_piece_categories_list | Lista as categorias de peça disponíveis na agência (id e nome). |
iclips_piece_categories_dropdown | Lista as categorias de peça disponíveis na agência (id e nome). |
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. |
Detalhe de cada tool: docs/ferramentas.md
| Área | Cobertura | Escrita |
|---|---|---|
| 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 |
| 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 |
| Jobs (projetos) | Criar, atualizar e excluir projetos, com cliente ou grupo de clientes, status, prioridade, verba, responsável e auxiliar | Leitura e escrita |
| Peças | Catálogo da agência com busca por nome, categoria e template base, workflow e checklist completos | Leitura e escrita |
| 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 |
| 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 |
| 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 |
Cobrança por conexão ativa. Veja docs/precos.md.
É 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.
MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_iclips é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.