Skip to content

Model Context Protocol (MCP) setup guide ​

Connect your MyContentLab marketing intelligence directly to Claude Desktop, Claude.ai Web, Claude Code CLI, or Cursor / Antigravity IDE using the open Model Context Protocol (MCP).

Overview ​

The MyContentLab MCP server enables AI assistants to query real-time workspace data — client accounts, multi-channel performance metrics, report summaries, brand listening mentions, market trends, CRM pipeline totals, and Content Lab ideas.

NOTE

Access is strictly read-only: AI assistants can look up and analyze data, but can never create, modify, or delete anything in your account.

The fastest and most secure method uses the official OAuth 2.1 Remote Connector flow. No config files or static token copying required.

Step 1: Open connector settings ​

  1. In Claude Desktop or Claude.ai Web, go to: Settings → Connectors → Add custom connector (or Add Tool).
  2. Enter the connector configuration:
    • Server URL: https://app.mycontentlab.ai/functions/mcp-server
    • Authentication: Always required (or Required when the server asks)
    • OAuth client: No client ID — register one automatically (uses RFC 7591 Dynamic Client Registration)

Step 2: Authorize MyContentLab ​

  1. Click Connect / Add Connector.
  2. A browser window opens displaying the MyContentLab Consent Screen.
  3. Log in with your MyContentLab account (owner or manager role required).
  4. Review the requested permissions and click Allow Access.

Claude will automatically exchange tokens and register the tools. You can now mention @mycontentlab or ask questions directly in your chat.

Method 2: Claude Code CLI (terminal) ​

For automated or terminal workflows using Claude Code:

Step 1: Generate a Personal Access Token (PAT) ​

  1. Go to Settings → API & MCP Access in MyContentLab.
  2. Click New token, select the desired scopes and expiration (30, 90, or 365 days).
  3. Copy your token starting with mcl_pat_....

Step 2: Register the server ​

Run the following command in your terminal (replace YOUR_PAT_TOKEN):

bash
claude mcp add --transport http mycontentlab \
  https://app.mycontentlab.ai/functions/mcp-server \
  --header "Authorization: Bearer YOUR_PAT_TOKEN"

Method 3: Claude Desktop via config file (PAT bridge) ​

If you prefer using static PAT credentials in Claude Desktop via mcp-remote:

  1. Open your configuration file:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the following server configuration:
json
{
  "mcpServers": {
    "mycontentlab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.mycontentlab.ai/functions/mcp-server",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_PAT_TOKEN"
      }
    }
  }
}
  1. Restart Claude Desktop completely.

Available MCP tools ​

Tool nameRequired scopeDescription
list_clientsread:clientsLists all active clients, company names, industry, and websites.
get_client_metricsread:metricsRetrieves monthly performance metrics across connected ad and social platforms.
get_report_summaryread:metricsReturns executive AI summaries, key findings, and action items from reports.
list_mentionsread:mentionsReturns brand mentions and sentiment analysis from Social Listening.
get_trendsread:trendsQueries market trends and opportunities relevant to client industry tags.
get_crm_summaryread:crmAggregates deal stages, total pipeline value, and conversion metrics.
list_content_ideasread:contentlabReturns AI-generated content ideas, hooks, angles, and opportunity scores.

Sample prompts ​

  • "List my active clients from MyContentLab."
  • "Show last month's performance metrics for [Client Name] and summarize the top performing platform."
  • "What are the latest social listening mentions for [Client Name] with negative sentiment?"
  • "Give me the highest-scoring content ideas for [Client Name] from Content Lab."
  • "Summarize the current CRM open pipeline and deal count for [Client Name]."

Creative Science Lab for Agencies & Brands