AI Assistant Documentation

Ask Claude or ChatGPT for Amazon product boxes and comparison tables, then paste what it gives you into your post. It works on your own Amazon keys or the Managed API.

Connect in Three Steps

You need the latest PaapiPlugin with Premium, and a site on https. Your own Amazon keys and the Managed API both work. A WordPress administrator approves the connection.

Open PaapiPlugin → Settings → Amazon connection. Once PaapiPlugin is connected to Amazon, the Connect your AI app box shows up on that page.

Claude

  1. Connect. Click Connect Claude.
  2. Add. Claude opens in a new tab with PaapiPlugin already filled in. Click Add.
  3. Approve. Your site asks you to approve the connection. Click Approve, and you go back to Claude, connected.

ChatGPT

  1. Connect. Click Connect ChatGPT. PaapiPlugin copies the connector address and opens ChatGPT in a new tab.
  2. Add. In ChatGPT, go to chatgpt.com/plugins, click Add, then Add custom MCP server. Name it PaapiPlugin, paste the address under Connection and leave Authentication on OAuth. Tick I understand and want to continue, click Create as a plugin, then Continue to PaapiPlugin. When PaapiPlugin asks for your site, enter its address.
  3. Approve. Your site asks you to approve the connection. Click Approve, and you go back to ChatGPT, connected.
ChatGPT's Add menu open, with Add custom MCP server as the last option.

If the copy didn't work, this is the address to paste:

https://mcp.paapiplugin.com/mcp

Approve on your site

Both apps end on this page in your WordPress admin. Click Approve only if you just started the connection yourself.

The approval page in WordPress asking Connect Claude to your site, showing Publisher: claude.ai and After you approve, you go back to claude.ai, with Approve and Cancel buttons.

When you click Approve, PaapiPlugin's server sends your site one test request. If your site answers, you're connected. If it doesn't, the page tells you why and links to Troubleshooting.

The connection belongs to the site address you approved it on. You can connect Claude and ChatGPT both: approving a second app keeps the first one working.

Starting in Claude or ChatGPT instead

You can also add PaapiPlugin from inside the app with the address above. In Claude, go to Customize → Connectors, click + Add, then Add custom connector, name it PaapiPlugin, paste the address and click Continue. In ChatGPT, use the steps above. A PaapiPlugin sign-in page then asks for your site's address. Enter it, click Continue to your site, log in to WordPress if it asks, and click Approve.

Claude's Add custom connector dialog with PaapiPlugin typed as the name and the connector URL pasted in, ready for Continue.

What You Can Ask

Ask in plain words. A few to start with:

  • "Find a stainless steel water bottle on Amazon and give me its product box shortcode in the horizontal style."
  • "Find three cordless stick vacuums and make a comparison table called Stick vacuums."
  • "Write a post about camping coffee makers with a product box for each one, and save it as a draft."
  • "Make an auto-updating list of the best sellers in Electronics."
  • "Which comparison tables have I already saved?"
  • "Give me a search box for hiking boots that my readers can use."

In Claude, click Allow once or Always allow when Claude asks to use PaapiPlugin. In ChatGPT, type @PaapiPlugin first, pick it from the list, then ask.

A Claude chat asking for an insulated stainless steel water bottle. Claude used PaapiPlugin and replied with the first result's name, its ASIN and a product box shortcode.

What your AI app can do

  • Find Amazon products, with the name, brand, image and ASIN of each.
  • Make a product box in the card, horizontal or minimal style. If you have no box for that product yet, it saves one under Product Boxes.
  • Make a comparison table of 2 to 10 products and save it under Comparison Tables.
  • Give you the shortcode for an auto-updating list of best sellers or new releases, a deals grid, or a live search box. These save nothing.
  • List the product boxes and comparison tables you already saved, with their shortcodes.
  • Save a post as a draft, with the shortcodes already in it.
  • Check your connection: your own keys or the Managed API, your Amazon store, whether your Associate tag is set and, on the Managed API, how many searches you have left.

Paste a shortcode into any post or page to show it. Your AI app works as the administrator who approved it.

Each WordPress user can make 30 Amazon lookups and saves an hour from AI apps. Finding products uses one, and so does a box you already have. A new box uses two, because it is also saved. A table uses one per product plus one for the save, and a draft uses one. A lookup counts even when PaapiPlugin answers it from its cache. On the Managed API, lookups also count toward your Managed API searches, the same as lookups from your site.

What It Never Does

  • It never publishes. Every post it saves is a draft, and you decide what goes live.
  • It never edits or deletes anything. It only adds new boxes, tables and drafts, and a box you already have stays as it is.
  • It never changes your settings.
  • PaapiPlugin never gives it a price. It gets each product's name, brand, image and ASIN, and nothing about price, savings, stock or the product link. Your boxes and tables still show prices the way they always do.
  • It never sees your Associate tag, your Amazon keys or your Managed API key. When something goes wrong, it gets a short fixed message with no keys and no error text from Amazon.

Troubleshooting

When you click Approve, PaapiPlugin's server sends a request to your site's /wp-admin/admin-ajax.php over https. It comes from a server, not a browser, and it isn't logged in. If your site doesn't answer it, the Approve page shows one of the messages below. Fix the cause, then start again from Connect Claude, Connect ChatGPT or your AI app.

"Your site turned away PaapiPlugin's server."

Your site, or something in front of it, refused the request.

  • In your security plugin or firewall, allow requests to /wp-admin/admin-ajax.php from visitors who aren't logged in.
  • If your host or CDN shows visitors a bot check or a CAPTCHA, turn it off for /wp-admin/admin-ajax.php. Our server can't pass one.
  • If your host put an extra password on the wp-admin folder, leave admin-ajax.php outside it.
  • Check your server's clock. Every request carries the time it was sent, and your site turns away one that is minutes off.

"Your site did not answer at admin-ajax.php."

The request reached your domain but found no WordPress there.

  • Open https://your-site.com/wp-admin/admin-ajax.php in your browser, with your own domain. WordPress shows a 0. If you get a "not found" page, a security plugin that hides or renames wp-admin, or a server rule, is in the way.
  • In Settings → General, check that the WordPress Address is your site's https address.

"Your site took too long to answer."

  • Try again. A slow moment on your server is enough to cause this.
  • While you wait on the Approve page, your site has to answer our server at the same time. Some hosting plans handle only one request at a time. If this keeps happening, ask your host to allow more than one PHP worker.
  • A firewall that drops requests without answering looks the same from our side. Check its log for blocked requests to admin-ajax.php.

"Your site's https certificate could not be checked."

  • Check your certificate with any online SSL checker. It must be valid, not expired, issued for your domain and sent with its full chain. A self-signed certificate won't pass.
  • If your site sits behind a CDN, the certificate on your own server has to be valid too, not only the one your visitors see.
  • Renew or reinstall the certificate in your hosting panel, then try again.

"Your site did not answer as expected."

  • Wait a minute and try again.
  • Make sure nothing redirects admin-ajax.php: a maintenance or coming soon mode, a redirect to another address, or a login page in front of wp-admin.
  • Update PaapiPlugin and check that Premium is active on this site.

Other messages

  • Your AI app was given a different address for this site: start again in your AI app and enter the address the message shows.
  • PaapiPlugin could not finish disconnecting your earlier AI apps: an earlier Disconnect is still waiting to reach PaapiPlugin's server, and Approve finishes it first. Wait a minute and try again.
  • The approval could not be completed right now: wait a minute and start again.
  • Started in a different browser: start again from your AI app and finish in that same browser.
  • Too many sign-ins from this network: wait a few minutes, then try again.
  • Only sites that use https: enter your site's https address.
  • AI assistant access is not available for this site: the site needs PaapiPlugin Premium.
  • Claude says the connector already exists: PaapiPlugin is already in your Claude connectors. Open it there and click Connect.

Still stuck? Contact support and paste the message you saw.

Disconnect

In PaapiPlugin → Settings → Amazon connection, click Disconnect all AI assistants, then Disconnect them. Your site stops answering AI apps right away, and every connected app loses access until you connect it again. This covers both your own Amazon keys and the Managed API, whichever one an app was approved on.

If PaapiPlugin can't reach its server at that moment, your site still stops answering, and PaapiPlugin tries again by itself the next time an administrator opens WordPress admin. If you approve a new app before that, Approve finishes the waiting disconnect first. On the Managed API, removing the Managed API key from your site disconnects your apps too.

Removing PaapiPlugin in your AI app stops that one app.

Uninstalling PaapiPlugin deletes the connection data it keeps on your site, but it doesn't sign your AI apps out on PaapiPlugin's side. Click Disconnect all AI assistants first.

FAQ

Which AI apps can I use?

Claude and ChatGPT. A connector you add to Claude on the web also shows up in Claude's mobile apps.

Do I need the Managed API?

No. It works the same on your own Amazon keys. On your own keys, lookups go through your keys, as they do for your site.

Does it work on free plans?

PaapiPlugin needs Premium. Claude works on every plan, and its Free plan allows one custom connector. On Claude Team and Enterprise, an owner adds the connector under Organization settings → Connectors. We tested ChatGPT on a free account.

My AI app says it needs the latest PaapiPlugin

Update PaapiPlugin, open your WordPress admin once, then try again. If the message comes back, connect again from the Connect your AI app box. Apps connected on the Managed API before the update keep finding products and making product boxes. On some sites they need one new connection from that box before they can do the rest.

I have a staging copy of my site

Connect the copy on its own: open the Connect your AI app box on the staging site and approve there. Each connection belongs to the address it was approved on, so the copy never receives requests meant for your live site.

My AI app says the connection has ended

Connect again. This happens after someone clicks Disconnect all AI assistants, or when the administrator who approved the connection no longer has an account on the site.

I set this up with the MCP Adapter plugin

PaapiPlugin no longer works through the MCP Adapter plugin. Connect with the three steps above instead. If you installed the MCP Adapter only for PaapiPlugin, you can remove it and delete the application password you made for it.

Will the AI put prices in my post?

Not from PaapiPlugin. The AI writes its own text, though, so read the draft before you publish.

How do I turn it off?

See Disconnect.

Need more help? Contact support and tell us which AI app you use.