Connect via MCP

Connect Claude, Cursor, or ChatGPT to your VoiceCite account using the Model Context Protocol. Your assistant can manage blog ideas, drafts, founder Q&A, and brand profile directly from chat.

Prerequisites

Connect your client

Choose your AI client below for step-by-step setup instructions.

Auth: OAuth (recommended)

  1. 1

    Open Claude settings

    In Claude Desktop or Claude Code, go to Settings → Connectors (or MCP) and add a custom connector.

  2. 2

    Enter the server URL

    Paste https://api.voicecite.com/mcp as the connector URL.

  3. 3

    Authorize with VoiceCite

    Click Connect. Your browser opens VoiceCite — sign in and click Allow access.

  4. 4

    Select your site

    If you have multiple sites, ask Claude to call list_sites, then select_site with the site name before using other tools.

Claude uses OAuth automatically. You do not need to generate an API key or edit a config file.

Available tools

Once connected, your assistant can call these MCP tools. Tool names are exact — use them when prompting your client.

Tools marked site required need select_site called first. Accounts with multiple sites must call list_sites then select_site before any other tool.

Account

list_sites
List all VoiceCite sites on the connected account
select_site
Select which VoiceCite site to use by name (for accounts with multiple sites)

Blog

list_blogssite required
List blog ideas and drafts for your connected site, filterable by status. Returns ideaId for follow-up tool calls only.
get_blogsite required
Get full context for a blog idea including outline, Q&A, and SEO metadata
get_blog_draftsite required
Get the generated draft markdown for a specific blog draft
update_blog_draftsite required
Patch sections of a draft (content, meta title/description, intro)
reschedule_blogsite required
Change the publish date for a scheduled blog

Ideas

list_ideassite required
List unscheduled content box ideas for your connected site
check_publish_datesite required
Check whether a publish date is available, replaceable, or blocked before adding a blog idea
add_blog_ideasite required
Save a new blog idea and schedule it on a specific publish date (runs background research enrichment)
update_blog_user_perceptionsite required
Save summarized user preferences after discussing a blog (overview, outline, must-include points)
schedule_ideasite required
Move an idea from the content box onto the calendar

Profile

get_site_contextsite required
Read brand, product, and customer profile for this site
update_site_profilesite required
Update brand, product, or customer profile (target customers, pain points, voice notes, content focus, product pricing)

Competitors

list_competitorssite required
List researched competitors for this site with topics and content gaps
add_competitorsite required
Add a competitor website — researches and saves competitive intelligence
remove_competitorsite required
Remove a competitor by domain

Keywords

get_keyword_strategysite required
Fetch pillar structure and keyword universe from research

Q&A

get_pending_qnasite required
List unanswered founder questions for upcoming blogs
submit_qna_answersite required
Save answers for a blog's founder questions and start generation

FAQ

Do I need a separate API key per device?

No. One key works across devices. Create separate keys only if you want to revoke access independently (e.g. one for Cursor, one for ChatGPT).

Should Claude use OAuth or an API key?

Use OAuth. Claude Desktop and Claude Code support it natively — add the server URL and sign in when prompted. API keys work but OAuth is simpler for Claude.

Why does ChatGPT require Developer Mode?

Custom MCP connectors are a developer feature. Enable Developer Mode under Settings → Apps & Connectors → Advanced. A paid ChatGPT plan is required.

Connection returns 401 — what do I check?

Your API key may be revoked, mistyped, or missing the Bearer prefix. Generate a new key in Settings → Integrations → Zuwie AI if needed. For OAuth, sign in again via the Connect flow.

How do I revoke access?

Go to Settings → Integrations → Zuwie AI and revoke the API key. For OAuth connections, revoke the key or deny future authorization requests in VoiceCite.