> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatfeatured.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Assistants (MCP)

> Connect Claude, Claude Code, Cursor, and other MCP-compatible clients to ChatFeatured

Connect your favorite AI assistants directly to ChatFeatured using the Model Context Protocol (MCP). Manage content, query analytics, and automate workflows without leaving your coding environment.

**Status:** Available | **Complexity:** Intermediate | **Setup time:** 5-10 minutes

## 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

1. Open **Claude Desktop Settings**
2. Go to **Customize**
3. Click **Add custom connector**
4. Paste the MCP server URL:
   ```text theme={null}
   https://chatfeatured.com/api/mcp
   ```
5. Click **Add**
6. Sign in with your ChatFeatured account (automatic OAuth flow)
7. Grant ChatFeatured access to your workspace
8. Done! The integration is now active

#### Claude Code

In your terminal:

```bash theme={null}
claude mcp add --transport http chatfeatured https://chatfeatured.com/api/mcp
```

Then sign in with your ChatFeatured account when prompted.

<Tip>
  OAuth automatically handles authentication and token refresh. Your credentials are never stored in config files.
</Tip>

***

### 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

1. Log in to ChatFeatured
2. Go to **Integrations → AI Assistants (MCP)**
3. Scroll to **API Keys**
4. Click **+ Create API Key**
5. Give it a name (e.g., "Cursor Integration", "Claude Code Script")
6. Click **Create**
7. Copy the generated key — it's only shown once

<Warning>
  Treat API keys like passwords. Never commit them to version control. Store them in environment variables or secure config files.
</Warning>

#### Step 2: Configure Your Client

**For Cursor:**

1. Open Cursor settings
2. Go to **Extensions → ChatFeatured**
3. Paste your API key in the configuration
4. Restart Cursor

**For Claude Code:**

```bash theme={null}
claude mcp add --transport http \
  --header "x-api-key: YOUR_API_KEY" \
  chatfeatured https://chatfeatured.com/api/mcp
```

**For Scripts (Node.js example):**

```javascript theme={null}
const mcp = require("@anthropic-sdk/mcp-client");

const config = {
  mcpServers: {
    chatfeatured: {
      url: "https://chatfeatured.com/api/mcp",
      headers: {
        "x-api-key": process.env.CHATFEATURED_API_KEY
      }
    }
  }
};
```

**For Generic MCP Client:**

Add to your `.mcp/config.json`:

```json theme={null}
{
  "mcpServers": {
    "chatfeatured": {
      "url": "https://chatfeatured.com/api/mcp",
      "headers": {
        "x-api-key": "cf_your_key_here"
      }
    }
  }
}
```

***

## 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

```text theme={null}
Claude, using ChatFeatured, generate an article about "AI Search Optimization" 
for our brand (Brand Name) that targets an audience interested in (key offerings). 
Make it 1500 words.
```

Claude will:

1. Query your brand book for voice/style
2. Check your competitors for differentiation
3. Generate the article
4. Create it in ChatFeatured
5. Report back with status and next steps

### Query Analytics

```text theme={null}
What were our top 5 pages by AI crawler visits last week? And which ones 
got cited in AI search responses?
```

The MCP returns:

* Page URLs and visit counts
* Citation frequency per page
* AI models that cited you
* Sentiment of citations

### Manage Your Content Roadmap

```text theme={null}
Claude, create 5 new article prompts for our Q3 content strategy. They should 
target topics around sustainable gaming practices and player protection. 
Then tell me how we compare to our competitors on these topics.
```

Claude will:

1. Analyze competitor content
2. Create targeted prompts
3. Identify coverage gaps
4. 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

1. Go to **Integrations → AI Assistants (MCP)**
2. Find the assistant or API key
3. Click the trash icon to disconnect/revoke

Disconnecting immediately revokes access. No further requests will be accepted.

<Info>
  Disconnecting does NOT delete your data in ChatFeatured—it only revokes the assistant's access to it.
</Info>

### Rotate API Keys

For security, rotate API keys periodically:

1. Generate a new API key (Step 1 above)
2. Update your client config with the new key
3. Delete the old key from the dashboard
4. 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

❌ **Don't:**

* 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

❌ **Don't:**

* 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

<Accordion title="OAuth sign-in hangs or fails">
  **Cause:** Network issue or OAuth redirect misconfigured

  **Solution:**

  1. Ensure you're not behind a restrictive firewall
  2. Try disconnecting and reconnecting
  3. Clear your browser cache if using Claude Desktop web
  4. Check that your ChatFeatured account is active
  5. If it persists, generate an API key as a workaround
</Accordion>

<Accordion title="API key returns 401 Unauthorized">
  **Cause:** Invalid, expired, or revoked API key

  **Solution:**

  1. Verify the key is exactly as generated (no extra spaces)
  2. Check the key hasn't been deleted from the dashboard
  3. Regenerate a new API key and update your config
  4. Ensure the header is exactly `x-api-key: YOUR_KEY` (case-sensitive)
</Accordion>

<Accordion title="Claude says 'Tool not found' or 'MCP unavailable'">
  **Cause:** MCP server unreachable or connection misconfigured

  **Solution:**

  1. Verify the MCP URL is exactly: `https://chatfeatured.com/api/mcp`
  2. Check your internet connection
  3. Restart your client application
  4. If using API key, verify it's in the correct header format
  5. Try switching to OAuth if you were using API key
</Accordion>

<Accordion title="Getting rate-limited errors">
  **Cause:** Too many rapid requests to the MCP

  **Solution:**

  1. Space out requests by a few seconds
  2. Batch operations (e.g., generate multiple articles in one prompt)
  3. Avoid polling for updates in tight loops
  4. Contact support if you need higher rate limits
</Accordion>

<Accordion title="Articles generated but not appearing in ChatFeatured">
  **Cause:** Generation succeeded but article didn't sync

  **Solution:**

  1. Manually refresh the ChatFeatured dashboard
  2. Check the articles list in your AI assistant
  3. Verify you're in the correct brand workspace
  4. Check browser console for any errors
  5. Regenerate the article if it was lost
</Accordion>

***

## 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 |

For a complete list of available tools and parameters, ask your AI assistant:

```text theme={null}
What tools does ChatFeatured MCP provide? List them all with descriptions.
```

***

## Support & Questions

* **Documentation:** Check the [ChatFeatured docs](https://docs.chatfeatured.com/)
* **Issues:** Contact [support@chatfeatured.com](mailto:support@chatfeatured.com)
* **Feature requests:** Let us know what you'd like to build

***

## See Also

* [Agent Analytics](/using-chatfeatured/agent-analytics) — Monitor AI crawler activity
* [Index Submissions](/index-submissions/setup) — Submit content to AI search engines
* [Content Strategy](/using-chatfeatured/content-strategy) — Plan your AI-optimized content