> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maxicore.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart: connect an AI client and call abilities

> Connect your first AI client to Maxi AI Core, bootstrap a session, and make your first content and site-info ability calls in under ten minutes.

This guide walks you through connecting an AI client to your WordPress site and making your first ability calls. By the end, you'll have a working connection, a bootstrapped session, and your first piece of AI-created content saved as a draft.

## Before you start

Make sure you've installed the plugin and activated a license. If you haven't done that yet, see [Install Maxi AI Core](/installation) first.

<Steps>
  <Step title="Install and activate the plugin">
    Follow the [installation guide](/installation) to install Maxi AI Core and activate your Lite or Pro license. Once `maxi/get-site-info` returns `"status": "active"`, come back here.
  </Step>

  <Step title="Connect your AI client">
    Point your AI client at your site's MCP endpoint:

    ```text theme={null}
    https://yoursite.com/wp-json/mcp/mcp-adapter-default-server
    ```

    Replace `yoursite.com` with your actual domain.

    **With OAuth 2.1 (recommended)**

    Paste the URL above into your AI client (Claude Desktop, ChatGPT, Cursor, Codex, or any MCP-compatible client). The client sends a request to the endpoint, discovers the OAuth authorization server automatically, and opens a browser consent page. Log in to WordPress if prompted, then click **Authorize**. The client receives a Bearer token and is ready to use.

    You only need to authorize once per client. The token refreshes automatically in the background.

    **With application passwords (alternative)**

    If your client doesn't support OAuth, configure it to use HTTP Basic authentication with your WordPress username and a [WordPress application password](https://wordpress.org/documentation/article/application-passwords/) generated from your profile page.

    <Tip>
      OAuth is the recommended method for public AI clients. It requires no manual token management and automatically tracks connected clients in **Settings → AI Connections**.
    </Tip>
  </Step>

  <Step title="Bootstrap the session">
    Every Maxi AI Core session must begin with `maxi/bootstrap-session`. This is enforced server-side — all other abilities are blocked until you call it. Bootstrap delivers your operational playbook, any active operator instructions, and knowledge note headers to the agent.

    ```json theme={null}
    {
      "ability": "maxi/bootstrap-session"
    }
    ```

    The response includes the playbook content, operator notes, and available reference documents. The agent reads these before calling any other ability.

    <Note>
      If you skip `maxi/bootstrap-session`, every subsequent ability call returns an error. This is intentional — the bootstrap delivers the rules and context the agent needs to operate safely.
    </Note>
  </Step>

  <Step title="Make your first ability call">
    Call `maxi/get-site-info` to confirm the connection is working and check your license status:

    ```json theme={null}
    {
      "ability": "maxi/get-site-info"
    }
    ```

    A successful response:

    ```json theme={null}
    {
      "success": true,
      "data": {
        "site_name": "My Site",
        "site_url": "https://yoursite.com",
        "maxi_ai_version": "3.6.0",
        "maxi_ai_license": {
          "tier": "pro",
          "status": "active"
        }
      }
    }
    ```

    If you see `"success": true` with an active license, the connection is working correctly.
  </Step>

  <Step title="Create your first content">
    Use `maxi/create-content` to save a draft post:

    ```json theme={null}
    {
      "ability": "maxi/create-content",
      "input": {
        "post_type": "post",
        "title": "Hello from AI",
        "content": "<!-- wp:paragraph --><p>My first AI post.</p><!-- /wp:paragraph -->",
        "status": "draft"
      }
    }
    ```

    The response includes the new post ID. You can find the draft in **Posts** in your WordPress dashboard.

    <Note>
      Write abilities — including `maxi/create-content` — require the connected WordPress user to have the **Administrator** role. This is enforced server-side and cannot be overridden by rules. If you see a permission error, check that the authenticated user is an administrator.
    </Note>

    Content must be valid Gutenberg block markup. The example above uses a `wp:paragraph` block. You can also pass plain HTML or classic editor content — WordPress core's block parser accepts all of these.
  </Step>
</Steps>

## What's next

Now that you have a working connection, explore what Maxi AI Core can do:

* **[Abilities reference](/abilities/overview)** — browse all 70+ abilities, grouped by category.
* **[Connect AI clients](/connect/oauth)** — learn more about OAuth 2.1 setup and managing connected clients.
* **[Core concepts](/concepts/abilities)** — understand ability rules, sessions, and how the licensing gate works.
* **[WooCommerce abilities](/abilities/woocommerce-products)** — manage products, orders, and coupons if you're running a store.