Both sign in with your Upsolve account (OAuth). There’s no API key to paste and
nothing else to configure: the assistant finds your organizations, projects and
workspaces itself.
Running Upsolve on your own machine? See Use Upsolve Local from Claude and
Codex: the same two servers, with no sign-in.
Connect
- Claude.ai and Claude Desktop
- Claude Code
- Cursor
- VS Code
- Codex
- Other clients
- Settings → Connectors → Add custom connector.
- Paste
https://mcp.upsolve.ai/mcp(orhttps://mcp.upsolve.ai/userfor Upsolve Analytics). - Sign in with your Upsolve account.
This page is about using Upsolve from an assistant. To give the
workspace’s own agent context from your other tools’ MCP servers, see MCP as
Context Source.
Ask
With either connector:Ask the way your users do
To see exactly what your end users get, add Upsolve Analytics with your own builder account. Every call then runs as your own project user, against the production version, with your own conversations, favorites and canvases. You can’t change a workspace from it. To answer as one of your customers instead, use the builder connector’s Playground (“ask the draft as the project user for Acme”). It runs any version as any project user and saves nothing to that user’s history.What you save is yours
Conversations, favorites and canvases made through either connector are saved to your own account and appear in the Upsolve Hub under the workspace, next to the ones you made there. Nobody else sees them. See Favorites and Canvas. Ask for a canvas in the same conversation as its charts. The workspace’s agent builds it: it lays the charts out two to a row and saves each one with its data, so the canvas shows them as soon as you open it. Charts you save to your favorites keep their data the same way.Roles
Data access is the same as in the Upsolve Hub: row-level security applies to
every answer.
Troubleshooting
The assistant says a tool is not available to your role
The assistant says a tool is not available to your role
End users can ask questions, save favorites and build canvases with either
connector. Building, testing and shipping a workspace is for owners,
admins and members.
The agent says the workspace has no published version
The agent says the workspace has no published version
Upsolve Analytics only answers from the production version. Save a
version of the workspace and promote it (with environments, deploy it to
Production from Deploy to…).
No workspaces are listed
No workspaces are listed
You can only ask a workspace with a production version, in a project you can
open. Ask a builder in your organization to promote one, or to give you access to
its project.
Sign-in fails or loops
Sign-in fails or loops
Remove the connector, add it again with the same URL, and sign in again.