Pro & Power Tools

Give an AI assistant access with Agent Access

Create a scoped API key so Claude, Cursor, ChatGPT, or another AI assistant can search the catalog, see your stores and products, and draft listings for you, all limited to your own account.

Agent Access lets you hand an AI assistant a key to your Printonic account so it can do real work for you in natural language: search the Printonic catalog, look at your connected stores and products, and create listing drafts. Each key is limited to your account and to the exact permissions you choose.

The feature is in Beta, and it is designed to be safe by default. Even with every permission enabled, an assistant can only create unpublished drafts. Nothing goes live in your store and nothing is charged until you review and publish from your dashboard.

1. 1

   Dashboard > Agent Access

   Open Agent Access

   In your dashboard sidebar, click Agent Access (look for the key icon and the Beta badge). The page has two panels: Create an agent key on the left, and Active and revoked keys on the right.

   Keys created here only operate on your own seller account, and any drafts they create stay unpublished until you review them in the dashboard.

   

2. 2

   Dashboard > Agent Access > Create an agent key

   Name your key

   In the Key label field, enter a name that tells you which assistant or computer will use this key, for example Cursor agent or Claude on my laptop.

   Use one key per agent or workstation. That way, if one machine is retired or compromised, you can shut off just that key without disturbing the others.

   

3. 3

   Dashboard > Agent Access > Create an agent key

   Set the call and spend limits

   Requests per minute caps how many API calls the key can make each minute. It starts at 60, and you can raise or lower it. Daily spend limit, optional lets you set a dollar cap per day for the key; leave it blank for no spend limit.

   The per-minute limit is your safety net if an assistant gets stuck in a loop, so keep it as low as your workflow allows.

   

4. 4

   Dashboard > Agent Access > Create an agent key

   Choose what the key is allowed to do

   Under Scopes, check the permissions the key should have. Read catalog lets it search Printonic catalog products and file requirements. Read stores lets it list your connected stores. Read products lets it list your existing products. Create listing drafts lets it create unpublished drafts that still require dashboard review. All four are checked by default; uncheck anything you do not need.

   At least one scope must stay checked, or the Create agent key button remains disabled.

   

5. 5

   Dashboard > Agent Access > Create an agent key

   Create the key and copy it immediately

   Click Create agent key. A highlighted box appears with your new key and the message Copy this key now. It will not be shown again. Click Copy, save the key somewhere safe (or paste it straight into your assistant's configuration), then click Dismiss.

   This is the only time the full key is visible. Printonic never stores or shows the raw secret again, so if you lose it you will need to rotate the key to get a new one.

   

6. 6

   printonic.com/mcp

   Point your AI assistant at Printonic

   Open the Connect Printonic to your AI page at printonic.com/mcp. It shows the MCP server URL (printonic.com/api/mcp) and copy-paste setup for common clients. For Cursor, Claude Code, and other clients with a config file, add Printonic to your mcp.json with your key as the Authorization Bearer header. For Claude Desktop, ChatGPT, and other clients that add remote servers through their settings, use the same URL and header there. For clients that only support local servers, the page includes an mcp-remote bridge command.

   Your key starts with psa_live_. Wherever the examples show psa_live_your_key_here, replace it with the real key you copied.

   

7. 7

   Dashboard > Agent Access > Active and revoked keys

   Watch what the key is doing

   Each key card shows its label, an Active or Revoked status, the key prefix (the short beginning of the key, so you can tell keys apart), its scopes, and its Created, Last used, and Rate limit details. Click View usage to open a Recent usage list of the key's latest API calls, with the path, date, and status code for each. Click Refresh to reload the list.

   A brand new key shows Last used: Never and No usage recorded yet until your assistant makes its first call.

   

8. 8

   Dashboard > Agent Access > Active and revoked keys

   Rotate or revoke a key when needed

   Click Rotate to swap a key for a fresh one in a single step: the old key stops working immediately, and a replacement with the same scopes and limits appears once in the copy box, labeled with (rotated) added to the name. Update your assistant's configuration with the new key right away. Click Revoke to shut a key off with no replacement; its status flips to Revoked and it stays in the list for your records.

   Both actions take effect immediately, so an assistant still using the old key will start getting errors until you give it a new one.