Reference

AI assistant (MCP)

What it is

MCP (Model Context Protocol) is a standard way to give an AI assistant β€” Claude and other MCP clients β€” tools to work with your software. Orbitra ships an MCP server, so after a one-time connection you can simply write to the assistant:

"How did my campaigns do over the last 7 days? Which one lost money?"
"Show yesterday's conversions for the Keto DE campaign by country."
"Create 5 campaigns for offer #4 β€” one per GEO: DE, AT, CH, FR, IT β€” on the domain go.example.com."
"Add the domain promo.example.com and put campaign 12 on its root."
"Which creatives had ROI below zero this week?"

The assistant calls the tracker's API for you: it reads statistics, builds reports, creates and edits campaigns, offers, domains, traffic sources and landings (41 tools in total). It sees only what your API key allows.

Read key or write key?

Keys are made in βš™ β†’ Users β†’ the number in the API keys column of a user β†’ Read key or Write key.

Creating an API key
Creating an API key
KeyCan
ReadOnly look: metrics, lists, reports, conversions. Physically cannot change anything β€” safe to start with
WriteEverything Read can, plus create, edit and delete campaigns, offers, domains, sources, landings

Start with a Read key. If you ask a Read-key assistant to change something, it answers 403 API key is read-only β€” then create a Write key.

Works in the Claude apps (web, desktop, mobile), nothing to install.

  1. Create a key (see above) and press the link icon next to it β€” a ready URL like https://track.example.com/mcp.php?k=YOUR_KEY is copied.
  2. In Claude: Settings β†’ Connectors β†’ Add custom connector, paste the URL, give it a name (Orbitra), Add.
  3. In a new chat, ask "Ping my Orbitra tracker" β€” the assistant should answer with your tracker's version.

πŸ”‘ The key is inside the link, so treat the link like a password: do not post it anywhere. To cut access, delete the key β€” the link stops working immediately.

The page βš™ β†’ AI / MCP shows the same instructions with your tracker's address already filled in.

The AI / MCP page
The AI / MCP page

Connecting β€” option B: local server for Claude Desktop

For people who prefer to run the server on their own computer. You need Node.js and a copy of the Orbitra repository.

  1. In the repository: cd mcp && npm install.
  2. In Claude Desktop: Settings β†’ Developer β†’ Edit Config and add:
{
  "mcpServers": {
    "orbitra": {
      "command": "/usr/local/bin/node",
      "args": ["/absolute/path/to/Orbitra/mcp/src/index.js"],
      "env": {
        "ORBITRA_URL": "https://track.example.com",
        "ORBITRA_API_KEY": "your-api-key"
      }
    }
  }
}
  1. Quit Claude Desktop completely (⌘Q on Mac) and start it again.

The Copy config button in the API keys window gives you this block with your address. If the server does not appear: use the absolute path to node (which node shows it), check npm install ran, and check the key with ORBITRA_URL=… ORBITRA_API_KEY=… npm run smoke -- --ping.

Good prompts

Safety

Reference: MCP, REST API.

← Previous
Geo databases
Next β†’
Quick start: your first campaign
View source on GitHub: github.com/fenjo26/Orbitra.link/wiki
All guides
Reference

Metrics cheat sheet

Every report column in Orbitra with its formula: CR, CPC, CPA, ROI, ePC and more.

Read guide β†’
Reference

Glossary of abbreviations

Affiliate marketing terms and abbreviations explained in plain words.

Read guide β†’
Reference

Geo databases

Install Sypex Geo, MaxMind and IP2Location, and why better geo data improves cloaking.

Read guide β†’
Reference

AI assistant (MCP)

Connect Claude or another AI assistant to your tracker via MCP and manage it in plain words.

Read guide β†’