Como conectar minha IA à Clickmax com OAuth?
Adicione a URL do MCP ao seu cliente de IA, entre na Clickmax pela janela do navegador e autorize o acesso. Depois, instale as Skills para orientar a IA sobre como operar a plataforma.
Para a sua IA operar a Clickmax, ela precisa de duas peças que trabalham juntas:
- MCP (Model Context Protocol): dá à IA acesso em tempo real às ferramentas e aos dados da sua conta (leads, transações, funis, members…).
- Skills: ensinam a IA a usar a Clickmax: regras, conceitos e fluxos de cada área.
- MCP sem Skills: a IA tem as ferramentas, mas não entende a Clickmax — e cria funis, flows e segmentos errados.
- Skills sem MCP: a IA sabe o que fazer, mas não tem onde executar.
O setup abaixo conecta os dois. Faça os 4 passos na ordem.
Pré-requisitos
- um cliente com suporte a MCP remoto via Streamable HTTP e OAuth, registrado por Dynamic Client Registration (DCR) público ou por Client ID Metadata Document (CIMD);
- acesso à sua conta Clickmax pelo navegador;
- terminal com
npxdisponível (passo 3).
Passo 1 - Adicione o MCP
No seu cliente de IA (Claude, Codex, Grok, entre outros):
- Abra a configuração de servidores MCP.
- Copie a URL abaixo e adicione um novo servidor MCP.
- Use o nome
clickmax— é só um apelido local, para você identificar a conexão na lista. - Salve e inicie a conexão.
Prefere copiar em vez de digitar? Em Configurações > Conexões, na aba MCP, você encontra a mesma URL pronta para copiar.
Você foi levado a este guia — é o mesmo endereço que os clientes MCP usam para iniciar a autenticação.
Passo 2 - Entre e autorize pelo navegador
Ao iniciar a conexão, o cliente abre a autorização da Clickmax no navegador:
- Entre na sua conta Clickmax, caso ainda não esteja conectado.
- Confira qual cliente está solicitando acesso, quem o publicou, para onde o acesso será enviado (Retorno) e o que ele poderá fazer. Quando o retorno é um app no seu computador, a página avisa: continue só se você acabou de iniciar a conexão por ele.
- Selecione Permitir acesso uma vez. O botão mostra Conectando… enquanto a autorização é enviada.
- Volte ao cliente de IA para concluir a conexão. Em apps instalados, como Cursor e VS Code, a aba do navegador continua aberta e mostra Pode voltar para o app e fechar esta aba.
A autorização permite que o cliente use as ferramentas disponíveis no MCP para ler e alterar dados da sua conta Clickmax. Cancele se você não iniciou a conexão ou não reconhecer o cliente.
Passo 3 — Instale as Skills
As Agent Skills públicas ensinam a IA a operar cada área da plataforma. Instale todas com um comando:
O comando descobre e instala as skills a partir do índice de discovery do docs (/.well-known/agent-skills/index.json).
A URL base, isolada, para colar no comando:
Prefere instalar manualmente? Baixe o pacote com todas as skills já organizadas em pastas (<skill>/SKILL.md + arquivos de referência):
Baixar clickmax-skills.zip
Usa Claude Code? Instale o plugin e pule os passos 1 e 2
No Claude Code existe um caminho mais curto: o plugin oficial já vem com o MCP configurado e as skills juntas.
Na primeira vez que a IA usar uma ferramenta da Clickmax, a autorização abre no navegador — é o mesmo login do passo 2.
Ligue o auto-update, ou suas skills envelhecem
O plugin é republicado sempre que uma skill muda. Mas o Claude Code só busca atualizações de marketplaces com auto-update ligado, e marketplaces de fora vêm com ele desligado. Ligue uma vez:
- Rode
/plugin. - Vá para a aba Marketplaces.
- Selecione
clickmax-skills. - Escolha Enable auto-update.
Quando uma versão nova chega, o Claude Code avisa para rodar /reload-plugins; se você não rodar, ela entra no próximo start. Para atualizar na hora, sem esperar:
Sem esse passo, sua cópia local fica parada na versão instalada e a IA continua operando com regras antigas da plataforma — mesmo depois de a Clickmax mudar.
Mesmo sem auto-update, a IA percebe sozinha: o MCP compartilhado pelo plugin também anuncia a revisão publicada, e a IA avisa uma vez quando a skill carregada estiver atrás, indicando /plugin marketplace update clickmax-skills como o comando certo para quem instalou por aqui.
Usa Codex? Instale o plugin e pule os passos 1 e 2
No Codex também existe o caminho curto: o mesmo plugin junta MCP e skills num único install. Registre a fonte uma vez:
Depois instale — pela CLI ou por /plugins na TUI:
Sessão nova antes de usar.
Atualize na mão — Codex não tem auto-update pessoal
Diferente do Claude Code, não existe toggle de auto-update por marketplace. Publicamos versão nova do plugin e sua cópia instalada fica parada na versão antiga até você rodar:
Workspace Business/Enterprise é a exceção: o admin importa este mesmo repositório em Admin > Plugins > Import marketplace e o marketplace passa a sincronizar sozinho todo dia, com Sync now pra forçar na hora.
Aqui também a IA percebe sozinha quando a cópia ficou pra trás, e indica codex plugin marketplace upgrade clickmax-skills como o comando certo.
Mantenha as skills atualizadas nos outros clientes
Nos demais clientes não existe atualização automática: a cópia baixada fica parada na versão do dia da instalação.
Você fica sabendo por dois caminhos, sem precisar conferir nada.
O primeiro: cada SKILL.md publicado leva a revisão em que foi gerado, e o MCP informa a revisão atual ao conectar. Se as duas não baterem — ou se a skill instalada for antiga demais para ter revisão —, a IA avisa uma vez e segue com a tarefa; o aviso nunca trava o trabalho.
O segundo não depende da IA reparar em nada: quando publicamos uma versão nova, a primeira ação que a sua IA executar na Clickmax depois disso traz um aviso curto junto com a resposta, e o mesmo aviso aparece no sino do Clickmax — clicar nele abre esta página em uma nova aba. Esse segundo aviso não se repete — ele volta só na próxima vez que as Skills mudarem de verdade.
Quando ele aparecer (ou quando notar a IA errando algo que a plataforma já mudou), rode:
Use -g para as skills instaladas no seu usuário, que é o padrão do passo 3. Sem -g, o comando atualiza as skills da pasta do projeto atual.
O comando compara sua cópia com o índice publicado e baixa de novo só as skills que mudaram.
Passo 4 — Teste
Com MCP conectado e skills instaladas, peça uma tarefa real:
Se tudo estiver certo, a IA retorna sua identidade, lê dados reais da conta e aciona a skill correspondente à tarefa. Se o cliente não carregar a skill sozinho, peça pelo nome (ex.: Use a skill clickmax-pipelines…).
As skills citam as ferramentas pelo nome que a Clickmax registra, como leads_search. Vários clientes acrescentam um prefixo próprio ao exibir a mesma ferramenta — mcp__clickmax__leads_search, mcp_clickmax_leads_search e outras variações, conforme o cliente e a forma como você conectou.
É a mesma ferramenta, e a IA faz essa ligação sozinha. Se você precisar citar uma tool manualmente (numa permissão ou numa regra do seu cliente), use o nome já prefixado que aparece na lista de ferramentas do próprio cliente, não o nome da skill.
Catálogo de skills
São 33 skills públicas, agrupadas por área. A frase "Use quando" é o gatilho que a IA usa para carregar a skill — descreva sua tarefa nesses termos para acioná-la.
CRM
Pagamentos e ofertas
Members
Automações e funis
Canais
Análise e resultados
Ajuda
A lista acima é um resumo legível. A fonte de verdade, com descrições completas e hashes, fica em /.well-known/agent-skills/index.json.
Para agentes — discovery programático
Endpoints servidos pelo docs para clientes compatíveis com Agent Skills:
Cada entrada do índice traz name, description, type (skill-md ou archive), url e digest (sha256) para verificação de integridade.
O índice traz ainda revision no topo: a revisão do conjunto de skills publicado, que muda só quando alguma skill muda. É o mesmo valor estampado em metadata.revision e no rodapé de cada SKILL.md, e o mesmo que o MCP anuncia ao conectar — compare os dois para saber se uma cópia local está velha.
Limite de requisições
O MCP aceita até 100 requisições a cada 10 segundos por usuário. Todas as conexões e clientes MCP autorizados pela mesma conta compartilham esse limite.
Esse limite é separado do limite por workspace da API pública. Quando ele é ultrapassado, o MCP retorna 429 rate limit exceeded; aguarde alguns segundos antes de tentar novamente.
Escolha o workspace para cada tarefa
Se a sua conta participa de mais de um workspace, a IA começa chamando workspaces_list. A resposta mostra os workspaces ativos que você pode usar, com id, nome, slug, imagem e papel atual.
Se houver mais de um e você não disse qual usar, a IA pergunta antes de consultar ou alterar dados — ela não escolhe sozinha. Antes de uma alteração, ela diz em qual workspace vai mexer; quando só tem o ID, usa workspaces_get para confirmar o nome do workspace e o seu papel nele.
Em seguida, a IA envia o workspaceId escolhido em cada ferramenta que lê ou altera dados. Esse ID precisa ser um dos retornados por workspaces_list. Se você perder o acesso a um workspace, as próximas chamadas para ele são bloqueadas; peça para a IA listar os workspaces novamente e escolha outro disponível.
O Max já usa automaticamente o workspace aberto na Clickmax, sem pedir esse campo. Chaves da API pública continuam vinculadas ao workspace em que foram criadas e não podem trocar de workspace na requisição.
Solução de problemas
Antes de autorizar
- Confirme que você iniciou a conexão e reconhece o cliente exibido no navegador.
- Leia o consentimento antes de permitir acesso aos dados e às ferramentas da sua conta.
- Se não quiser concluir a conexão, cancele a autorização.