InsationAI logo (white)
Buy Now
Documentation

How to get the most out of InsationAI.

Start here. We’re keeping the docs minimal and to-the-point — exactly what you need.

Getting started

Install, activate, and connect your first MCP client in under 10 minutes.

Authentication

OAuth 2.1 setup, token management, and how to connect Claude/ChatGPT.

Configuration

Settings, capability mapping, allowed clients, scope restrictions.

MCP tools reference

Every tool, every parameter, every example.

Hooks & filters

Extend, modify, and customize InsationMCP from your own plugin or theme.

Troubleshooting

Common issues and how to fix them.

Getting started

Once you receive your download from the shop:

  1. Download the plugin ZIP from your My Account → Downloads page.
  2. In WordPress admin, go to Plugins → Add New → Upload Plugin.
  3. Choose the ZIP file and click Install Now, then Activate.
  4. Navigate to Settings → InsationMCP to enter your license key.
  5. Click Generate endpoint URL. Copy the URL — that’s what your AI client connects to.

Authentication

InsationMCP uses OAuth 2.1 with dynamic client registration. When your AI client first connects, it registers itself and obtains an access token — no manual key exchange required.

Supported clients include Claude Desktop, Claude API, ChatGPT (via MCP relays), Cursor, and Continue.

For Claude Desktop:

  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Paste your endpoint URL.
  4. Approve the OAuth handshake when prompted.

Configuration

From the Settings → InsationMCP screen, you can:

  • Enable or disable individual tool categories (content, woocommerce, users, etc.)
  • Restrict which user roles can authenticate
  • Set per-client scope restrictions
  • View audit logs of all MCP requests
  • Rotate signing keys

MCP tools reference

InsationMCP exposes 47+ tools across categories: content, media, users, woocommerce, taxonomies, search, and admin. The full reference is shipped with the plugin in the /docs folder and published in your WordPress admin under InsationMCP → API reference.

Hooks & filters

Some of the most useful filters:

  • insationmcp_enabled_tools — array of tool names to expose
  • insationmcp_capability_required — capability required to invoke a tool
  • insationmcp_tool_response — modify the response before it goes back
  • insationmcp_register_tool — register your own custom MCP tool

Troubleshooting

If your AI client can’t connect:

  • Verify HTTPS is set up. MCP requires TLS 1.2 or higher.
  • Check the audit log for the rejection reason.
  • Confirm the user role you’re authenticating as has the required capabilities.

Still stuck? Email support@insation.ai with your audit log entries — we\’ll get you sorted.

Contact support