Skip to content
CampaignStack CampaignStack

Quick Start

Connect to CampaignStack

Section titled “Connect to CampaignStack”

  1. Get an API key

    Go to Settings > API Keys and create a user key. Select the scopes you need (or “Select all” to start).

    Copy the key — it starts with csu_ and is shown only once. (Workspace-bound cs_ keys also exist — see Authentication.)

  2. Connect your MCP client

    Add to your Claude Desktop config (claude_desktop_config.json) or Claude Code settings:

    {
      "mcpServers": {
        "campaignstack": {
          "url": "https://mcp.campaignstack.io/mcp",
          "headers": {
            "Authorization": "Bearer csu_your_api_key_here"
          }
        }
      }
    }

  3. Verify the connection

    Call the campaignstack_whoami tool. It returns your available scopes and the workspaces you belong to:

    {
      "keyType": "user",
      "keyPrefix": "csu_a1b2",
      "scopes": ["campaigns:read", "campaigns:write", "leads:read"],
      "user": { "id": "...", "name": "...", "email": "..." },
      "workspaces": [
        { "workspaceId": "abc123", "name": "My Agency", "role": "owner" }
      ]
    }

  4. Make your first real call

    Try listing your campaigns:

    Use the campaignstack_list_campaigns tool with workspaceId from whoami

    The response includes campaign IDs you can use with campaignstack_get_campaign, campaignstack_list_workflows, and other tools.

What’s next

Section titled “What’s next”