Quickstart: Claude

Connect the hosted SuprSend MCP server to Claude Code, Claude Desktop, or Claude.ai. Sign in with your SuprSend account; no service token needed.

Set up the connection

Claude Code

1. Add the SuprSend MCP server

   From your regular terminal (not inside a running claude session):

   claude mcp add --transport http suprsend https://mcp.suprsend.com/mcp
   
2. Sign in with your SuprSend account

   On first connect, Claude Code opens your browser. Sign in with your SuprSend account. The agent gets the same permissions your role has in the SuprSend dashboard.

3. Verify the connection

   Start claude and ask:

   List my SuprSend workspaces.
   

   Claude answers with your SuprSend workspaces.

Claude Desktop / Claude.ai

1. Open the connectors settings

   In Claude Desktop or at claude.ai, go to Settings → Connectors. On Team and Enterprise plans, an owner may need to allow the connector first.

2. Add a custom connector

   1. Click Add → Add custom connector.
   2. Paste https://mcp.suprsend.com/mcp as the URL.
   3. Save.
3. Sign in with your SuprSend account

   Claude prompts a browser sign-in on the first tool call. Sign in with your SuprSend account. The agent gets the same permissions your role has in the SuprSend dashboard.

4. Verify the connection

   In a new conversation, ask:

   List my SuprSend workspaces.
   

   Claude answers with your SuprSend workspaces.

Pin a workspace and restrict tools

By default, Claude can use every workspace and tool your role allows. To keep it on one workspace, or to give it only the tools a job needs, change the URL when you add the server:

• Pin a workspace by adding its slug to the path. The agent then can’t switch to another workspace:

  claude mcp add --transport http suprsend https://mcp.suprsend.com/mcp/staging
  

• Restrict tools with ?tools=, a comma-separated list of tool names or groups:

  claude mcp add --transport http suprsend https://mcp.suprsend.com/mcp/staging?tools=users_*,data_*
  

See Scope the connection for every URL pattern, and the tool list for every tool.

Troubleshooting

OAuth sign-in loop

If the browser keeps redirecting without completing sign-in, close every Claude window, clear your SuprSend session at app.suprsend.com, and reconnect. For Claude Code, run claude mcp remove suprsend and re-add the server.

Server shows disconnected

Check the workspace slug in the URL. It must match a workspace in your SuprSend account exactly, for example staging, not the workspace’s display name. A slug that doesn’t exist fails with 403 workspace_forbidden. To see your slugs, re-add the server without a slug and ask: “List my SuprSend workspaces.”

Tools icon missing after restart on Claude Desktop

Fully quit the app (⌘Q on macOS, Quit from the tray on Windows) and reopen it. Custom connectors only reload on a full restart; closing the window isn’t enough.

Tool list

Every tool, grouped by category, with read vs write labels.

Prompt cheatsheet

Ready-to-use prompts to get started fast.