#Conectar sua IA à Clickmax

Para a sua IA operar a Clickmax de verdade, ela precisa de duas peças que andam 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 HTTP (Claude Code, Cursor, Codex, etc.);
• um Bearer token válido da sua conta Clickmax (passo 1);
• terminal com npx disponível (passo 3).

#Passo 1 — Crie seu token MCP

Gere um token na sua conta:

O token tem o prefixo cx-token-:

cx-token-d803b54c48f98fad159f13db8349ddd6

#Passo 2 — Conecte o MCP

O servidor usa Streamable HTTP:

https://mcp.clickmax.io/mcp

Toda requisição precisa do header de autenticação:

Authorization: Bearer <SEU_TOKEN_MCP>

Escolha a aba do seu cliente e troque <SEU_TOKEN_MCP> pelo token do passo 1:

claude mcp add --transport http clickmax "https://mcp.clickmax.io/mcp" \
  --header "Authorization: Bearer <SEU_TOKEN_MCP>"

/mcp

{
  "mcpServers": {
    "clickmax": {
      "url": "https://mcp.clickmax.io/mcp",
      "headers": {
        "Authorization": "Bearer <SEU_TOKEN_MCP>"
      }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "clickmax": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.clickmax.io/mcp",
      "headers": {
        "Authorization": "Bearer <SEU_TOKEN_MCP>"
      }
    }
  }
}

[mcp_servers.clickmax]
url = "https://mcp.clickmax.io/mcp"
bearer_token_env_var = "CLICKMAX_MCP_TOKEN"

export CLICKMAX_MCP_TOKEN="cx-token-..."

{
  "mcpServers": {
    "clickmax": {
      "url": "https://mcp.clickmax.io/mcp",
      "headers": {
        "Authorization": "Bearer <SEU_TOKEN_MCP>"
      }
    }
  }
}

#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

#Boas práticas de segurança

• Nunca versione ou compartilhe o token em repositórios, prints ou logs.
• Prefira variáveis de ambiente quando o cliente suportar interpolação no header.
• Mantenha o nome do servidor como clickmax para facilitar identificação e suporte.
• Revogue o token imediatamente se suspeitar de exposição e gere um novo.