Skip to main content
Every client connects to the same endpoint:
The first time your client connects, it opens the Evermuse sign-in page in your browser. Sign in, choose the workspace the agent may access, and click Allow access. The client then handles tokens and refreshes automatically. For what happens during sign-in, see Authentication.
You can also find these instructions inside Evermuse under Settings → MCP, with the endpoint ready to copy.

Claude

1

Open connector settings

In Claude, open Settings → Connectors.
2

Add a custom connector

Click Add custom connector, name it Evermuse, and paste https://api.evermuse.com/api/mcp as the URL. Leave the advanced OAuth fields empty: Claude registers itself with Evermuse automatically.
3

Connect

Click Connect, sign in to Evermuse, choose your workspace and click Allow access.
4

Try it

Start a new chat, make sure Evermuse is enabled in the tools menu, and ask: “What are customers saying about onboarding?”
On Claude Team and Enterprise plans, an organization owner may need to add the connector for the organization before members can connect it. Connectors added on claude.ai are available in Claude Desktop and the Claude mobile apps.

ChatGPT

1

Open connector settings

In ChatGPT, open Settings → Apps & Connectors (called Connectors in some plans). Adding a custom connector is available on plans that support custom MCP connectors, such as Pro, Business and Enterprise. Depending on your plan, you may need to turn on Developer mode under Advanced settings first, and workspace admins may need to allow custom connectors.
2

Create the connector

Click Create (or Add custom connector), name it Evermuse, paste https://api.evermuse.com/api/mcp as the MCP server URL, and choose OAuth as the authentication method.
3

Sign in

Sign in to Evermuse, choose your workspace and click Allow access.
4

Use it in a chat

In a new chat, enable Evermuse from the tools menu and ask a product question.

Codex

Add Evermuse to ~/.codex/config.toml:
~/.codex/config.toml
Then sign in over OAuth:

Cursor

1

Add the server

Open Cursor Settings → MCP → Add new MCP server, or add Evermuse to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
mcp.json
2

Sign in

In the MCP settings, click Login (or Needs login) next to Evermuse and complete the sign-in in your browser.

VS Code

GitHub Copilot agent mode in VS Code supports remote MCP servers with OAuth. Add Evermuse to .vscode/mcp.json in your workspace, or to your user mcp.json with the MCP: Open User Configuration command:
.vscode/mcp.json
Start the server from the mcp.json editor or the MCP: List Servers command, and approve the sign-in prompt.

Other MCP clients

Any client that supports the Streamable HTTP transport and the MCP authorization specification works. Point it at the endpoint and authenticate when prompted. The client discovers everything else automatically:
  1. Its first request without a token receives 401 Unauthorized with a WWW-Authenticate header that points to https://api.evermuse.com/.well-known/oauth-protected-resource.
  2. That document names the authorization server, https://api.evermuse.com, whose metadata is at /.well-known/oauth-authorization-server.
  3. The client registers itself (usually through Dynamic Client Registration), runs the authorization code flow with PKCE, and calls the server with Authorization: Bearer <access_token>.
Full protocol details are in Authentication. For a client that only supports a fixed header and cannot run OAuth, use an API key instead:

Test with MCP Inspector

To explore the server interactively, run the official MCP Inspector:
Choose the Streamable HTTP transport, enter https://api.evermuse.com/api/mcp, and use Open Auth Settings → Quick OAuth Flow to sign in. Then list tools and call get_products to confirm the connection.

Verify the connection

Ask your agent: “Which Evermuse products can you see?” It should call get_products and list the products in the workspace you authorized. If it doesn’t, see Troubleshooting.

Switching workspaces

Each connection is bound to one workspace, chosen when you approve access. To use a different workspace, disconnect Evermuse in your client and connect again, choosing the other workspace on the consent screen. See Revoking access.