Skip to content

Frequently asked questions

Updated View as Markdown

Getting started and providers

What do I need to use MazeGraph?

Use WordPress 7.0 or later and PHP 8.1 or later. To generate replies, install a compatible provider connector for WordPress’s AI Client and configure a provider in Settings → Connectors. MazeGraph does not include an AI model or API key. Follow Install MazeGraph, then Connect an AI Provider.

Does MazeGraph include an AI provider, or is API use free?

MazeGraph and the WordPress.org provider connector plugins are free to install. Provider API access is separate. A provider may offer a free quota, apply limits, or charge for usage, so check its current API terms and billing before sending requests.

Can I connect more than one provider?

Yes. You can install any or all of the official Google, OpenAI, and Anthropic connectors in WordPress. Configure each provider in Settings → Connectors, then select an available model for a session or set a default in MazeGraph → Settings. You do not need to install all three to use MazeGraph.

Where are my provider credentials stored?

WordPress Connectors manages the credentials. MazeGraph does not read, store, log, or display provider keys. Add or change a key only in the connector’s WordPress settings; do not paste it into a chat or support request. See provider setup and credential handling for details about where WordPress keeps the key.

Workspace, tools, and writing

Who can use MazeGraph and its tools?

Administrators have workspace access by default, and a site manager can allow other WordPress roles to use the workspace. Each chat tool still checks the permissions of the person who sent the message. Access to chat does not automatically give someone permission to read users, change settings, or edit every post. See Who may use tools and Availability and role access.

Can MazeGraph change my site or publish a post?

Read tools check the current person’s WordPress permissions. Write tools are off until an administrator enables them. Ask waits for approval for every assistant write; Auto may skip the prompt only for the two marked draft operations; Full may skip it for supported undoable writes when policy allows. Some enabled WooCommerce tools can change the live store or trigger an order email. MazeGraph does not publish posts. In Content Studio, you choose Send to editor to create a WordPress draft yourself; you review and publish it in WordPress when it is ready. See Approval modes and Optimize and hand off a draft.

What does Content Studio do?

Content Studio guides a writing task through a brief, optional research and planning, writing, optional checks, and hand-off. You can review an outline and proposed rewrites before using them. Its Optimize checks run locally and are suggestions, not a publishing score or gate. The final hand-off creates a draft, not a published post. See Content Studio stages.

Why was a tool missing or refused?

What happened: A tool was absent, unavailable, or refused a request. Reason: The site may have tool use turned off, the tool or its extension may be disabled, the selected assistant may not include it, WordPress may deny the current person’s capability, or a policy check may stop the action. Solution: Check the exact tool and message, then review the assistant, site settings, the user’s WordPress role, and any active policy or limit. Learning: Workspace access, assistant access, and WordPress capabilities are separate checks. See A tool is missing or refused for the administrator checklist.

Why will Content Studio not update a draft it already sent?

After the first hand-off, WordPress owns the post. Studio can update it only while it is still a draft or pending, you can edit it, nobody else has it open, and its text has not changed since MazeGraph last wrote it. If WordPress has newer edits, continue in the editor or choose New draft from this to create a separate draft without overwriting them. See Content Studio hand-off troubleshooting.

Can another AI app connect to MazeGraph?

Yes. MazeGraph includes a read-only MCP server for developer apps such as Claude Code, Cursor, Codex and VS Code. It is off by default; an administrator turns it on and creates a connection for each app. Connected apps can call MazeGraph’s read-only tools only, every call follows MazeGraph’s policy and is recorded in Activity, and nothing can change the site over MCP. Hosted apps such as claude.ai and ChatGPT need OAuth sign-in, which is not available yet. See MCP server and Connect an AI app.

Privacy and data

What information does the AI provider receive?

WordPress’s AI Client sends the message and context needed for a reply through your selected connector. Depending on the request, that context can include earlier conversation messages, instructions, tool descriptions, and tool results containing site information. MazeGraph asks each person to accept the provider data notice before their first message. Read What a provider request may contain for examples and controls.

Where are sessions, notes, and activity stored?

Sessions and Content Studio documents are stored in your WordPress site’s database. Notes use WordPress options. MazeGraph’s interface shows each person’s own sessions; operational Activity records do not contain chat text, tool arguments or results, or provider keys. Provider-side copies are governed by the provider’s terms and retention rules, not MazeGraph’s site settings.

How long does MazeGraph keep data?

By default, sessions remain until someone deletes them. Administrators can set Keep sessions for in MazeGraph → Settings → Limits and privacy. Activity logs default to seven days and can be retained for 7 to 365 days; Usage summaries are kept for up to 400 days. See Limits and privacy settings.

How do I export or delete MazeGraph data?

You can export or erase your own MazeGraph records in Settings, or use WordPress’s Tools → Export Personal Data and Tools → Erase Personal Data to handle a person’s privacy request. These actions do not delete provider-side copies or connector credentials. Delete all data when the plugin is deleted is a separate site-wide option and is off by default. See Export and erase personal data.

Does MazeGraph send chat data or usage analytics to MazeWP?

No. MazeGraph sends no chat data or usage analytics to MazeWP. Model requests go through WordPress’s AI Client and your configured provider connector; the connector and provider handle those requests under their own terms. See Data and privacy.

Still need help?

Start with the Troubleshooting guide, or visit MazeGraph support. When you report a problem, include the MazeGraph version, the affected feature, and the exact error message. Do not include API keys, generated MCP passwords, private content, or personal data.

Was this page helpful?

Your feedback helps us improve these docs.

Documentation

Type to search…

↑↓ navigate↵ selectEsc close