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.

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 the Amperity connector and log in to Claude.ai.

  2. Click Connect.

    If your organization has not enabled the Amperity connector, you will see a Request button instead. Click Request to notify your Claude admin. See Admin: enable the connector for your organization.

  3. Sign in with your Amperity OAuth credentials.

Admin: enable the connector for your organization

For Team and Enterprise plans, an Owner must enable the Amperity connector before members can connect to it.

  1. Open the Amperity connector and log in to Claude.ai as an Owner.

  2. Click Enable.

Members can now add the Amperity connector from the connector directory and sign in with their own Amperity OAuth credentials.

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

    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

Tip

The first time Claude uses an Amperity tool, Claude.ai asks you to approve the tool call. To stop being prompted, open Customize > Connectors, select the Amperity connector, find the tool in the tool list, and set it to Always allow. For example, if Claude is unable to start a session, allow the session_start tool this way.