How do I connect Fiuto to Claude Code?
Add Fiuto to Claude Code as a remote MCP server, then sign in through the browser. Once connected, Claude Code can use the Fiuto capabilities available to it, including authoring, launching, and reading studies.
What you’ll need
Section titled “What you’ll need”- A Fiuto account. Sign up at app.fiuto.ai if you don’t have one.
- Claude Code installed and signed in. If you’re new to it, the Claude Code docs cover installation.
- A terminal open.
Connect Fiuto
Section titled “Connect Fiuto”-
Add the server. In any terminal, run:
Terminal window claude mcp add --transport http fiuto https://mcp.fiuto.ai/mcp-serverThat registers Fiuto as a remote MCP server in your Claude Code config. The name
fiutois what you’ll see when you list servers later. If you already have a server calledfiuto, pick a different name; the command shape is the same. -
Sign in. Open Claude Code in any project, type
/mcp, and pickfiutofrom the list. Claude Code opens a browser tab to sign in to your Fiuto account. Use the same email you use at app.fiuto.ai, then approve the connection.If the browser tab doesn’t open on its own (some terminals block automatic launches), Claude Code prints a URL you can paste into a browser by hand.
Check it worked
Section titled “Check it worked”Back in Claude Code, type /mcp again. You should see fiuto listed as connected, with a count of available tools alongside.
For a live check, ask Claude Code something basic:
“List my Fiuto studies.”
If the connection is good, it returns your studies, or tells you the list is empty if you haven’t made any yet.
What you can ask Claude Code to do
Section titled “What you can ask Claude Code to do”Once connected, Claude Code does the same kinds of things you’d do in the web editor. A few to get a feel:
- “Create a five-question rating study about the new sign-up flow.”
- “Build a preference test between these two pricing-page screenshots, then ask for a one-line reason after each pick.”
- “Show me my draft studies, and tell me which one is closest to ready.”
- “Add a screening question at the start of this study so only designers can take it.”
- “Launch the onboarding click-test study, and share the link.”
- “Pull the results from my latest study and summarise what people said.”
You don’t need to know what the underlying tools are called. Claude Code translates your request into the right Fiuto actions on its own.
Troubleshooting
Section titled “Troubleshooting”A few patterns we see when the connection doesn’t behave.
/mcpdoesn’t listfiuto. The add command didn’t persist, or Claude Code is reading a different config. Run the add command again, then restart Claude Code.- Sign-in opens but never completes. Finish the browser flow before closing the tab. Rerun
/mcpand pickfiutoto retry. - The browser didn’t open. Some terminals block automatic launches. Copy the URL from Claude Code’s output and paste it into a browser by hand.
- You signed in with the wrong account. Run
claude mcp remove fiuto, add it again, and sign in with the right Fiuto account. - Claude Code can’t reach Fiuto mid-session. The connection may have dropped (network change, sleep). Type
/mcpand reconnect.
Still stuck? Write to help@fiuto.ai with what you tried and what the error looks like.