Author Archive

MCP Connections for ChatGPT and Claude

PurioChat MCP lets you manage WordPress from ChatGPT or Claude. The assistant can use only the tools you enable, and every action still follows the connected user’s WordPress permissions.

 

Before you connect

– PurioChat Pro must be active.
– Your site needs a public HTTPS address and pretty permalinks.
– The AI service must support custom remote MCP connections.
– A WordPress administrator must approve the connection.

Local, VPN-only, and firewalled sites cannot be reached by cloud-based AI services. Connector availability can also depend on the service plan or workspace.

Connect your assistant

1. Go to PurioChat → Chat Settings → MCP.
2. Enable Allow AI connections.
3. Choose an access profile and save.
4. Confirm the status says Ready to cnnect.
5. Copy the address shown for your assistant.

ChatGPT

1. Go to Settings → Security and Login and enable Developer Mode.
2. Go to Plugins → Add Plugin and paste the ChatGPT address.

Claude

1. Go to Settings → Connectors.
2. Click Add → Add Custom Connector and paste the Claude address.


  

ChatGPT and Claude use different MCP addresses. Copy the URL from the matching provider card. Then sign in to WordPress and approve access.

Choose an access profile

– Read only: View public WordPress content.
– Content editor: Create and edit drafts, media, and comments. Cannot publish.
– Store manager: Manage products, sanitized orders, coupons, and approved store settings.
– Full access (YOLO mode): Enable every permission, including sensitive and destructive actions. Draft protection is disabled.
– Custom permissions: Select permissions individually.

Start with the smallest profile that can complete the task.

Permissions and security

– WordPress: Content, media, comments, publishing, users, settings, plugins, and themes.
– WooCommerce: Products, orders, coupons, customer data, and approved store settings.
– PurioChat: Conversations, statistics, contact messages, and trained site knowledge.

Access all custom fields includes ACF and theme fields. Keys beginning with an underscore stay blocked.

API keys, passwords, licenses, payment credentials, SQL, PHP, and filesystem access are never exposed. Calls are rate-limited per connected app and WordPress user. MCP does not answer live visitor chats.

Keep customer data, permanent deletion, custom fields, and system management disabled unless required.

Changing permissions in MCPsettings might require deleting app/connection from ChatGPT/Claude and adding it again.

Recent activity

Open Recent activity to view connection controls and the audit log.

– Activity loads only when the panel is opened, 20 events at a time.
– Metadata is kept for up to 90 days.
– Message bodies, argument values, and tool results are never logged.
– Revoke all connections disconnects every authorized AI app.

If the connection fails

1. Click Re-run beside the connection status and follow the displayed fix.
2. Check HTTPS and pretty permalinks.
3. Allow /.well-known/* and /wp-json/puriochat-mcp/* through your server, security plugin, and CDN.
4. If you use Cloudflare, make sure Claude-User is not blocked under Manage AI bot access.
5. Save the MCP settings and reconnect the assistant.

Example requests

– “Create a draft About page using this outline.”
– “Update this product’s price and stock.”
– “Show comments waiting for review.”
– “Summarize recent PurioChat conversations.”

The assistant can use only tools allowed by both PurioChat and the connected WordPress account.

 

Proactive Actions

PurioChat can reach out before a visitor clicks the chat button. Proactive Actions let you show a message, open a mini chat, or start the full chat at the right moment.

You can trigger an action after a set time or when someone scrolls through part of a page. Each action can run everywhere, on a selected content type, or only on specific content.

How to add a proactive action

1. Go to PurioChat → Chat Settings → Proactive Actions.
2. Enable Proactive Actions.
3. Click Add Action.
4. Choose a trigger, action, location, and message.
5. Save your settings.

The Free plugin includes one proactive action. PurioChat Pro lets you add unlimited actions.

Choose when it appears

– Time: Show the action after the visitor stays on the page for a chosen number of seconds.
– Scroll Depth: Show the action after the visitor reaches a chosen percentage of the page.

Choose what happens

– Show mini chat: Display a small chat box with your message, an input field, and a send button.
– Show message bubble: Display a short message above the floating chat button.
– Start chat with message: Open the full chat with your message already shown.

You can also add emojis to make the message feel more natural and noticeable.

Choose where it appears

– Entire site: Run the action on every page.
– Content type: Run it on posts, pages, products, listings, or another selected post type.
– Specific content: Run it only on selected posts, pages, products, or listings.

Add buttons to a mini chat

Mini chats can show up to three optional buttons below the message.

Each button has:

– A label visitors can see.
– A message sent to the AI when clicked.
– An optional custom color.

This is useful for common questions such as “Check availability”, “Find a product”, or “Tell me more”.

After the visitor sends a message

Choose when matching proactive actions can appear again:

– Show actions again on the next page
– Hide actions for the rest of this visit
– Hide actions for 30 minutes
– Hide actions for 1 hour
– Hide actions for 24 hours
– Hide actions for 7 days

Opening or closing the chat without sending a message does not hide actions. “This visit” lasts until the browser tab is closed; closing Mini Chat affects only that action.

When multiple actions match

If multiple configured actions can trigger on the same page, show them all or show only one. Priority appears when you choose to show one.

– Show all matching actions: Allow every matching action to trigger.
– Show highest priority only: Allow only the matching action with the highest priority to trigger.
– Priority 1 is the highest.

Good to know

– When all matching actions are shown, message bubbles stack neatly above the chat button.
– Only the lowest message bubble in the stack displays an arrow.
– Closing Mini Chat brings back the regular floating chat button.
– Mini Chat works in light and dark mode.
– The send button uses your Floating Widget Button Color.
– No extra AI setup is required.

 

Live Chat Alerts

Live Chat availability controls when visitors and the AI can request a human. Alert settings decide how your team is notified when a handoff begins.

Choose when handoff requests are available

The When handoff requests are available setting controls both the visitor handoff button and the AI handoff tool.

Mode What happens
Always allow handoff requests Visitors can request a person at any time. Email is sent immediately when nobody is online, or after 15 seconds when an online operator has not claimed the chat.
Only while an operator is online The visitor button and AI handoff tool are available only while an authorized operator has the Live Chat inbox open. If nobody joins within 15 seconds, PurioChat sends the email fallback.
Always during business hours Handoff is available during the weekly schedule you configure, even if nobody currently has the inbox open. Outside those hours, the visitor button and AI handoff tool are unavailable.

If a human request remains unclaimed for one minute, PurioChat returns the conversation to the AI so the visitor is not left waiting.

What “online” means: an authorized operator currently has the WordPress Live Chat inbox open. Being signed in to WordPress is not enough.

Handsoff options dropdown

When you select Always during business hours, use Configure business hours to enable individual days and set opening and closing times. The schedule uses the timezone configured in WordPress.

Business Hours Config

Configure Live Chat alerts

PurioChat supports three alert channels. You can use one or combine all three.

  1. Email alerts — sent once per request. Email is sent immediately when nobody is online, or after 15 seconds when an online operator has not claimed the chat. Separate multiple addresses with commas and use Send test email to verify delivery.
  2. Browser alerts — shows a desktop notification while the Live Chat inbox is open. Permission is enabled separately in each browser. You can also enable a sound and use the test button to check it.
  3. Telegram alerts — sends new handoff requests to a private operator bot immediately. Use a different bot from the customer-facing Telegram AI integration.

    The connected administrator can: accept or reject incoming live chat, reply to customer and end the human chat directly from Telegram. 

    Telegram alerts + live chat

Important: notification settings do not make handoff available by themselves. The selected availability mode still decides whether the visitor button and AI handoff tool can be used.

Telegram Live Chat bot commands:

  • /start — confirms connection status or completes pairing from WordPress.
  • /status — checks whether a Live Chat conversation is active.
  • /end — ends the active human chat and returns it to AI.

While a chat is active, any normal text message is sent directly to the visitor.

There are also inline buttons:

  • Take chat
  • Return to AI

For most sites, use Always during business hours, keep browser alerts enabled while your team works, connect Telegram for immediate mobile alerts, and configure email as the fallback.

Human Live Chat

When AI isn’t enough, PurioChat seamlessly hands the conversation over to a real person – without leaving the chat.

Embeddable chat widget on external sites

PurioChat isn’t limited to the site it’s installed on. With the Embed feature you can drop your chatbot onto any page – another WordPress site, a plain HTML landing page, a different CMS, anywhere – by pasting a single line of code. The chat, its knowledge, and your settings all stay on your PurioChat site; the other page just shows the bubble.

Embeddable Widget

How to use it?

1. Go to AI Chat → Settings → Integrations.
2. Enable “Embed on any website” and click Save.
3. A copy-paste snippet appears. It looks like this:

<script src="https://your-site.com/wp-content/plugins/ai-chat-search-pro/assets/js/embed-loader.js"
data-puriochat="https://your-site.com/" async></script>

Copy that snippet and paste it into any page where you want the chat to appear — right before the closing </body> tag, in your theme’s footer, or
via a “custom HTML / header & footer” tool (e.g. WPCode). That’s it. The chat bubble shows up in the corner, and clicking it opens your assistant —
exactly as it looks on your own site.

The page you paste it on does not need PurioChat, WordPress, or any plugins. Everything loads from your PurioChat site.

Restrict where it can run (optional)

If you only want the chat to load on certain sites, add them under Allowed domains:

example.com
shop.example.com

– One domain per line. Entering example.com automatically covers all its subdomains and pages — no need to list each one.
– Leave it empty to allow the chat anywhere.
– On a domain that isn’t on the list, the chat simply won’t appear — your page is never affected.

Good to know

– It won’t get in the way. The chat is a transparent overlay — your page stays fully clickable. When the chat is open, only the chat panel captures
clicks; everything outside it keeps working.
– It’s fast. The loader is a static, cached file, so it adds virtually nothing to your page-load time.
– Conversations are tracked normally. Chats started from an embedded page show up in your history, tagged with the page they came from.
– Responsive. It adapts to mobile just like the on-site widget.

 

Changelog

Pre-Chat Form

The Pre-Chat Form asks visitors for required details before they can send the first message. Use it when you want names, contact details, company names, booking references, or any other short context before the assistant starts answering.

Where to find it

Open PurioChat → Settings → Access & Privacy and enable Pre-Chat Form.

The form is used by both the floating widget and embedded chats created with the shortcode. If the chat is disabled globally, hidden by page rules, blocked by Require Login, or blocked for an IP address, the pre-chat form will not appear because the chat itself is unavailable.

Pre chat form

Configure the fields

After enabling the form, add the labels visitors must fill in. Each row becomes a required text field in the frontend form. Common labels are Full name, Email, Phone number, Company, or Order number.

  • All configured fields are required.
  • Answers must be between 2 and 200 characters.
  • PurioChat stores up to 10 submitted fields with the first chat message.
  • Empty field labels are ignored, so remove unused rows or leave them blank.

Use Form Headline when you want a short sentence above the fields, for example Please introduce yourself before we start. Leave it blank for no headline.

Pre-Chat Form configuration with a headline field and a list of required form fields

What visitors see

When the chat opens, visitors see the pre-chat form first. They must complete every visible field and click Start Chat. Only then does the normal chat input become available.

The form does not change the AI model, tools, or trained content. It only collects visitor context before the first message.

Where submitted details go

Submitted values are sent with the first message and saved with that conversation when Chat History tracking is enabled. In PurioChat → Dashboard → Chat History, the data appears in a User Details panel above the transcript.

User Details panel shown at the top of a saved conversation in Chat History