Connect AI Assistants (MCP)

What You’ll Accomplish

You’ll connect an AI assistant like Claude or Cursor to your IDEQO account. After that, you can manage your social content by chatting. For example:

“Create a post about our summer sale, add the product image from this URL, and schedule it to Instagram and LinkedIn for Friday at 2pm.”

Your assistant does the rest inside IDEQO. Drafts, media, and schedules all appear in your dashboard as if you created them yourself.

What Is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants use external tools. IDEQO runs an MCP server at:

https://mcp.ideqo.com

Any MCP-compatible client can connect to it. That includes Claude Desktop, Claude Code, Cursor, and many others.

Before You Start

You’ll need:

• An IDEQO account on a paid plan (MCP is not available on the free plan)
• At least one connected platform to schedule posts to
• An MCP-compatible AI client installed (Claude Desktop, Claude Code, or Cursor)

Step 1: Create an API Key

Your AI assistant signs in with an API key instead of your password. Each key has its own permissions and can be revoked at any time.

1. 1
   Open your profile

   In IDEQO, click your avatar and go to Profile > Security.

2. 2
   Find MCP API Keys

   Scroll to the MCP API Keys card.

3. 3
   Click Create API Key

   Give the key a name you'll recognize later, like Claude Desktop.

4. 4
   Choose permissions

   Leave all permissions checked for the full experience. You can limit a key to read-only if you prefer.

5. 5
   Copy your key

   The key starts with iqo_live_. Copy it right away and store it somewhere safe.

⚠️ Warning

Your key is shown only once. If you lose it, revoke it and create a new one. Treat it like a password. Anyone with the key can post on your behalf.

Step 2: Connect Your AI Client

Use the configuration for your client below. Replace YOUR_API_KEY with the key you copied.

Claude Desktop

Add this to your claude_desktop_config.json file, then restart Claude Desktop:

{
  "mcpServers": {
    "ideqo": {
      "type": "http",
      "url": "https://mcp.ideqo.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Where to find the file: In Claude Desktop, go to Settings > Developer > Edit Config.

Claude Code

Run this command in your terminal:

claude mcp add --transport http ideqo https://mcp.ideqo.com \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add this to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for all projects):

{
  "mcpServers": {
    "ideqo": {
      "url": "https://mcp.ideqo.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

💡 Tip

The key creation dialog in IDEQO shows a ready-to-paste configuration with your key already filled in. Copy it from there to skip the manual editing.

Step 3: Try It

Ask your assistant something simple first:

“List my connected IDEQO channels.”

You should see your connected platforms with their names. Then try the full flow:

“Create an IDEQO draft that says ‘Big things coming this week 👀 #staytuned’ and schedule it to Instagram for tomorrow at 10am.”

Verify It Worked

Open your IDEQO Dashboard and check the Scheduling page. The post your assistant created appears there with its scheduled time. You can edit or cancel it from the app like any other post.

What Your Assistant Can Do

Ask for	What happens
List channels	Shows your connected platforms and their status
List or read posts	Browses your drafts, scheduled, and published posts
Create a post	Creates a new draft with your caption and hashtags
Edit a post	Updates the caption of a draft or scheduled post
Per-platform captions	Writes a different caption for each platform on the same post — the default caption covers the rest
Add an image from a URL	Downloads an image from a public URL into your Asset Library and attaches it
Upload a local image or video	Uploads a file from your machine straight to your Asset Library and attaches it
Schedule a post	Queues the post to one or more channels at a specific time
Reschedule	Schedules the same post and channel again with a new time
Cancel a schedule	Cancels pending publishing. The post goes back to draft

A few platform rules your assistant will enforce:

• Instagram, Pinterest, and TikTok need at least one image attached before scheduling.
• YouTube needs a video — your assistant can upload one from your machine.
• Images can be JPEG, PNG, WebP, or GIF up to 15 MB — from a public HTTPS URL or uploaded locally.
• Videos can be MP4, MOV, or WebM up to 100 MB, uploaded locally.
• Shopify is not available as a publishing channel through MCP — it only supports blog publishing, not social posts.
• Published posts can’t be edited or deleted through MCP.

Permissions

Each key only does what you allow. Pick permissions when you create the key:

Read channels: See connected platforms. Read posts: Browse posts and drafts. Create and edit posts: Make new drafts and change captions. Schedule: Queue and cancel publishing. Media: Attach images from URLs and upload local images and videos.

If a key is missing a permission, the assistant gets a clear error telling it which one is needed.

Usage Limits

Limits apply per key, per hour:

Action	Limit
Reads (list, get)	120 per hour
Create and edit posts	30 per hour
Schedule and cancel	20 per hour
Add media	60 per hour

These are generous for personal use. The media limit counts confirmed uploads only — the initial URL request step does not count against it. If your assistant hits a limit, it can retry after the time shown in the error.

Security

• Keys are stored hashed. IDEQO can never show you a key again after creation.
• Revoke any key instantly from Profile > Security > MCP API Keys. Revoking takes effect on the next request.
• Every action is recorded in an audit log with the tool used, the time, and the result.
• Keys belong to your team. They stop working if you leave the team.

If It Fails

Error	What it means	Fix
”Missing bearer token” or “Invalid token”	The key is wrong, revoked, or expired	Check the key in your client config. Create a new one if needed
”MCP requires a paid plan”	Your team is on the free plan	Upgrade your plan
”This token is missing required scope”	The key doesn’t have that permission	Create a new key with the permission checked
”These channels require at least one image”	Image-first platform with no media	Ask your assistant to add an image first
”YouTube requires a video”	The post has no video attached	Ask your assistant to upload one from your machine
”Shopify supports blog publishing only”	Shopify can’t receive social posts	Schedule to your social channels instead
”This upload_token has expired” or “was already used”	The upload took too long or was retried	Ask your assistant to restart the upload — it gets a fresh token automatically
”Rate limit exceeded”	Too many requests this hour	Wait and retry. The error says how long
”Post not found”	Wrong post ID, or the post belongs to another team	Ask your assistant to list posts and pick again

Still stuck? See Publishing Errors or contact support from the in-app help widget.

Next Steps

• Connect more platforms →
• Learn about scheduling →
• Set up your Brand Kit →