Installation and Getting Started

This guide walks site administrators through installing the MCP Server addon collection and configuring AI clients to manage your Contensive website.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude interact with external tools. Once installed, the MCP Server addon gives Claude the ability to create pages, manage widgets, upload resources, and more on your Contensive site.

Installing the MCP Server Collection

Using the Addon Manager

1. Log in to your Contensive site as an administrator
2. Navigate to Admin > Addon Manager
3. Click Install Collection from File
4. Select the aoMcp.zip file
5. Click Install
6. Wait for the installation to complete

Using the Command Line (Local Sites)

For local development sites, use the Contensive command line:

cc -a <sitename> --installFile "path\to\aoMcp.zip"

Verifying the Installation

After installation, verify these items:

1. Addon is active -- Navigate to Addons > Add-on Manager, search for "mcp", and confirm it is active
2. MCP Undo content exists -- Navigate to Content > Content Definitions and verify "MCP Undo" exists
3. MCP Tool Definitions content exists -- Verify "MCP Tool Definitions" exists in Content Definitions
4. Route is configured -- The /mcp endpoint should respond at https://yoursite.com/mcp

Authentication

The MCP Server uses OAuth 2.0 for authentication. AI clients authenticate using bearer tokens issued by your site's authorization server.

The endpoint also checks that the authenticated user has the Administrator role. Non-admin users receive a 401 Unauthorized response.

OAuth Discovery

MCP clients discover your authorization server automatically via the standard endpoint:

https://yoursite.com/.well-known/oauth-protected-resource

This returns the authorization server URL that clients use to obtain bearer tokens.