MCP Server

What is MCP?

Model Context Protocol (MCP) is a standard that lets AI assistants call tools to access external data. Think of it as a plugin system for Claude.

The Himetrica MCP server gives Claude access to your analytics data. Once configured, you can ask questions like "How many visitors did I get this week?" and Claude will query your data and answer in natural language.

The MCP server is hosted by Himetrica — there's nothing to install or deploy. It calls the Read API under the hood. Connect it two ways: web apps like Claude.ai and ChatGPT sign in over OAuth (no key), while config-file clients (Claude Desktop, Claude Code, Cursor, Codex) use your secret key.

Setup

You need two things:

1. Your secret key from Project Settings (hm_sk_...)
2. A Starter plan or above

No install needed — the MCP server runs remotely on Himetrica's servers. Web connectors (Claude.ai, ChatGPT) skip the secret key entirely and authorize over OAuth — see below. Config-file clients use the secret key.

Claude.ai & ChatGPT (Web Connectors)

The web versions of Claude and ChatGPT connect to remote MCP servers over OAuth — no secret key, no config file. You paste one URL, sign in to Himetrica, approve access, and the connector is live. Use this connector URL:

https://app.himetrica.com/api/v1/mcp

Claude.ai

1. Go to Settings → Connectors and click Add custom connector.
2. Paste the connector URL above and click Add.
3. Click Connect — you'll be sent to Himetrica to sign in and Authorize access.
4. Done. Ask Claude about your analytics in any chat.

ChatGPT

1. Open Settings → Connectors (custom MCP connectors require enabling Developer mode under Settings → Connectors → Advanced).
2. Click Create / Add, give it a name (e.g. Himetrica), and paste the same connector URL.
3. Sign in to Himetrica and Authorize when prompted.
4. Enable the connector in the composer (+ menu) and ask away.

Claude Desktop

Open Claude Desktop settings and add an MCP server, or edit the config file directly:

{
  "mcpServers": {
    "himetrica": {
      "url": "https://app.himetrica.com/api/v1/mcp",
      "headers": {
        "X-API-Key": "hm_sk_your_secret_key"
      }
    }
  }
}

Replace hm_sk_your_secret_key with your actual secret key. Restart Claude Desktop to apply.

Claude Code

Add the MCP server with one command:

claude mcp add himetrica https://app.himetrica.com/api/v1/mcp \
  --transport http --header "X-API-Key: hm_sk_your_secret_key"

Codex CLI

OpenAI's Codex CLI does not have a codex mcp add command — you configure MCP servers by editing ~/.codex/config.toml directly. Append this block to the file:

[mcp_servers.himetrica]
url = "https://app.himetrica.com/api/v1/mcp"
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 60

[mcp_servers.himetrica.http_headers]
X-API-Key = "hm_sk_your_secret_key"

Replace hm_sk_your_secret_key with your actual secret key, then restart Codex. The longer timeouts give the remote MCP server room to respond on cold starts.

Cursor

Go to Cursor Settings > MCP and add a new server, or edit .cursor/mcp.json in your project:

{
  "mcpServers": {
    "himetrica": {
      "url": "https://app.himetrica.com/api/v1/mcp",
      "headers": {
        "X-API-Key": "hm_sk_your_secret_key"
      }
    }
  }
}

Several Projects

On the consent screen of Claude.ai, ChatGPT and other OAuth clients you can pick more than one project (or select all). The assistant then reaches all of them through one connection: every tool takes a projectId (the project's name, domain or id), andlist_projects lists them.

Name the project in your question ("how did the store do this week?") and the assistant picks it. If you don't, it asks which one instead of guessing, and every answer says which project it came from. Ask for a comparison and it queries each project in turn.

A secret key belongs to one project, so Claude Desktop, Claude Code, Codex and Cursor configs with a key reach that project only. Add one server per project (e.g.himetrica-store, himetrica-app), or connect over OAuth where the client supports it. Connections made before multi-project consent keep their single project; reconnect to pick more.

Available Tools

The MCP server exposes these tools that Claude can call:

Tools that read a period accept optional startDate and endDate parameters (default: the last 7 days). Claude will set these automatically based on your question.

Example Questions

Once configured, just ask Claude in natural language:

Claude figures out which tool to call, sets the right parameters, and answers with your actual data.