MCP Integration

Model Context Protocol Integration for Claude Desktop

JSON-RPC 2.0

Node.js Bridge

Multi-Tenant

7 Tools

Overview

What is MCP Integration?

The MCP (Model Context Protocol) integration enables Claude Desktop to directly access the Cognitor CMS. Through a Node.js bridge, you can use content, pages, and search functions directly in Claude.

Architecture:

Claude Desktop → Node.js Bridge → Cognitor CMS API

Available Features

Content Management

• Retrieve content elements
• Load pages with content
• Multi-site support

Search & Discovery

• Full-text search
• Search suggestions
• Site discovery

Setup & Installation

1. Download Bridge Script

Download:

cognitor_mcp_bridge.js📥 Download

2. Configure Claude Desktop

macOS Configuration:

File: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cognitor-cms": {
      "command": "node",
      "args": ["/path/to/cognitor_mcp_bridge.js"]
    }
  }
}

Windows Configuration:

File: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "cognitor-cms": {
      "command": "node",
      "args": ["C:\\path\\to\\cognitor_mcp_bridge.js"]
    }
  }
}

3. Restart Claude Desktop

After configuration, you need to completely restart Claude Desktop for the MCP integration to load.

macOS:Cmd+Q → Reopen Claude

Windows:Task Manager → End Claude → Restart

Available Tools

discover_sites

Discovers available sites in the CMS

Parameters:

No parameters required

Example Question:

"What sites are available?"

content_list_elements

Lists content elements from a site

Parameters:

site_identifier (optional), limit, skip, type_filter

Example Question:

"Show me the latest articles"

content_get_element

Retrieves a single content element

Parameters:

element_id (required), site_identifier (optional)

Example Question:

"Get content element 123"

pages_list

Lists all pages from a site

Parameters:

site_identifier (optional), limit, skip

Example Question:

"Show me all pages"

pages_get

Retrieves a page with all content

Parameters:

page_id (required), site_identifier (optional)

Example Question:

"Load page 456 with all content"

search_content

Searches all content in a site

Parameters:

query (required), site_identifier, page, size

Example Question:

"Search for 'AI' in the content"

search_suggestions

Generates search suggestions

Parameters:

query (required), site_identifier, limit

Example Question:

"Give me search suggestions for 'tech'"

Practical Examples

How to Use the MCP Integration

Examples for usage in Claude Desktop

🔍 Site Discovery

You: "What sites are available in the CMS?"

Claude: Automatically uses discover_sites and lists all available sites.

📄 Content Retrieval

You: "Show me the last 5 articles from the demo site"

Claude: Uses content_list_elements with automatic site detection.

🔎 Search

You: "Search all content for 'Artificial Intelligence'"

Claude: Uses search_content and shows relevant results with highlights.

📋 Page Management

You: "Load page 123 with all content elements"

Claude: Uses pages_get and shows the complete page structure.

Troubleshooting

Common Issues and Solutions

❌ "Server disconnected"

• Restart Claude Desktop

• Check Node.js installation: node --version

• Verify bridge script path in configuration

❌ "No tools available"

• Check configuration file syntax (valid JSON)

• Verify bridge script permissions

• Consult Claude Desktop logs

⚠️ "HTTP Error 404"

• Check backend availability

• Verify site identifier

• Use automatic site discovery

Additional Resources

API Documentation Live Demos MCP Protocol (GitHub)