Connect FC Qual to Claude to explore workspaces, find studies, read session transcripts, and create draft unmoderated studies — all using the same account and permissions as the FC Qual web app.
The FC Qual connector lets Claude work with your FC Qual research data on your behalf. After you sign in, Claude can call approved tools to:
| Capability | What you can ask |
| Account & workspaces | “What workspaces do I have access to?” |
| Workspace overview | “Summarize what’s in the Acme Research workspace.” |
| Study discovery | “List active studies in my Product team workspace.” / “Find onboarding studies across my workspaces.” |
| Study details | “Open the Mobile Checkout study and show objectives and participant count.” |
| Session transcripts | “Get transcripts for completed sessions in the Checkout Usability study.” |
| Response summaries | “Show task-level responses for the Beta Feedback study.” |
| Create studies | “Create a draft 15-minute unmoderated study about onboarding friction in the Design workspace.” |
Claude only sees data your FC Qual account is allowed to access. Permissions match the FC Qual web app — for example, Viewer can read studies and transcripts; Collaborator or higher is required to create studies.
Requirements
Before connecting, make sure you have:
- An active FC Qual account (same login as ux.fuelcylecore.com)
- Membership in at least one workspace with Viewer access or higher
- A Claude account (web at claude.ai or Claude Desktop)
- Your organization must have FC Qual enabled on the environment you use (contact your FC Qual admin if the connector is unavailable)
Connect FC Qual in Claude
Step 1 — Open connector settings
- In Claude, go to Settings → Connectors (or Integrations, depending on your Claude version).
- Choose Add custom connector (or Add connector).
Step 2 — Enter the MCP server URL
Use the MCP server URL for your FC Qual environment. Append /mcp to your organization’s FC Qual API host (with or without a trailing slash — both work):
| Environment | MCP server URL |
| Production | Ask your FC Qual administrator — typically https://udesk.fuelcyclecore.com/mcp |
Tip: Your API host is the same origin you use for FC Qual REST API calls and OAuth login, not necessarily the marketing or app shell URL. If unsure, contact your workspace admin or Fuel Cycle support.
Step 3 — OAuth settings
In Advanced settings:
| Field | Value |
| OAuth Client ID | udesk-mcp |
| OAuth Client Secret | (leave empty) |
FC Qual uses OAuth 2.1 with PKCE through Keycloak — the same identity provider as the FC Qual web app. No client secret is required.
Step 4 — Sign in and enable
- Click Save, then Connect.
- Sign in with your FC Qual email and password when the browser opens.
- Start a new chat, enable the FC Qual connector for that conversation, and try a prompt such as:
- What workspaces do I have access to?
If Claude lists your workspaces, the connection is working.
How authentication works
You (in Claude) → FC Qual server → Keycloak login → Your workspace data
- Claude reads FC Qual’s OAuth configuration from the MCP server.
- You authenticate once via the FC Qual / Keycloak login page.
- Claude sends your access token with each tool request.
- FC Qual validates the token and enforces your workspace role (Viewer, Collaborator, Admin, or Owner).
Your password is never shared with Claude. Tokens expire according to your organization’s Keycloak session policy; reconnect the connector if Claude reports an authentication error after a long idle period.
Available tools
Claude chooses tools automatically based on your question. You do not need to name them, but knowing what is available helps you write better prompts.
Discovery
| Tool | Description | Minimum role |
| get_current_user | Your email, name, and workspace memberships | Any authenticated user |
| list_workspaces | Paginated list of workspaces you can access (optional name search) | Any authenticated user |
Workspace & study exploration
| Tool | Description | Minimum role |
| get_workspace | Workspace details by name or ID (study count, status) | Viewer |
| get_workspace_context | Compact summary: active/demo study counts + 5 most recent studies | Viewer |
| list_studies | Paginated studies in one workspace (filters: name, code, status, type, active) | Viewer |
| search_studies | Search studies by name or code across all your workspaces | Viewer |
| get_study | Full details for one study (objectives, participant count, status, type) | Viewer |
Unmoderated research data
| Tool | Description | Minimum role |
| get_transcripts | Session transcripts for one unmoderated or AI-moderated study | Viewer |
| get_unmod_responses | Task-level response aggregates and session metrics for one study | Viewer |
Study creation
| Tool | Description | Minimum role |
| create_unmoderated_study | Create a draft unmoderated video study from a natural-language prompt | Collaborator |
Example prompts
Find your workspaces
List my FC Qual workspaces.
Explore a workspace
Give me a summary of the Product Research workspace — how many active studies are there?
List studies
Show active unmoderated studies in the Design workspace.
Search across workspaces
Find studies related to “checkout” across all my workspaces.
Study details
Open the Mobile App Usability study and tell me the objectives and how many participants completed.
Transcripts
Get transcripts for completed sessions in the Onboarding Flow study.
Responses
Show task responses and completion stats for the Beta Feedback study.
Create a study (Collaborator+ only)
In the Product Research workspace, create a draft 15–30 minute unmoderated study about how users discover pricing on our website. Include desktop and mobile.
Permissions & data access
| Workspace role | Read workspaces & studies | Read transcripts & responses | Create studies |
| Viewer | Yes | Yes | No |
| Collaborator | Yes | Yes | Yes |
| Admin / Owner | Yes | Yes | Yes |
- Tools only return data from workspaces where you are a member.
- create_unmoderated_study creates a draft study. Review and launch it in the FC Qual web app before recruiting participants.
- Transcript tools apply to unmoderated and AI-moderated studies only.
- Demo studies and archived sessions follow the same access rules as in the web app.
Troubleshooting
Connection & authentication
| Problem | What to try |
| “Authorization failed” or login loop | Confirm you use the same email/password as the FC Qual web app. Clear browser cookies for the auth domain and reconnect. |
| “Invalid redirect URI” | Your organization’s FC Qual admin must allow Claude callback URLs in Keycloak. Share this doc’s For administrators section with them. |
| Connector connects but tools fail with auth errors | Disconnect and reconnect the connector. Your session may have expired. |
| “Protected resource does not match” | Use /mcp or /mcp/ consistently. Try the alternate URL format, save, and reconnect. |
Tool errors
| Problem | What to try |
| “Workspace not found” | Check the workspace name spelling. Use list_workspaces or ask: “What workspaces do I have?” |
| “Forbidden” / permission denied | You need at least Viewer on that workspace. Ask your workspace admin to add you or upgrade your role. |
| “Study not found” | Provide the exact study name or recruit code. If the name exists in multiple workspaces, include the workspace name. |
| No transcripts returned | Transcripts exist only for completed sessions with finished transcription. Unmoderated/AI-moderated studies only. Processing can take time after a session ends. |
| Cannot create a study | You need Collaborator or higher. The tool creates a draft — finish setup in FC Qual before launching. |
| No tools appear in chat | Start a new conversation and ensure the FC Qual connector is enabled for that chat. |
Verify the service is reachable
If you are technical, these checks confirm FC Qual is up (run in Terminal):
# Replace {UDESK_HOST} with your API host (e.g. https://udesk.fuelcyclecore.com)# Should return "Pong" or similar curl -sS "https://{UDESK_HOST}/api/v2/ping"# Should return JSON with authorization_servers (not 404) curl -sS "https://{UDESK_HOST}/.well-known/oauth-protected-resource/mcp" # Should return 401 without a token (NOT 404) — means MCP endpoint exists curl -sS -o /dev/null -w "%{http_code}\n" -X POST "https://{UDESK_HOST}/mcp/" \-H "Content-Type: application/json" \-H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'
Privacy & security
- Same identity as FC Qual: OAuth through Keycloak; no separate MCP password.
- Workspace-scoped access: Every tool checks your role on the relevant workspace before returning data.
- Read vs write: Most tools are read-only. Only create_unmoderated_study writes data, and it creates drafts only.
- Token handling: Claude stores and sends your OAuth token to FC Qual on your behalf. Disconnect the connector to revoke Claude’s access to new requests (existing Keycloak sessions may remain until they expire).
- Data sent to Claude: Tool results (study names, transcripts, responses, etc.) are returned to Claude as part of your conversation. Do not use the connector for data your organization has not approved for AI tools.
For enterprise security questions, contact your FC Qual administrator or Fuel Cycle support.
Getting help
Self-serve checklist
Before contacting support, note:
- Claude product — Web (claude.ai) or Desktop?
- FC Qual account email — The email you used to sign in.
- Workspace and study names — If a specific tool failed.
- Exact error message — Copy the text from Claude, including any ofid_… or flow ID if shown.
- Your workspace role — Viewer, Collaborator, Admin, or Owner.
Contact support
| Channel | When to use |
| Workspace admin | Permission issues, missing workspaces, MCP not enabled for your org |
| Fuel Cycle / FC Qual support | Persistent auth failures, service outages, billing or account issues |
| Your IT / security team | Questions about using AI tools with research data |
Support email : support@fuelcycle.com
For administrators
If you manage FC Qual for your organization, ensure the following before users connect from Claude:
| Item | Detail |
| MCP deployed | FC Qual service with MCP enabled at /mcp |
| Keycloak client | Public OIDC client udesk-mcp in the FC Qual realm |
| Claude redirect URIs | https://claude.ai/api/mcp/auth_callback and https://claude.com/api/mcp/auth_callback |
| Config | MCP_OAUTH_ENABLED=true, MCP_PUBLIC_BASE_URL set to your public API host |
FAQ
Do I need a separate FC Qual account for Claude? No. Use the same credentials as the web app.
Does Claude store my research data? Tool results appear in your Claude conversation. Refer to Anthropic’s data policies for how Claude retains chat history. FC Qual does not send data to Claude except what you request via tools in that session.
Can I use this in Claude Desktop and Claude on the web? Yes. Add the connector in each client where you want to use FC Qual. OAuth settings are the same.
Why can I list studies but not create one? Creating studies requires Collaborator or higher on that workspace.
Can Claude moderate live sessions or recruit participants? Not in the current release. The connector focuses on discovery, transcripts, response summaries, and draft study creation. Launch recruitment and live sessions in the FC Qual web app.
What study types are supported for transcripts? Unmoderated and AI-moderated studies. Moderated and diary studies are not supported by the transcript tool today.
Last updated: June 2026 · FC Qual · Protocol: Streamable HTTP · OAuth