What is MCP?
The Model Context Protocol (MCP) is a standard that allows AI assistants and tools to securely interact with external systems. With ChatFeatured’s MCP integration, you can:- Generate and manage articles directly from your AI assistant
- Query real-time analytics and crawler data
- Manage brands, competitors, and content strategy
- Schedule and publish articles
- All without switching contexts or copying/pasting between tools
Supported Clients
The ChatFeatured MCP works with any MCP-compatible client, including:- Claude Desktop — MacOS/Windows desktop application
- Claude Code — Command-line tool
- Cursor — AI-powered code editor
- Windsurf — Collaborative IDE
- And any other MCP-compatible application
Connection Methods
Method 1: OAuth (Recommended)
OAuth is the recommended connection method for Claude Desktop and Claude Code. It’s secure, requires no manual key management, and handles sign-in automatically.Claude Desktop
- Open Claude Desktop Settings
- Go to Customize
- Click Add custom connector
- Paste the MCP server URL:
- Click Add
- Sign in with your ChatFeatured account (automatic OAuth flow)
- Grant ChatFeatured access to your workspace
- Done! The integration is now active
Claude Code
In your terminal:Method 2: API Key
Use API keys for CLI tools, scripts, or environments where OAuth isn’t available (Cursor, Windsurf, custom scripts).Step 1: Generate an API Key
- Log in to ChatFeatured
- Go to Integrations → AI Assistants (MCP)
- Scroll to API Keys
- Click + Create API Key
- Give it a name (e.g., “Cursor Integration”, “Claude Code Script”)
- Click Create
- Copy the generated key — it’s only shown once
Step 2: Configure Your Client
For Cursor:- Open Cursor settings
- Go to Extensions → ChatFeatured
- Paste your API key in the configuration
- Restart Cursor
.mcp/config.json:
Available Capabilities
Once connected, the MCP exposes the following tools:Analytics & Insights
- Query Analytics — Get traffic, rankings, and visibility data
- Query Crawler Analytics — View AI crawler activity and citations
- Search Images — Find images from Pexels for articles
Brand & Strategy
- List Brands — View all brands in your workspace
- Get Brand Book — Access your brand voice and guidelines
- Update Brand Book — Refine brand guidelines
- List Competitors — View your competitive set
- Manage Competitor — Add or update competitors
- List Prompts — View all content prompts
- Create Prompt — Generate new content prompts
- Update Prompt — Modify existing prompts
Content Management
- Generate Articles — Create new articles using your brand voice and prompts
- List Articles — View all articles in your workspace
- Get Article — Fetch details of a specific article
- Update Article Content — Edit article body text
- Approve/Archive Articles — Manage article status
- Publish Article — Push articles to your CMS
- Schedule Article — Schedule articles for future publishing
- Delete Articles — Remove articles permanently
- Set Featured Image — Add cover images to articles
Knowledge & Organization
- Knowledge Base Query — Search your knowledge base documents
- List Tags — View all content tags
- Manage Tags — Create and organize tags
- List Organizations — View workspace organizations
Usage Examples
Generate an Article with Claude
- Query your brand book for voice/style
- Check your competitors for differentiation
- Generate the article
- Create it in ChatFeatured
- Report back with status and next steps
Query Analytics
- Page URLs and visit counts
- Citation frequency per page
- AI models that cited you
- Sentiment of citations
Manage Your Content Roadmap
- Analyze competitor content
- Create targeted prompts
- Identify coverage gaps
- Suggest publishing timeline
Managing Connections
View Connected Assistants
Go to Integrations → AI Assistants (MCP) to see all connected clients:- OAuth connections — Show user and last-connected date
- API Keys — Show key name and creation date
Disconnect an Assistant
- Go to Integrations → AI Assistants (MCP)
- Find the assistant or API key
- Click the trash icon to disconnect/revoke
Disconnecting does NOT delete your data in ChatFeatured—it only revokes the assistant’s access to it.
Rotate API Keys
For security, rotate API keys periodically:- Generate a new API key (Step 1 above)
- Update your client config with the new key
- Delete the old key from the dashboard
- Test the connection works
Best Practices
Security
✅ Do:- Store API keys in environment variables
- Rotate keys every 90 days
- Use OAuth when possible (automatic token refresh)
- Revoke keys for assistants you no longer use
- Commit API keys to version control
- Share API keys in messages or screenshots
- Use the same key across multiple environments
- Store keys in plain-text config files
Performance
✅ Do:- Batch requests when possible (e.g., “generate 5 articles at once”)
- Use specific prompts for better results
- Reference your brand book for consistency
- Check analytics before publishing to validate timing
- Generate the same article multiple times in quick succession
- Query analytics every minute (batch daily reviews instead)
- Publish without reviewing the article first
- Ignore competitor updates in your strategy
Troubleshooting
OAuth sign-in hangs or fails
OAuth sign-in hangs or fails
Cause: Network issue or OAuth redirect misconfiguredSolution:
- Ensure you’re not behind a restrictive firewall
- Try disconnecting and reconnecting
- Clear your browser cache if using Claude Desktop web
- Check that your ChatFeatured account is active
- If it persists, generate an API key as a workaround
API key returns 401 Unauthorized
API key returns 401 Unauthorized
Claude says 'Tool not found' or 'MCP unavailable'
Claude says 'Tool not found' or 'MCP unavailable'
Getting rate-limited errors
Getting rate-limited errors
Cause: Too many rapid requests to the MCPSolution:
- Space out requests by a few seconds
- Batch operations (e.g., generate multiple articles in one prompt)
- Avoid polling for updates in tight loops
- Contact support if you need higher rate limits
Articles generated but not appearing in ChatFeatured
Articles generated but not appearing in ChatFeatured
Cause: Generation succeeded but article didn’t syncSolution:
- Manually refresh the ChatFeatured dashboard
- Check the articles list in your AI assistant
- Verify you’re in the correct brand workspace
- Check browser console for any errors
- Regenerate the article if it was lost
API Reference
The MCP exposes the following tool categories:| Category | Tools | Example Use |
|---|---|---|
| Content | Generate, list, update, publish, schedule articles | Create and deploy new content |
| Analytics | Query crawler data, traffic, citations | Monitor AI visibility |
| Brand | Manage brand book, competitors, prompts | Define strategy |
| Knowledge | Search knowledge base, manage tags | Organize and retrieve information |
Support & Questions
- Documentation: Check the ChatFeatured docs
- Issues: Contact support@chatfeatured.com
- Feature requests: Let us know what you’d like to build
See Also
- Agent Analytics — Monitor AI crawler activity
- Index Submissions — Submit content to AI search engines
- Content Strategy — Plan your AI-optimized content