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

# Connect to AI Assistants

> Connect AutoPrintFarm to Claude, ChatGPT, Grok, Perplexity, and other AI assistants so you can ask about your farm in plain language and get live answers.

Connect AutoPrintFarm to the AI assistant you already use — **Claude, ChatGPT,
Grok, Perplexity, and more** — and ask about your farm in plain language.
"Which printers are idle right now?" "What's low on stock?" "How many orders
shipped this week?" Your assistant pulls the answer straight from your account.

There's nothing to install and no key to copy. You connect once, sign in, pick
your farm, and you're done.

<Card title="Your connection link" icon="plug">
  Paste this into your assistant when it asks for a server or connector URL:

  ```
  https://api.autoprintfarm.com/mcp
  ```
</Card>

## How connecting works

<Steps>
  <Step title="Add the link">
    Paste `https://api.autoprintfarm.com/mcp` into your assistant's connector
    settings. Step-by-step instructions for each assistant are below.
  </Step>

  <Step title="Sign in">
    Your assistant opens a browser to AutoPrintFarm. Sign in the way you normally
    do — no key or token to paste.
  </Step>

  <Step title="Pick your farm and approve">
    Choose which farm to connect and approve the read-only access. The connection
    locks to that **one** farm.
  </Step>

  <Step title="Ask away">
    Your assistant can now answer questions about your farm. Nothing else to set up.
  </Step>
</Steps>

<Note>
  You must be an **owner** or **admin** of the farm you want to connect.
  Operators and viewers can't authorize an AI connection.
</Note>

## What your assistant can see

The connection is **read-only**. Your assistant can read:

<CardGroup cols={2}>
  <Card title="Printers & hubs" icon="print">
    Fleet status, live telemetry (temps, progress, current layer), models,
    locations, and hub health.
  </Card>

  <Card title="Print jobs" icon="list-check">
    Queued, active, and historical jobs, job detail, and job stats.
  </Card>

  <Card title="Inventory & SKUs" icon="boxes-stacked">
    Finished-goods stock, low-stock alerts, SKUs, and bills of materials.
  </Card>

  <Card title="Products" icon="cube">
    Catalog products and their assembly components.
  </Card>

  <Card title="Orders" icon="receipt">
    Sales orders, line items, and order stats across platforms.
  </Card>

  <Card title="Worklist & wiki" icon="clipboard-list">
    Worklist tasks and your internal wiki articles.
  </Card>

  <Card title="Analytics" icon="chart-line">
    Production, printer utilization, failures, inventory, and revenue reports.
  </Card>
</CardGroup>

<Warning>
  Your assistant can **read** your farm — it can't start prints, change settings,
  send printer commands, or modify any data. Controlling hardware and writing
  data are never exposed to AI assistants.
</Warning>

## Connect your assistant

Pick your assistant below. In every case the link to paste is the same:
`https://api.autoprintfarm.com/mcp`.

<Tabs>
  <Tab title="Claude">
    Claude has a built-in connector menu — no files to edit.

    <Steps>
      <Step title="Open connector settings">
        In Claude (web or desktop), go to **Customize → Connectors**.
      </Step>

      <Step title="Add a custom connector">
        Click **+** and choose **Add custom connector**.
      </Step>

      <Step title="Paste the link">
        Enter `https://api.autoprintfarm.com/mcp` and name it `AutoPrintFarm`.
      </Step>

      <Step title="Connect">
        Click **Add**, then **Connect**, and complete the
        **Continue with AutoPrintFarm** sign-in.
      </Step>
    </Steps>

    <Note>
      Custom connectors need a paid Claude plan (Pro or Max). On Team or
      Enterprise, an owner adds it once for the whole organization. See
      [Claude's custom connector guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)
      if the menu looks different in your version.
    </Note>
  </Tab>

  <Tab title="ChatGPT">
    Custom connectors live behind ChatGPT's **Developer mode** — you turn it on
    once.

    <Steps>
      <Step title="Turn on Developer mode">
        Open **Settings → Connectors**, click **Advanced** at the bottom, and
        turn on **Developer mode**.
      </Step>

      <Step title="Create a connector">
        Back on **Settings → Connectors**, click **Create**.
      </Step>

      <Step title="Paste the link">
        Set the server URL to `https://api.autoprintfarm.com/mcp` and give it a
        name like `AutoPrintFarm`.
      </Step>

      <Step title="Sign in">
        Complete the **Continue with AutoPrintFarm** prompt.
      </Step>
    </Steps>

    <Note>
      Custom connectors are available on paid ChatGPT plans (Plus, Pro, Team,
      Enterprise, Edu). See OpenAI's
      [Developer mode & MCP connectors help](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta)
      if the menu differs.
    </Note>
  </Tab>

  <Tab title="Grok">
    Grok lets you add any connector from its connectors page.

    <Steps>
      <Step title="Open the connectors page">
        Go to [grok.com/connectors](https://grok.com/connectors).
      </Step>

      <Step title="Add a custom connector">
        Click **New Connector**, then choose **Custom**.
      </Step>

      <Step title="Paste the link">
        Enter `https://api.autoprintfarm.com/mcp`.
      </Step>

      <Step title="Sign in">
        Complete the **Continue with AutoPrintFarm** prompt. Grok then finds the
        farm data it can read.
      </Step>
    </Steps>

    <Note>
      Custom connectors need a paid Grok account and work in Grok on web, iOS,
      and Android. See xAI's
      [Connectors announcement](https://x.ai/news/grok-connectors) for the latest.
    </Note>
  </Tab>

  <Tab title="Perplexity">
    <Steps>
      <Step title="Open connector settings">
        Go to **Settings → Connectors**.
      </Step>

      <Step title="Add a custom connector">
        Click **+ Custom connector** and choose **Remote**.
      </Step>

      <Step title="Paste the link">
        Enter `https://api.autoprintfarm.com/mcp` and pick **OAuth** for sign-in.
      </Step>

      <Step title="Save and sign in">
        Save, then complete the **Continue with AutoPrintFarm** prompt.
      </Step>
    </Steps>

    <Note>
      Custom connectors are available on Perplexity Pro, Max, and Enterprise. See
      Perplexity's
      [MCP connectors help](https://www.perplexity.ai/help-center/en/articles/11502712-local-and-remote-mcps-for-perplexity)
      if the menu differs.
    </Note>
  </Tab>

  <Tab title="Mistral Le Chat">
    <Steps>
      <Step title="Open the connectors page">
        In Le Chat, open **Connectors** and click **+ Add Connector**.
      </Step>

      <Step title="Choose a custom connector">
        Switch to the **Custom MCP Connector** tab.
      </Step>

      <Step title="Paste the link">
        Name it `AutoPrintFarm` and set the server URL to
        `https://api.autoprintfarm.com/mcp`.
      </Step>

      <Step title="Connect">
        Click **Connect** and complete the **Continue with AutoPrintFarm** sign-in.
      </Step>
    </Steps>

    <Note>
      Custom MCP connectors are available on all Le Chat plans. See Mistral's
      [MCP connectors docs](https://docs.mistral.ai/le-chat/knowledge-integrations/connectors/mcp-connectors)
      if the menu differs.
    </Note>
  </Tab>
</Tabs>

## Using a coding tool?

If you work in an IDE or terminal, point any MCP-capable tool at the same link.
These need a little more setup than the chat assistants above.

<Tabs>
  <Tab title="Claude Code">
    Add the server from a terminal:

    ```bash Terminal theme={null}
    claude mcp add --transport http autoprintfarm https://api.autoprintfarm.com/mcp
    ```

    The next time Claude Code uses it, a browser opens for the
    **Continue with AutoPrintFarm** sign-in. Check the connection anytime with `/mcp`.
  </Tab>

  <Tab title="Cursor">
    Add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one
    project), then authenticate the `autoprintfarm` server when Cursor prompts:

    ```json mcp.json theme={null}
    {
      "mcpServers": {
        "autoprintfarm": {
          "url": "https://api.autoprintfarm.com/mcp"
        }
      }
    }
    ```

    <Note>
      Config keys can change between Cursor versions — see the
      [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol)
      if this doesn't match your build.
    </Note>
  </Tab>

  <Tab title="Codex CLI">
    Add an entry to `~/.codex/config.toml`, then complete the sign-in when Codex
    prompts:

    ```toml ~/.codex/config.toml theme={null}
    [mcp_servers.autoprintfarm]
    url = "https://api.autoprintfarm.com/mcp"
    ```

    <Note>
      The exact keys for a remote MCP server have changed across Codex releases —
      check the current [Codex docs](https://github.com/openai/codex) if this
      doesn't load.
    </Note>
  </Tab>

  <Tab title="VS Code (Copilot)">
    Add this to `.vscode/mcp.json` in your workspace, then run **MCP: List
    Servers**, start `autoprintfarm`, and sign in:

    ```json .vscode/mcp.json theme={null}
    {
      "servers": {
        "autoprintfarm": {
          "type": "http",
          "url": "https://api.autoprintfarm.com/mcp"
        }
      }
    }
    ```

    <Note>
      See the
      [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
      if the keys differ in your version.
    </Note>
  </Tab>

  <Tab title="MCP Inspector">
    To test the connection directly, run the official inspector:

    ```bash Terminal theme={null}
    npx @modelcontextprotocol/inspector
    ```

    Set **Transport Type** to **Streamable HTTP**, use
    `https://api.autoprintfarm.com/mcp`, click **Connect**, and complete the
    sign-in. Then try the `ping` tool to confirm which farm you're connected to.
  </Tab>
</Tabs>

## What you can ask

Once connected, just ask — your assistant picks the right data:

* "Which printers are idle right now?"
* "How many orders shipped this week?"
* "What's low on stock?"
* "Show me failed jobs from the last 7 days and the most common failure type."
* "What's the success rate per printer this month?"
* "Which worklist tasks are overdue?"

## Managing connections

Each connection is tied to **exactly one farm** — your data never crosses farms.
To disconnect an assistant or switch the farm it's tied to, open the
AutoPrintFarm dashboard and go to **Settings → Connected AI Apps**. Removing
access there immediately cuts off the assistant.

<Note>
  **Troubleshooting**

  * **"Not authorized" when signing in** — you must be an **owner** or **admin**
    of the farm. Operators and viewers can't authorize an AI connection.
  * **Wrong farm, or data missing** — each connection serves one farm. Reconnect
    and pick a different farm, or switch it under **Settings → Connected AI Apps**.
  * **Assistant won't start a print or change a setting** — that's expected. The
    connection is read-only.
  * **Connector won't connect** — double-check the link is exactly
    `https://api.autoprintfarm.com/mcp`, and that your plan supports custom
    connectors (most assistants require a paid plan).
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="REST API" icon="code" href="/introduction">
    Prefer scripts over chat? The same data is available over a key-authenticated
    REST API.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    How API keys and scopes work for the REST API.
  </Card>
</CardGroup>