Getting started

SegmentStream MCP is a self-contained server with built-in measurement skills. Connect your AI tool using the server URL — authentication is handled automatically via OAuth.

Prerequisites

A SegmentStream account with access to at least one project
An MCP-compatible AI tool — Claude.ai, Claude Code, Claude Cowork, Claude Desktop, Cursor, VS Code, or Windsurf

Setup by tool

The fastest way to get started. Once connected in claude.ai, the connection is automatically available in Claude Code, Claude Desktop, and Cowork — no additional setup needed.

Click Customize

Go to claude.ai and click Customize in the left sidebar.

Claude.ai sidebar with Customize highlighted

Open Connectors

Click Connectors.

Customize page showing Skills and Connectors options

Add a custom connector

Click the + button, then select Add custom connector.

Connectors page with + button and Add custom connector option

Enter the SegmentStream MCP URL

Enter a name (e.g. “SegmentStream”) and paste the server URL, then click Add:

https://mcp.segmentstream.com/mcp

Connect

The connector appears as “Not connected”. Click Connect to start the OAuth flow.

Authorize

SegmentStream authorization page requesting access to projects, reports, and campaign data

Cowork uses the same Connectors interface as claude.ai.

Click Customize

Click Customize in the left sidebar.

Claude sidebar with Customize highlighted

Open Connectors

Click Connectors.

Add a custom connector

Click the + button, then select Add custom connector.

Enter the SegmentStream MCP URL

Enter a name (e.g. “SegmentStream”) and paste the server URL, then click Add:

https://mcp.segmentstream.com/mcp

Connect

The connector appears as “Not connected”. Click Connect to start the OAuth flow.

Authorize

Once connected, start a new task and ask the agent about your marketing data.

Run this command in your terminal:

claude mcp add segmentstream \
  --transport http \
  https://mcp.segmentstream.com/mcp

On first use, you’ll be prompted to authenticate via your browser.You can scope the server to your project or your user profile:

Flag	Scope	Config file
`-s project`	Shared with your team via `.mcp.json`	`.mcp.json` in project root
`-s user`	Personal, across all projects	`~/.claude/settings.json`
(default)	Local to this project	`.mcp.json` in project root

Open Settings → MCP and add a new server, or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "segmentstream": {
      "type": "http",
      "url": "https://mcp.segmentstream.com/mcp"
    }
  }
}

On first use, you’ll be prompted to authenticate via your browser. Restart Cursor to activate the connection.

Create or edit .vscode/mcp.json in your project root:

{
  "servers": {
    "segmentstream": {
      "type": "http",
      "url": "https://mcp.segmentstream.com/mcp"
    }
  }
}

On first use, you’ll be prompted to authenticate via your browser.

Open Settings, search for “MCP”, and add:

{
  "mcpServers": {
    "segmentstream": {
      "type": "http",
      "url": "https://mcp.segmentstream.com/mcp"
    }
  }
}

On first use, you’ll be prompted to authenticate via your browser.

Any MCP client that supports the Streamable HTTP transport can connect to SegmentStream MCP:

Setting	Value
Transport	Streamable HTTP
URL	`https://mcp.segmentstream.com/mcp`
Authentication	OAuth (automatic)

The server supports both Streamable HTTP and SSE transports.

Verify the connection

After setup, test that the connection works by asking your AI assistant:

List my SegmentStream projects

The assistant should call the list_active_projects tool and return a list of projects you have access to. If you see your projects, the connection is working.

Troubleshooting

Connection fails

Make sure your AI tool supports MCP and that you’ve restarted it after adding the server configuration.

Tools are not showing up

Some MCP clients need a restart after adding a new server. Close and reopen your AI tool, then try again.

OAuth popup doesn't appear

Next steps

Browse the supported tools to see everything you can do with SegmentStream MCP.

Project configuration

Dashboards

Attribution

Optimization

Geo Tests

MCP

Getting started

Prerequisites

Setup by tool

Verify the connection

Troubleshooting

Next steps

Getting started

Project configuration

Dashboards

Attribution

Optimization

Geo Tests

MCP

​Prerequisites

​Setup by tool

​Verify the connection

​Troubleshooting

​Next steps

Prerequisites

Setup by tool

Verify the connection

Troubleshooting

Next steps