#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.

#Pré-requisitos

• um cliente com suporte a MCP remoto via Streamable HTTP, OAuth e Dynamic Client Registration (DCR) público;
• acesso à sua conta Clickmax pelo navegador;
• terminal com npx disponível (passo 3).

#Passo 1 - Adicione o MCP

No seu cliente de IA:

1. Abra a configuração de servidores MCP.
2. Adicione um servidor MCP remoto via Streamable HTTP.
3. Use o nome clickmax e informe somente esta URL:

https://mcp.clickmax.io/mcp

Ao abrir esse endereço diretamente no navegador, você será levado a este guia. Clientes MCP usam o mesmo endereço para iniciar a autenticação.

4. 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.

#Passo 2 - Entre e autorize pelo navegador

Ao iniciar a conexão, o cliente abre a autorização da Clickmax no navegador:

1. Entre na sua conta Clickmax, caso ainda não esteja conectado.
2. Confira qual cliente está solicitando acesso e o que ele poderá fazer.
3. Selecione Permitir acesso.
4. Volte ao cliente de IA para concluir a conexão.

#Passo 3 — Instale as Skills

As Agent Skills públicas ensinam a IA a operar cada área da plataforma. Instale todas com um comando:

npx skills add https://docs.clickmax.io

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:

https://docs.clickmax.io

Prefere instalar manualmente? Baixe o pacote com todas as skills já organizadas em pastas (<skill>/SKILL.md + arquivos de referência):

#Passo 4 — Teste

Com MCP conectado e skills instaladas, peça uma tarefa real:

Estou conectado ao Clickmax? Qual conta eu sou?

Identifique os leads quentes sem contato recente nos últimos 7 dias.

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…).

#Catálogo de skills

São 17 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

#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.

#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.