For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/reference/api/mcp.md.
  • English
  • Connect your AI to Clickmax

    For your AI to genuinely operate Clickmax, it needs two pieces that go together:

    • MCP (Model Context Protocol) — gives the AI real-time access to your account's tools and data (leads, transactions, funnels, members…).
    • Skills — teach the AI to use Clickmax: the rules, concepts and flows of each area.
    Install both — one without the other does not work
    • MCP without Skills: the AI has the tools but does not understand Clickmax — and builds the wrong funnels, flows and segments.
    • Skills without MCP: the AI knows what to do but has nowhere to do it.

    The setup below connects the two. Follow the 4 steps in order.

    Prerequisites

    • a client that supports remote MCP over HTTP (Claude Code, Cursor, Codex, etc.);
    • a valid Bearer token for your Clickmax account (step 1);
    • a terminal with npx available (step 3).

    Step 1 — Create your MCP token

    Generate a token in your account:

    Create MCP token

    The token is prefixed with cx-token-:

    cx-token-d803b54c48f98fad159f13db8349ddd6
    Treat the token like a password

    It gives access to your account's data. Do not publish it in repositories, screenshots or logs. You can revoke it and generate another at any time on the same screen.

    Step 2 — Connect MCP

    The server uses Streamable HTTP:

    https://mcp.clickmax.io/mcp

    Every request needs the authentication header:

    Authorization: Bearer <SEU_TOKEN_MCP>

    Pick the tab for your client and swap <SEU_TOKEN_MCP> for the token from step 1:

    Claude Code
    Cursor
    OpenCode
    Codex
    Generic JSON
    claude mcp add --transport http clickmax "https://mcp.clickmax.io/mcp" \
      --header "Authorization: Bearer <SEU_TOKEN_MCP>"

    Then, inside a Claude Code session, check the connection:

    /mcp

    Step 3 — Install the Skills

    The public Agent Skills teach the AI to operate each area of the platform. Install them all with one command:

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

    The command discovers and installs the skills from the docs discovery index (/.well-known/agent-skills/index.json).

    The base URL on its own, to paste into the command:

    https://docs.clickmax.io

    Prefer to install manually? Download the package with every skill already organised into folders (<skill>/SKILL.md + reference files):

    Download clickmax-skills.zip

    Step 4 — Test

    With MCP connected and the skills installed, ask for a real task:

    Am I connected to Clickmax? Which account am I?
    Identify the hot leads with no contact in the last 7 days.

    If everything is right, the AI returns your identity, reads real data from the account and calls the skill that matches the task. If the client does not load the skill on its own, ask for it by name (e.g. Use the clickmax-pipelines skill…).

    Skills catalogue

    There are 17 public skills, grouped by area. The phrase "Use when" is the trigger the AI uses to load the skill — describe your task in those terms to call it up.

    CRM

    SkillUse when you want to…
    clickmax-leadsfind, inspect, filter or compare CRM leads and their commercial context
    clickmax-leads-activity-analysisanalyse activity streams, event timelines and activity metrics for leads and opportunities
    clickmax-list-segmentscreate, inspect, update, refresh or use manual lists and dynamic segments to group leads
    clickmax-pipelineswork with pipelines, stages, opportunity cards, attendants or pipeline analytics
    clickmax-tagsinspect, create, update, delete, clone or apply CRM tags to leads

    Payments and offers

    SkillUse when you want to…
    clickmax-payments-dashboard-analysissee payments dashboard KPIs, paginated views, "my sales" or filters for revenue analysis
    clickmax-transaction-operationsinspect transactions and sales, read transaction charts or refund one or more transactions
    clickmax-seller-subscriptionsinspect, chart, cancel, renew or change the card on customer subscriptions sold through Clickmax
    clickmax-offersinspect, create, clone, update, approve, archive or delete product offers and checkout variants
    clickmax-wallet-receivablescheck the wallet, receiving account approval, balances, "receivables", statements, withdrawals or readiness to sell
    clickmax-workspace-plansinspect, compare, predict cancellation of or cancel your own workspace's SaaS subscription

    Members

    SkillUse when you want to…
    clickmax-membersinspect, create, update, enable, disable, enrol or remove members and their access/progress
    clickmax-classroomslist, inspect, create, update, link content, copy members between or delete classrooms
    clickmax-moduleslist, inspect, create, update, reorder or delete modules and the lesson ordering of a course
    clickmax-portal-enrollmentslist, add, bulk add or remove enrolments at portal level

    Automations and funnels

    SkillUse when you want to…
    clickmax-flowscreate, inspect, change, validate or activate/archive an automation flow and its step graph
    clickmax-funnelscreate, inspect, change, publish, deactivate, delete or analyse a funnel graph
    Always-current catalogue

    The list above is a readable summary. The source of truth, with full descriptions and hashes, lives at /.well-known/agent-skills/index.json.

    For agents — programmatic discovery

    Endpoints served by the docs for clients compatible with Agent Skills:

    ResourceURL
    MCP endpoint (Streamable HTTP)https://mcp.clickmax.io/mcp
    Skills discovery index (schema 0.2.0)https://docs.clickmax.io/.well-known/agent-skills/index.json
    SKILL.md per skillhttps://docs.clickmax.io/.well-known/agent-skills/<skill>/SKILL.md
    Skill archive (with references)https://docs.clickmax.io/.well-known/agent-skills/<skill>.tar.gz
    Complete package (all the skills)https://docs.clickmax.io/.well-known/skills/clickmax-skills.zip

    Each index entry carries name, description, type (skill-md or archive), url and digest (sha256) for integrity checking.

    Troubleshooting

    SymptomLikely causeWhat to do
    401 / "unauthorized"token missing, invalid or revokedcheck the Authorization header and generate a new token
    The client does not list the clickmax toolthe server was not added, or the config did not reloadreopen the client and confirm the URL https://mcp.clickmax.io/mcp
    It connects but returns no datathe account has no permission for the resource requestedcheck that the token's user has access in Clickmax
    The AI is connected but gets the flows wrongskills not installedrun step 3 (npx skills add https://docs.clickmax.io)
    Timeout / transport failurethe client does not support Streamable HTTPuse a client compatible with remote MCP over HTTP

    Security good practice

    • Never commit or share the token in repositories, screenshots or logs.
    • Prefer environment variables when the client supports interpolation in the header.
    • Keep the server named clickmax to make it easier to identify and support.
    • Revoke the token immediately if you suspect it has been exposed, and generate a new one.