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

# Introduction

> Clickbase ships a built-in MCP (Model Context Protocol) integration that lets AI agents — Claude Code, Claude Desktop, Cursor, VS Code, or any other MCP client

Clickbase ships a built-in [MCP (Model Context Protocol)](https://modelcontextprotocol.io) integration that lets AI agents — Claude Code, Claude Desktop, Cursor, VS Code, or any other MCP client — work with your analytics directly. Instead of copying numbers out of the dashboard or scripting the REST API by hand, you can just ask: "What was my conversion rate last week?" or "Create a goal for signups on the pricing page."

## What is MCP?

MCP is an open protocol that connects AI assistants to external tools and data sources. An MCP server exposes a set of typed tools an agent can call; the agent decides which tool to call and with what arguments based on your natural-language request.

## What your agent can do

Clickbase exposes two MCP servers, split by what they do rather than by a token scope:

* The **[Reader](/ai/reader)** server is read-only — analytics, sessions and journeys, events and errors, realtime, people, revenue, Stripe status, Search Console and annotations. Safe to connect to a reporting or Q\&A agent.
* The **[Writer](/ai/writer)** server mutates data — site CRUD and config, goals and funnels, annotations, tracking toggles, session-replay deletion and the Stripe integration.

Both servers call the exact same server-side Actions and Resources as the dashboard and the [REST API](/api/overview), so a number your agent reports is the same number the dashboard shows. See the [Connectors](/ai/overview) page for the full auth and tenancy model.

## How it works

1. **Get an API token.** Create one from the Developers settings page, or over the API — see [API tokens](/api/tokens).
2. **Add the server to your client.** Point your MCP client at `https://clickbase.so/mcp/reader` and/or `https://clickbase.so/mcp/writer`, then complete the OAuth authorization in your browser.
3. **Ask in natural language.** "List my sites", "What's my bounce rate this month?", "Create a goal for the checkout page" — your agent picks the right tool.

## Connect your client

* [Claude Code](/ai/claude-code) — Anthropic's CLI coding assistant.
* [Cursor](/ai/cursor) — AI-powered code editor.
* [VS Code](/ai/vs-code) — Visual Studio Code with an MCP-compatible extension.
* [Claude Desktop](/ai/claude-desktop) — Anthropic's desktop chat app.

Once connected, read the [Connectors](/ai/overview) page for the two-server model and authentication details, or jump straight to the [Reader tools](/ai/reader) and [Writer tools](/ai/writer) references.
