MCP Setup
How to add the Esperto MCP connector to Claude / Cowork.
What you need
- An Esperto MCP connector URL (Esperto provides this).
- A Claude/Cowork account that allows adding custom connectors.
How the connector URL works
Claude's custom-connector UI cannot send a bearer header, so the MCP endpoint is protected by an unguessable secret path segment instead. The connector URL looks like:
https://<esperto-mcp-host>/mcp/<secret-token>
The secret token is the part that authorises your access. Treat the full URL
like a password — anyone with it can reach the connector. A wrong or missing
token returns 404.
Add it in Cowork
- Open Cowork's connector settings and choose add a custom connector.
- Paste the connector URL Esperto gave you.
- Set authentication to none (the secret is already in the URL).
- Save. The Esperto tools load in a new chat started after the connector was added.
Verify it works
In a fresh chat, ask Claude to "list all Esperto groups." Claude should call
esperto_list_groups and return your groups. If nothing happens, start a new
chat (tools only load in sessions opened after the connector was added), and
check the connector URL is exactly as provided.
Security notes
- The connector inherits the same scopes as the underlying API client — it can only touch the endpoints Esperto has opened.
- If you believe the connector URL has leaked, contact us so the secret token can be rotated.
Need a connector URL or a rotation? Contact us.