Connect Your AI Tool

Step-by-step setup guides for connecting Claude Code, Claude Desktop, Cursor, VS Code, Codex, and Windsurf to Adsumo's MCP server.

Before You Start

Make sure you have a Starter plan or above.
Create an API key at Settings > API Keys.
Copy your full API key (it starts with adsumo_sk_). You'll need it for the config below.

The MCP server endpoint is:

text

https://www.adsumo.ai/api/mcp

Claude Code

Claude Code supports streamable HTTP MCP servers natively.

Add to your project's .mcp.json or global ~/.claude.json:

JSON

{
  "mcpServers": {
    "adsumo": {
      "type": "http",
      "url": "https://www.adsumo.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer adsumo_sk_your_key_here"
      }
    }
  }
}

Or add it via the CLI:

Bash

claude mcp add adsumo --transport http --url https://www.adsumo.ai/api/mcp --header "Authorization: Bearer adsumo_sk_your_key_here"

Claude Desktop

Claude Desktop uses stdio-based MCP servers. You'll need mcp-remote to bridge the HTTP connection.

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

JSON

{
  "mcpServers": {
    "adsumo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.adsumo.ai/api/mcp",
        "--header",
        "Authorization: Bearer adsumo_sk_your_key_here"
      ]
    }
  }
}

You need Node.js installed for npx to work. Restart Claude Desktop after updating the config.

Cursor

Add to .cursor/mcp.json in your project root:

JSON

{
  "mcpServers": {
    "adsumo": {
      "url": "https://www.adsumo.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer adsumo_sk_your_key_here"
      }
    }
  }
}

Cursor will detect the config automatically when you open the project.

VS Code Copilot

Add to .vscode/mcp.json in your project root:

JSON

{
  "servers": {
    "adsumo": {
      "type": "http",
      "url": "https://www.adsumo.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer adsumo_sk_your_key_here"
      }
    }
  }
}

Codex

Add to ~/.codex/config.toml:

toml

[mcp_servers.adsumo]
url = "https://www.adsumo.ai/api/mcp"
http_headers = { "Authorization" = "Bearer adsumo_sk_your_key_here" }

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

JSON

{
  "mcpServers": {
    "adsumo": {
      "serverUrl": "https://www.adsumo.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer adsumo_sk_your_key_here"
      }
    }
  }
}

Verifying the Connection

Once configured, ask your AI tool to run the get_credits tool. If the connection is working, it will return your team's credit balance:

JSON

{
  "credits_used": 45,
  "credits_limit": 300,
  "credits_remaining": 255
}

If you get an authentication error, double-check that:

Your API key is correct and not revoked
The Authorization header format is Bearer adsumo_sk_... (with the space after Bearer)
Your team has a Starter plan or above