Connecting your agent (MCP)

AgentLeverage exposes your organization's tools through a remote MCP server (Model Context Protocol). Once connected, an AI agent — Claude Code, Cursor, Claude Desktop, and others — can call your org's tools directly, scoped to your own session and organization.

Everything an agent does through this connection runs with your permissions in your organization. You never expose more than you could do yourself in the app.

Find your connection details

Your endpoint and copy-paste config are specific to your organization and are always available in the app:

Settings → Install MCP

That page shows your exact endpoint URL and a ready-to-copy config for each supported client. The endpoint looks like:

https://<your-app-domain>/api/mcp/mcp

Authentication

Connections authenticate with a bearer token sent as an Authorization header. Each client below shows where the token goes.

Claude Code

Claude Code connects to remote MCP servers natively. Add the server to your .mcp.json (project scope) or ~/.claude.json (user scope), then restart Claude Code:

{
  "mcpServers": {
    "agentleverage": {
      "type": "http",
      "url": "https://<your-app-domain>/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_AGENTLEVERAGE_TOKEN>"
      }
    }
  }
}

The "type": "http" field is required for remote servers.

Or install the plugin

AgentLeverage also ships a Claude Code plugin that bundles this server and prompts you for your token on install:

claude plugin marketplace add <your-marketplace-repo>
claude plugin install agentleverage@agentleverage-marketplace

Cursor

Add the server to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project). Set an AGENTLEVERAGE_TOKEN environment variable, then restart Cursor:

{
  "mcpServers": {
    "agentleverage": {
      "url": "https://<your-app-domain>/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer ${env:AGENTLEVERAGE_TOKEN}"
      }
    }
  }
}

Cursor auto-detects the transport from the URL — no type field is needed.

Claude Desktop

Claude Desktop doesn't connect to remote servers directly, so it uses the mcp-remote bridge. Add this to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/; Windows: %APPDATA%\Claude\), then fully quit and relaunch Claude Desktop:

{
  "mcpServers": {
    "agentleverage": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<your-app-domain>/api/mcp/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <YOUR_AGENTLEVERAGE_TOKEN>"
      }
    }
  }
}

ChatGPT

ChatGPT is not yet supported. ChatGPT's Developer-mode connectors require OAuth 2.1 and can't accept a static bearer token, so there's no way to paste your AgentLeverage credentials. Support is planned alongside upcoming OAuth work.

What your agent can do

Once connected, your agent sees your organization's tools in its tool list and can call them on your behalf — the same actions available to you in the app. If your organization proxies additional upstream MCP servers, those tools appear too, namespaced per server.

Admins can review and manage the full tool catalog under Settings → MCP servers.

Troubleshooting