Overview
BLOX NXT supports integration with AI systems — including Claude and ChatGPT — through the Model Context Protocol (MCP). This allows AI tools to securely connect to your BLOX NXT instance and interact with your content, analytics, and publishing workflows using natural language.
This article covers what the integration does, how to set it up, and what to expect during the current beta phase.
What Is BLOX NXT MCP?
The BLOX NXT MCP Server (mcp.bloxcms.com) acts as a secure broker between AI systems and your BLOX NXT site. It implements the Model Context Protocol — an emerging open standard for connecting AI tools to external platforms in a structured, permissioned way.
When an AI model like Claude or ChatGPT connects to your BLOX NXT instance through MCP, it can call specific, authorized tools on your behalf — retrieving content, querying analytics, or taking editorial actions — within the boundaries of the scopes and domains you explicitly grant access to. The AI cannot access anything beyond what you authorize.
Authentication is handled via OAuth 2.1. The AI client registers dynamically with the MCP server, and you control which tools and domains it can reach during the authorization step.
What You Can Do With It
The capabilities available through the BLOX NXT MCP integration depend on the tools and scopes you authorize during setup. The following tools are currently available, as of April 2026:
Site and configuration information — The AI can retrieve basic information about your site, including available content types, sections, tags, geotags, block templates, query rule types, presentation modes, and author information. This gives the AI the context it needs to operate accurately within your specific instance.
Editorial content — The AI can search for and retrieve existing articles, create new article drafts, and edit existing articles. This enables workflows like asking the AI to locate relevant stories, generate a new draft, or update the content of an existing article — all within your CMS.
Dashboards — The AI can search for, retrieve, create, and update dashboards within your BLOX NXT Insights application. This supports workflows where the AI builds or modifies a dashboard based on a natural-language request.
Insights modules and data — The AI can search for and retrieve modules, as well as retrieve the underlying data those modules surface. This is the foundation for data-driven queries — asking the AI questions about your site's performance and receiving answers grounded in your actual analytics.
Widgets — The AI can search for, retrieve, create, and update widgets within Data Dashboards. This allows the AI to assemble or modify data visualizations as part of a broader workflow.
Design Blocks — The AI can create content blocks within BLOX NXT, selecting from available block applications, templates, and query rule types. This supports automated assembly of CMS-native content blocks populated with editorial content or dynamic rules.
The specific actions the AI can take are limited to what you authorize during setup. Read-only tools (search, retrieve, list) are separated from write tools (create, edit, update) in the authorization flow, and each category can be granted independently.
Before You Begin
Before setting up the MCP integration, confirm the following:
Your site is running a supported version of BLOX NXT.
Your site is registered as a BLOX domain accessible through the MCP proxy server (
mcp.bloxcms.com). If you are unsure, contact BLOX Customer Support.You have access to your site's BLOX legacy admin to complete OAuth authorization.
You have an active account with the AI platform you intend to connect (Claude or ChatGPT).
Known Limitations
The following limitations apply during the current beta phase:
Binary and media files cannot be passed directly through MCP. Media should be referenced by URL; background processing handles retrieval.
Rate limiting is enforced at 1 request per second per client. The system supports a target of 200–300 concurrent sessions.
Analytics-dependent workflows (performance queries, conversion analysis, opportunity detection) require that your site have sufficient historical analytics data. Sites with limited data history may see degraded results for these use cases.
Tool availability is limited at initial release. Additional tools and scopes will be added as the beta progresses.
Multi-region and data residency requirements are not formally addressed at this time. Compliance-sensitive customers should evaluate this before proceeding.
Self-service setup is intended, but early adopters may encounter edge cases not yet documented. Technical staff familiar with OAuth and API configuration is strongly recommended.
Setting Up with Claude
Step 1 — Add a Custom Connector
In Claude, navigate to Settings > Connectors and select Add Custom Connector.
Enter the BLOX NXT MCP server URL:
Step 2 — Authenticate via BLOX Admin
Claude will redirect you to the BLOX legacy admin OAuth flow. Log in with your BLOX admin credentials.
Step 3 — Select Scopes and Domains
After authenticating, you will be presented with a list of available scopes and the domains registered to your account. Select the tools and domains you want to make available to Claude, then select Authorize.
Only the domains and scopes you authorize here will be accessible to the AI. You can revisit this at any time to modify access.
Step 4 — Begin Using the Integration
Once authorized, Claude will have access to the tools you selected. You can interact with it directly in conversation — ask it to query your content, generate drafts, pull analytics, or create blocks and pages within your CMS.
Setting Up with ChatGPT
Step 1 — Configure an App in ChatGPT
In ChatGPT, navigate to the app configuration area and create a new app. When prompted for a connection, enter the BLOX NXT MCP server URL:
Step 2 — Authenticate via BLOX Admin
ChatGPT will redirect you to the BLOX legacy admin OAuth flow. Log in with your BLOX admin credentials.
Step 3 — Select Scopes and Domains
Select the tools and domains you want to make available to ChatGPT and confirm authorization.
Step 4 — Select the App as an Agent
Once the app is configured and authorized, select it as the active agent in your ChatGPT session.
Step 5 — Begin Using the Integration
With the app active, ChatGPT can call authorized BLOX NXT tools in response to your prompts.
Troubleshooting & FAQ
The AI says it can't find my site or domain. Confirm that your site is registered and accessible through mcp.bloxcms.com. Not all BLOX NXT sites are enrolled in the MCP beta. Contact BLOX Customer Support to verify your domain's status.
I authorized a domain but the AI still can't access it. Double-check the scope and domain selections made during authorization. If the correct domain was not selected during the OAuth flow, you will need to repeat the authorization step and explicitly include it.
The AI returns outdated or incorrect data. MCP tool responses reflect live data from your site at the time of the request. If results seem incorrect, confirm that the underlying data in your CMS is accurate. For analytics-dependent queries, ensure your site has adequate historical data.
OAuth authorization fails or times out. Ensure you are logging in with BLOX admin credentials that have sufficient permissions. If the issue persists, contact BLOX Customer Support — this is one area where our support team can assist with the BLOX-side OAuth configuration.
I'm experiencing issues with Claude or ChatGPT behavior specifically. Issues with how the AI model interprets prompts, handles responses, or behaves within its own interface are outside the scope of BLOX Customer Support. Consult the support resources for your AI platform directly: Claude Support / ChatGPT Support.
Can I connect multiple domains to a single AI session? Yes. During the authorization step, you can select multiple domains. The AI will be able to call tools across any of the authorized domains.
Is content sent to the AI stored or used for training? Content passed through the BLOX NXT MCP server is used only to fulfill the request in real time. Review the data handling policies of your specific AI platform (Claude or ChatGPT) for details on how they process inputs on their end.