WowInvoice AI Tools connects your WooCommerce document workflow to AI assistants such as ChatGPT, Claude and Gemini using the Model Context Protocol (MCP).
Using natural-language prompts, you can inspect document settings, check order document status, generate PDFs, preview documents and manage supported configurations.
Requirements
- WordPress 6.9 or later with the Abilities API available.
- WooCommerce installed and activated.
- A WowInvoice version that supports AI Tools.
- The standalone WordPress MCP Adapter plugin installed and activated.
- A WordPress administrator account.
- An AI application that supports custom MCP connections.
All WowInvoice MCP tools require administrator permissions. Some operations may also require additional OAuth consent or a valid Pro license.
Choose Your Connection Method
| AI Application | Connection Method | Authentication |
|---|---|---|
| ChatGPT, Claude, Gemini | Remote MCP | OAuth |
| Claude Desktop, Cursor, Windsurf | Local bridge | Application password |
| VS Code | VS Code local bridge configuration | Application password |
| Claude Code, Gemini CLI | Direct HTTP | Application password |
Remote MCP connections require a publicly accessible HTTPS website and cannot access localhost.
For locally hosted websites, use a compatible desktop or CLI application that can reach your site and supports application-password authentication.
Using another MCP client
You can connect through other AI apps that support custom MCP servers and tool calls. Check that your app supports the connection and authentication method you plan to use. After connecting, run the read-only test prompt to confirm that the app can call the plugin’s tools before enabling write access.
For setup instructions and requirements, see the official guides for Codex, Google Antigravity, Grok Build, and Perplexity custom connectors.
Step 1: Configure MCP Access
Navigate to WooCommerce → WowInvoice → AI Tools → Access Mode.
Select an access mode, click Save access mode and check Current Access.
| Access Mode | Supported Operations |
|---|---|
| Off | Disables MCP and revokes existing WowInvoice OAuth connections. |
| Read only | Inspect document types order document status, templates, settings, readiness and eligible or issued documents. |
| Manage | Includes Read only operations and confirmed PDF generation for eligible orders. |
| Full access | Adds private document previews, snapshot resets, reviewed configuration changes, issued-original viewing and print records. |
Start with Read only. Enable Manage when PDF generation is necessary and Full access only when you need an operation that requires it.
Additional OAuth consent and licensing requirements may still apply.
Step 2: Check System Readiness
Under System Readiness, check that the following components are ready:
- WordPress 6.9+ and Abilities API.
- WooCommerce.
- WordPress MCP Adapter.
- Pretty permalinks.
To enable pretty permalinks, navigate to Settings → Permalinks and select a structure other than Plain.
Resolve any reported issues before connecting.
Step 3: Copy Your MCP Server Address
Copy the MCP server address from the AI Tools page.
A typical WowInvoice MCP endpoint looks like this:
https://example.com/wp-json/winv/mcpAlways use the address displayed on your website. The WowInvoice endpoint uses winv, not wowinvoice.
Step 4: Connect Your AI Assistant
Under Connect an AI assistant, select your preferred application and follow the corresponding guide:
- How to Connect WowInvoice to ChatGPT
- How to Connect WowInvoice to Claude
- How to Connect WowInvoice to Gemini
- How to Connect WowInvoice to Desktop Apps and CLI Tools
You must save an enabled access mode before connecting.
Web assistants use WordPress sign-in and OAuth authorization. Compatible desktop and CLI applications can use WordPress application passwords.
Step 5: Verify Your Connection
Copy the prompt under Confirm your AI can read this store and send it to your AI assistant.
Alternatively, replace the example address in this prompt with your own website:
Use WowInvoice to read my store at https://example.com (the get-document-overview tool). Tell me which document types are available and which are published. If it fails, show me the error and what to do next. Do not change anything.
Confirm that your assistant calls a WowInvoice tool and returns actual store information.
A general explanation of WowInvoice does not verify the connection. A successful read also does not verify document-generation or Full access permissions.
Choosing a model
For complex requests that involve several steps, we recommend using a reasoning model or selecting a higher reasoning setting if your AI app offers one. A standard model is usually enough for simple lookups. Review any proposed changes before approving them.
Learn more about reasoning models.
Review Document Operations Before Approving
Before allowing your AI assistant to perform sensitive operations:
- Verify the intended order ID and document type.
- Review the requested operation and its expected outcome.
- Check publication status and order eligibility before generating a PDF.
- Review the exact configuration or revision before approving changes.
PDF generation requires confirmation and can issue a document number.
Resetting a document snapshot makes the next PDF use current settings while retaining its issued number.
Disconnect or Disable MCP Access
Disconnect an Individual App
Under Connected apps, disconnect the application you no longer want to use.
The application must be authorized again before reconnecting.
Disable All MCP Access
Select Off under Access Mode and click Save access mode.
This disables WowInvoice MCP access and revokes existing WowInvoice OAuth connections.
Revoke Application Passwords
To remove application-password access, navigate to Users → Profile → Application Passwords, revoke the relevant password and remove the saved credentials from your application.
Review MCP Tool Activity
The Recent MCP Tool Activity section retains up to 100 records from the last 30 days.
Click Refresh to reload the activity list.
Security and Data Privacy
Order documents may contain customer and other sensitive information. Connect only trusted AI services, review their privacy policies and request only the information necessary for your task.
Keep application passwords, tokens, encoded credentials, private document links, previews and unnecessary customer information out of AI conversations, screenshots and public support requests.
What’s Next?
Explore What Can You Do with WowInvoice MCP? for supported capabilities, tools and example prompts.
For connection issues, see Troubleshooting WowInvoice MCP Connections.