Install

Pick your AI client below for the install snippet. Every snippet bakes in the client identifier so PromptOT can attribute usage correctly in the admin dashboard — make sure to copy the snippet from this page rather than writing one from scratch.

Before you start

Open your dashboard, go to any project's API Keys page, and click Generate MCP Key in the MCP Server card at the top.
(Optional) Tick Allow AI features if you want playground, evaluations, AI rewrites, prompt imports, or the co-pilot to be callable from your AI assistant. Each call consumes one AI credit from your billing pool.
Copy the raw key shown in the green box — it's only displayed once.
Make sure you have Node.js 20+ installed for stdio clients (Claude Desktop, Cursor, etc). The npx command needs it. Browser-based clients like claude.ai and ChatGPT skip this step.

Claude Desktop

Anthropic · stdio

Add the snippet below to your claude_desktop_config.json and restart Claude Desktop. The PromptOT tools will appear in the @ menu and the model will use them automatically when you ask.

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

claude-desktop.json

{
  "mcpServers": {
    "promptot": {
      "command": "npx",
      "args": [
        "-y",
        "@prompt-ot/mcp"
      ],
      "env": {
        "PROMPTOT_API_KEY": "pot_YOUR_KEY_HERE",
        "PROMPTOT_MCP_CLIENT": "claude-desktop"
      }
    }
  }
}

Replace pot_YOUR_KEY_HERE with the key you copied from the dashboard, save the file, and restart Claude Desktop. The PromptOT tools will appear automatically.

Cursor

Anysphere · stdio

Add the snippet to your global Cursor MCP config (or `.cursor/mcp.json` in a workspace), then restart Cursor. Tools become available in the chat sidebar.

Config file: ~/.cursor/mcp.json

cursor.json

{
  "mcpServers": {
    "promptot": {
      "command": "npx",
      "args": [
        "-y",
        "@prompt-ot/mcp"
      ],
      "env": {
        "PROMPTOT_API_KEY": "pot_YOUR_KEY_HERE",
        "PROMPTOT_MCP_CLIENT": "cursor"
      }
    }
  }
}

Replace pot_YOUR_KEY_HERE with the key you copied from the dashboard, save the file, and restart Cursor. The PromptOT tools will appear automatically.

Codex CLI

OpenAI · stdio

Add the snippet to your Codex CLI config (TOML format). The tools are available immediately on the next `codex` command.

Config file: ~/.codex/config.toml

codex-cli.toml

[mcp_servers.promptot]
command = "npx"
args = ["-y", "@prompt-ot/mcp"]
env = { PROMPTOT_API_KEY = "pot_YOUR_KEY_HERE", PROMPTOT_MCP_CLIENT = "codex-cli" }

Replace pot_YOUR_KEY_HERE with the key you copied from the dashboard, save the file, and restart Codex CLI. The PromptOT tools will appear automatically.

Windsurf

Codeium · stdio

Add the snippet to your Windsurf MCP config and restart the editor.

Config file: ~/.codeium/windsurf/mcp_config.json

windsurf.json

{
  "mcpServers": {
    "promptot": {
      "command": "npx",
      "args": [
        "-y",
        "@prompt-ot/mcp"
      ],
      "env": {
        "PROMPTOT_API_KEY": "pot_YOUR_KEY_HERE",
        "PROMPTOT_MCP_CLIENT": "windsurf"
      }
    }
  }
}

Replace pot_YOUR_KEY_HERE with the key you copied from the dashboard, save the file, and restart Windsurf. The PromptOT tools will appear automatically.

Zed

Zed Industries · stdio

Zed reads MCP servers from its settings.json under `context_servers`. Add the snippet there.

Config file: ~/.config/zed/settings.json

zed.json

{
  "context_servers": {
    "promptot": {
      "command": "npx",
      "args": [
        "-y",
        "@prompt-ot/mcp"
      ],
      "env": {
        "PROMPTOT_API_KEY": "pot_YOUR_KEY_HERE",
        "PROMPTOT_MCP_CLIENT": "zed"
      }
    }
  }
}

Replace pot_YOUR_KEY_HERE with the key you copied from the dashboard, save the file, and restart Zed. The PromptOT tools will appear automatically.

claude.ai

Anthropic · http

claude.ai connects via OAuth — no config file needed. Open your workspace settings, add the PromptOT MCP server URL, then sign in with PromptOT when prompted.

claude-ai.text

URL: https://mcp.promptot.com/mcp
Authentication: OAuth (sign in with PromptOT when prompted)

In claude.ai settings, add a new MCP server with the URL above.
When you connect, you'll be redirected to PromptOT to choose which
project to grant access to.

claude.ai authenticates via OAuth, so you never paste a raw API key here. When you connect from claude.ai, you'll be redirected to PromptOT to choose which project to grant access to. See the OAuth flow docs for details.

ChatGPT

OpenAI · http

ChatGPT desktop and the web app connect via OAuth. Add the PromptOT MCP URL in your custom GPT or workspace settings and sign in with PromptOT.

chatgpt.text

URL: https://mcp.promptot.com/mcp
Authentication: OAuth (sign in with PromptOT when prompted)

In ChatGPT settings, add a new MCP server with the URL above.
When you connect, you'll be redirected to PromptOT to choose which
project to grant access to.

ChatGPT authenticates via OAuth, so you never paste a raw API key here. When you connect from ChatGPT, you'll be redirected to PromptOT to choose which project to grant access to. See the OAuth flow docs for details.

Generic stdio client

any · stdio

Any MCP client that supports the stdio transport works. Run `npx -y @prompt-ot/mcp` with PROMPTOT_API_KEY set in the environment.

generic.json

{
  "mcpServers": {
    "promptot": {
      "command": "npx",
      "args": [
        "-y",
        "@prompt-ot/mcp"
      ],
      "env": {
        "PROMPTOT_API_KEY": "pot_YOUR_KEY_HERE",
        "PROMPTOT_MCP_CLIENT": "generic"
      }
    }
  }
}

Replace pot_YOUR_KEY_HERE with the key you copied from the dashboard, save the file, and restart Generic stdio client. The PromptOT tools will appear automatically.

Verify the install

After restarting your client, start a new conversation and ask:

prompt

List my PromptOT prompts.

The model should call the list_prompts tool and return a list of prompts in the project the MCP key is scoped to. If you see "no tools available" or an error, see the troubleshooting guide.

Don't commit your MCP key to git. The snippet contains a raw bearer token. If you accidentally pushed it to a public repo, revoke it immediately from the dashboard and generate a new one.

Tools reference Troubleshooting