Read-only first setup

MCP Setup Guide

Connect your AI assistant to Commish for commission visibility first. Keep write/admin tools disabled until an owner approves the workflow.

What You'll Need

A Commish account with a read-only API key (Settings → API Keys)
An MCP-compatible AI client (Claude Desktop, ChatGPT, Cursor, or VS Code)

Recommended

Quick Setup

No downloads, no dependencies — just paste a config snippet and restart your AI client.

Start with a read-only API key for evaluation. Store it in your AI client config only, never paste it into chats/screenshots, and add write or admin scopes only after an owner intentionally approves those actions.

🤖 Claude Desktop

1
Open your Claude Desktop config file:
macOS
Open Claude Desktop → menu bar → Claude → Settings → Developer → Edit Config
Manual file path →
1. Open Finder
2. Press Cmd+Shift+G (Go to Folder)
3. Paste: ~/Library/Application Support/Claude/
4. Open claude_desktop_config.json in any text editor
If the file doesn't exist, create it with: {}
Windows
Open Claude Desktop → ☰ Menu (top-left) → Settings → Developer → Edit Config
Manual file path →
1. Press Win+R to open the Run dialog
2. Paste: %APPDATA%\Claude and hit Enter
3. Open claude_desktop_config.json in Notepad or any text editor
If the file doesn't exist, create a new text file with that name containing: {}

Add the Commish server to mcpServers:

{
  "mcpServers": {
    "commish": {
      "url": "https://app.getcommish.io/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

3
Restart Claude Desktop.

Using the demo environment? Replace app.getcommish.io with demo.getcommish.io.

Power Users

Advanced Setup

Run the MCP server locally when you need custom control. Keep the API key in environment variables and use the smallest scope that supports the workflow.

Prerequisites

Automated Installer (Windows)

Run this one-liner in PowerShell, then choose option 2 (Advanced - Local Install) when prompted:

irm https://getcommish.io/install-mcp.ps1 | iex

Manual Install

Clone and build the MCP server:

git clone https://github.com/brandonpenrod/commish-mcp-server.git ~/commish-mcp-server
cd ~/commish-mcp-server
npm install
npm run build

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "commish": {
      "command": "node",
      "args": ["~/commish-mcp-server/dist/index.js"],
      "env": {
        "COMMISH_API_URL": "https://app.getcommish.io/api/v1",
        "COMMISH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3
Restart Claude Desktop after saving.

Example prompts

Things to Try

Once connected with a read-only key, try safe evaluation prompts like these:

“

List all comp plans in Commish

“

Show me this quarter's commission summary

“

List draft and approved deals for Acme Corp

“

What's my top performer's pipeline looking like?

“

What would Sarah earn on a $150K new business deal?

“

Model a SPIFF — $500 per new logo, capped at 5 per rep

“

Summarize a draft comp plan with a 3-month ramp, NRR as the primary metric, and 1.5x accelerator above 100% attainment

“

List current custom deal fields and suggest whether 'Contract Length' should be added

“

Review a proposed AE comp plan — $120K base, $80K variable, 70% ARR / 30% SQLs, $800K ARR quota, 2x annual accelerator

Troubleshooting

Common issues and how to fix them. Still stuck? Email [email protected]

Ready to Connect?

You're a config snippet away from read-only commission visibility. Jump back to the MCP overview, or create a scoped API key and get started safely.