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

# Quickstart

> Connect ClickFlow to your MCP client or make your first API call.

## Prerequisites

1. **Sign up** at [app.clickflow.com](https://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)

## Connect

<Tabs>
  <Tab title="MCP (Claude, Cursor, etc.)">
    Add this to your `.mcp.json` (or your MCP client's config):

    ```json .mcp.json theme={null}
    {
      "mcpServers": {
        "clickflow": {
          "type": "http",
          "url": "https://api.clickflow.com/v1/mcp"
        }
      }
    }
    ```

    **No API key needed.** Your MCP client will open a browser login on first use — you sign in with your regular ClickFlow account (the same login you use at app.clickflow\.com).

    Once connected, your AI assistant can call ClickFlow tools directly. Try asking:

    > "List my ClickFlow organizations"
  </Tab>

  <Tab title="REST API">
    The REST API uses API keys for authentication.

    ### Get your API key

    1. Go to **Settings > API Keys** in the ClickFlow dashboard
    2. Click **Create API Key**
    3. Copy the key — it starts with `cf_ak_` and is only shown once

    <Warning>Store your API key securely. It cannot be retrieved after creation.</Warning>

    ### Make your first request

    ```bash theme={null}
    curl https://api.clickflow.com/v1/api/organizations \
      -H "Authorization: Bearer cf_ak_your_key_here"
    ```

    Response:

    ```json theme={null}
    {
      "organizations": [
        {
          "_id": "org_abc123",
          "name": "My Company",
          "domain": "example.com"
        }
      ],
      "count": 1
    }
    ```
  </Tab>
</Tabs>

## Try it: create your first article

This example creates a roadmap item and kicks off the AI drafting workflow.

<Tabs>
  <Tab title="MCP">
    Call the `platform_create_roadmap_item` tool:

    ```json theme={null}
    {
      "keyword": "how to improve SEO rankings",
      "prompt": "Write a comprehensive guide for small business owners",
      "strategy": "How-to guide",
      "start_drafting": true
    }
    ```

    Response:

    ```json theme={null}
    {
      "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`.
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X POST https://api.clickflow.com/v1/api/roadmap-items \
      -H "Authorization: Bearer cf_ak_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "keyword": "how to improve SEO rankings",
        "prompt": "Write a comprehensive guide for small business owners",
        "strategy": "How-to guide",
        "start_drafting": true
      }'
    ```

    Then poll the workflow:

    ```bash theme={null}
    curl https://api.clickflow.com/v1/api/workflows/wf_xyz789/status \
      -H "Authorization: Bearer cf_ak_your_key_here"
    ```
  </Tab>
</Tabs>

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Deep dive into OAuth, API keys, and headers.
  </Card>

  <Card title="Organizations" icon="building" href="/concepts/organizations">
    Multi-org support and switching between orgs.
  </Card>

  <Card title="Workflows" icon="arrows-spin" href="/concepts/workflows">
    Understand async workflows, polling, and human review.
  </Card>

  <Card title="All Capabilities" icon="grid-2" href="/capabilities/content-pipeline">
    Browse the full capability reference.
  </Card>
</CardGroup>