Skip to main content

Set up WordPress

Connect WordPress.com tools and index published WordPress content in one setup flow. Use this guide when your setup page shows Connect, Set up indexing, and Review setup.

Understand feature availability​

WordPress.com tools use a hosted Model Context Protocol (MCP) server. Tools and indexed search use separate credentials and permission models.

CapabilityWhen it becomes availablePermissions
WordPress.com toolsAfter you configure tool access and each user authorizes their WordPress.com accountThe user's WordPress permissions and the tool-access settings in WordPress.com and Glean
Indexed searchAs Glean crawls and indexes published contentGlean connector access controls apply. Glean doesn't apply per-user WordPress permissions to indexed content.

The tools connection does not supply indexing credentials. Complete Set up indexing before you continue to Review setup.

Prerequisites​

Before you begin:

  • Have permission to add and configure connectors in the Glean Admin console.
  • Confirm that your WordPress.com account and intended sites meet the requirements for MCP access. See Enable MCP tool access for AI agents for current eligibility and site-access settings.
  • Use a self-hosted WordPress site or a WordPress.com Business plan or higher for indexing.
  • Enable the WordPress REST API (/wp-json/wp/v2/) on the indexing site. Application Passwords require WordPress 5.6 or later.
  • Have access to a WordPress administrator account to create an Application Password for indexing.
  • Allow Glean to reach the indexing site over HTTPS. If your site restricts network access, allowlist Glean's crawler egress IP addresses. Contact Glean Support for those addresses.

WordPress.com MCP eligibility and indexing requirements differ. A site that meets the indexing requirements does not necessarily meet the requirements for WordPress.com tools.

Connect WordPress.com tools​

The Connect step authorizes WordPress.com tools. Glean handles OAuth app registration, so you don't create a custom OAuth app or enter a client ID and client secret.

To connect tools:

  1. In the Glean Admin console, go to Connectors, click Add connector, and choose WordPress.
  2. Enter a Name for the connector.
  3. In WordPress.com, go to Preferences → AI and MCP and turn on Enable MCP access.
  4. Review Read and Write. WordPress.com turns on both groups when you enable MCP access. Turn off tools you don't need and confirm that your intended sites allow MCP access.
  5. Return to Glean and click Connect. Sign in to WordPress.com and approve the requested access.
  6. Return to Glean and continue to Set up indexing.

Use WordPress.com MCP settings to control which sites tools can access. The indexing Hostname does not limit the tools connection to that site.

Set up indexing​

Configure the site Glean will crawl. This step requires separate WordPress credentials, not the OAuth connection from Connect.

To configure indexing:

  1. Sign in to your WordPress site as an administrator and open your user profile.
  2. Create an Application Password for Glean. Copy the password and the associated username, and store them securely.
  3. In Glean's Set up indexing step, enter these values:
    • Username: The WordPress username associated with the Application Password.
    • Application password: The Application Password you created for Glean, not your sign-in password.
    • Hostname: The URL of the WordPress site, including the scheme, such as https://your-site.example.com.
  4. Click Save, then continue to Review setup.
Indexed content visibility

Glean indexes published, non-password-protected pages and posts, along with approved comments. Glean does not copy WordPress per-user permissions for this content. Anyone with access to the connector in Glean can see its indexed content.

Review setup​

Review the tools connection and indexing configuration before starting the crawl:

  1. Under User access, choose All users, Test group only, or None.
  2. If you choose Test group only, select the test group that should have access.
  3. Click Begin indexing. Glean starts the initial crawl, and search results appear as Glean indexes content.

If Skip for now appears, you can defer the crawl. It does not let you bypass Set up indexing or remove its configuration requirements.

Manage tools​

After setup, open the WordPress connector's Tools tab to review tool availability and access. Each user authorizes their own WordPress.com account before using tools.

Read tools retrieve information. Write tools change WordPress.com content. Review access before making write tools available to users.

Use the shared tools guides to:

Verify setup​

Check indexed search and tools separately:

  • Monitor crawl progress on the WordPress connector page in the Admin console.
  • Search for a published, non-password-protected page after Glean indexes it. Confirm that the intended Glean users can access the result.
  • Test a read tool with an authorized WordPress.com account. Confirm that it returns content the user can access in WordPress.com.

Troubleshooting​

Use these checks to distinguish tools-connection issues from indexing issues.

IssueWhat to check
The WordPress.com authorization window does not openAllow pop-ups for Glean, then click Connect again.
A tool is unavailable or reports a permission errorCheck the user's WordPress.com authorization, role, MCP tool settings, and site access. Also check tool availability and access in Glean.
Tools work, but content does not appear in searchComplete Set up indexing and Review setup. Check crawl progress, published status, password protection, and Glean User access.
Indexing setup reports that Glean cannot retrieve pagesCheck the Hostname, HTTPS reachability, REST API access, and Application Password credentials.

See also​