Skip to main content

Prerequisites

  1. Sign up at app.clickflow.com and create an organization
  2. Connect Google Search Console (recommended — enables SEO data and content workflows)
  3. Set up your brand voice (so AI-generated content matches your tone)

Get your API key

  1. Go to Settings > API Keys in the ClickFlow dashboard
  2. Click Create API Key
  3. Choose scopes (start with tools:* for full access)
  4. Copy the key — it starts with cf_ak_ and is only shown once
Store your API key securely. It cannot be retrieved after creation.

Connect

Add this to your .mcp.json (or your MCP client’s config):
.mcp.json
{
  "mcpServers": {
    "clickflow": {
      "type": "http",
      "url": "https://api.clickflow.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer cf_ak_your_key_here"
      }
    }
  }
}
Once connected, your AI assistant can call ClickFlow tools directly. Try asking:
“List my ClickFlow organizations”
If your MCP client supports OAuth, you can omit the headers block — the client will handle authentication interactively. See Authentication for details.

Try it: create your first article

This example creates a roadmap item and kicks off the AI drafting workflow.
Call the platform.create_roadmap_item tool:
{
  "keyword": "how to improve SEO rankings",
  "prompt": "Write a comprehensive guide for small business owners",
  "strategy": "How-to guide",
  "start_drafting": true
}
Response:
{
  "roadmap_item_id": "ri_abc123",
  "workflow_id": "wf_xyz789",
  "status": "In Progress",
  "message": "Roadmap item created and drafting started. Poll workflows.get_status for progress."
}
Then poll workflows.get_status with the workflow_id until status is Completed. The output contains html, title, meta_description, and thumbnail_url.

Next steps

Authentication

Deep dive into OAuth, API keys, and scopes.

Organizations

Multi-org support and switching between orgs.

Workflows

Understand async workflows, polling, and human review.

All Capabilities

Browse the full capability reference.