Set up Claude

Connect Claude to the Amperity MCP server through Claude.ai, which also makes the MCP server available in Claude Desktop and Claude mobile apps, or through Claude Code.

Requirements

Connecting Claude to the MCP server requires:

• An active Amperity account with access to at least one tenant.

• Access to a Claude account–Pro, Max, Team, or Enterprise–or access to Claude Code.

• The URL for your tenant’s MCP server endpoint.

Claude.ai

Claude.ai is the canonical location to add remote MCP connectors. Once added, the connector is also available in Claude Desktop and Claude mobile apps signed into the same account.

1. Open Claude.ai and log in.

2. Open the Connectors page for your plan:

   For Pro or Max plans in Claude.ai, open Customize, select Connectors, and then click + or Add custom connector.

   For Team or Enterprise plans, as the organization Owner only, open Organization settings, select Connectors, click Add, hover over Custom, then select Web.

3. For Remote MCP server URL enter:

   https://mcp.amperity.com
   

   Important

   Use the correct MCP server URL for this setting.

   Use nwbd0MGCyh1VysmYQM05UoDXIuVPdGEs as the OAuth client ID.

4. Click Add. A browser tab opens. Sign in with your Amperity OAuth credentials.

   For Team or Enterprise plans open Customize, select Connectors, and then click Connect for the Amperity connector.

Claude Code

Configure the Amperity MCP server for Claude Code.

1. Open Claude Code.

2. Add the Amperity MCP server:

   claude mcp add --transport http --scope user amperity https://mcp.amperity.com
   

   Important

   Use the correct MCP server URL in the command.

   The server is registered in your user-scoped Claude configuration and is available in every Claude Code session.

3. To verify the server is registered with Claude Code:

   claude mcp list
   

   The Amperity entry appears with a status of Needs authentication or Connected.

   Note

   The first time Claude Code calls an Amperity tool a browser tab opens for OAuth. Sign in with your Amperity credentials, after which the registration status is set to Connected.

Start interacting with Claude

Open a Claude conversation and ask:

"Tell me about my Amperity tenant."

Claude calls the tenant_info tool and return details about your current Amperity tenant.

Tip

If you see an authorization error, remove the server and add it again to force the OAuth flow.

claude mcp remove amperity

claude mcp add --transport http --scope user amperity https://mcp.amperity.com

.. important:: Use the :ref:`correct MCP server URL <mcp-overview-mcp-urls>` in the command.