What is MCP?
MCP (Model Context Protocol) is a standardized way for AI assistants to connect to external tools and data sources. Our MCP server lets AI agents search and retrieve your UserEvidence assets—testimonials, case studies, stats, and more—directly within your AI workflows.
Prerequisites
An active UserEvidence account
An MCP-compatible client (Claude web app, Claude Desktop, or custom agent)
Quick Reference
MCP Endpoint | |
Transport | SSE (Server-Sent Events) |
Authentication | OAuth 2.0 (automatic browser flow) |
Option 1: Claude Web App (claude.ai)
Recommended for most users. The fastest way to get started—no configuration files needed.
Steps
Go to claude.ai and sign in
Click your profile icon in the bottom-left corner
Select Settings
Click Connectors in the left sidebar
Click Add More Integrations
Enter the UserEvidence MCP server URL:
https://app.userevidence.com/mcp?audience=customer
Click Add
A browser window will open—sign in with your UserEvidence credential
Once authenticated, UserEvidence tools will appear in your Claude conversations
Tip: You can verify the integration is active by starting a new chat and asking Claude to search for testimonials. You should see UserEvidence tools being invoked.
Option 2: Claude Desktop App
For users who prefer the desktop application. Requires editing a configuration file.
Steps
Open Claude Desktop
Go to Settings → Connectors → Add custom connector
Fill in the following details:
Name: UserEvidence
Remote MCP Server URL: https://app.userevidence.com/mcp?audience=customer
4. Click “Add”.
Option 3: Custom Agents, Frameworks, Other MCP Clients
The UserEvidence MCP server works with any MCP-compatible client or agent framework, not just Claude. If your AI tool supports remote MCP servers, you can connect it using the details below.
What you'll need
MCP Server URL
https://app.userevidence.com/mcp?audience=customerTransportSSE (Server-Sent Events)
AuthenticationOAuth 2.0 (browser-based sign-in)
An active UserEvidence login
Steps
The exact wording varies by client, but the flow is the same everywhere:
Find where your client adds MCP servers or connectors. This is usually under a Settings, Integrations, Connectors, or Tools menu. Frameworks and CLI-based tools typically use a config file instead (often
mcpServersin a JSON or YAML file).Add a new custom/remote MCP server and give it a name (e.g.,
UserEvidence).Enter the MCP Server URL above as the endpoint, and select SSE as the transport if your client asks.
Save, then authenticate. A browser window opens for OAuth — sign in with your UserEvidence credentials to authorize the connection.
Confirm the tools loaded. Start a new session and check that the UserEvidence tools appear (many clients have a tools/connectors indicator, or a command like
/mcpto list them).
Config-file example:
For clients or frameworks that use a configuration file rather than a UI, the entry generally looks like this:
json
{
"mcpServers": {
"userevidence": {
"url":
"https://app.userevidence.com/mcp?audience=customer",
"transport": "sse"
}
}
}
If your tool manages OAuth tokens manually, complete the authorization flow once, store the returned token, and pass it as a Bearer token on later connections — re-authenticating when it expires.
Example Prompts
Once connected, try asking:
"Find testimonials from enterprise customers about ROI"
"Show me case studies from healthcare companies"
"What proof points do we have about implementation speed?"
"Find a customer quote for a prospect in financial services"
Troubleshooting
Integration not appearing in Claude
Refresh the page or restart the app. Check Settings → Integrations to verify UserEvidence is listed and enabled.
OAuth popup doesn't appear
Check your browser's popup blocker. The OAuth flow requires a popup window to complete authentication.
Connection times out
Verify your network allows outbound connections to mcp.userevidence.com on port 443.
"Unauthorized" errors
Your OAuth token may have expired. Remove and re-add the integration to re-authenticate.
Tools not being invoked
Start a new conversation after adding the integration. Explicitly ask Claude to search UserEvidence to confirm the connection.
Need Help?
Contact us at [email protected] with your setup details and any error messages. We're happy to help get you connected.