Getting Started with STQRY Studio Connect

Created by Natalie Nguyen, Modified on Wed, 11 Nov at 8:49 PM by Natalie Nguyen

STQRY Studio Connect links your STQRY content to AI agents. You can upload content, create tours, and manage your projects by describing what you need. It works with Claude by Anthropic, Codex by OpenAI, and Meta Muse by Meta.

What can you do with STQRY Studio Connect?

  • Upload images in bulk: point the AI agent at a folder of photos and have them added to your project
  • Create tours from a description: tell the AI agent what your tour is about and it will generate stops, descriptions, and structure
  • Manage content at scale: list, update, or organize screens, collections, and media items across your project
  • Generate access codes: create and manage codes for locking content

Choose how to connect

There are two ways to connect an AI agent to STQRY.

Way to connect Works with You need
STQRY connector Claude on the web, Claude Desktop and Claude Code Your STQRY Builder login
STQRY Studio CLI Claude Code, Codex and Meta Muse A STQRY API key

We recommend the STQRY connector if you use Claude. There's no API key to look after, and you choose which accounts Claude can use. Use the STQRY Studio CLI for scripts and scheduled jobs, or for an AI agent other than Claude.

Connect Claude with the STQRY connector

The STQRY connector lets Claude work in your STQRY accounts after you sign in with your usual Builder login. You connect once, and the connection covers both claude.ai and Claude Desktop.

You'll need:

  • A Builder login. Any Builder user can connect, not only an Account Admin.
  • A Claude account. Sign up at claude.ai. A paid plan gives the best experience.

Step 1: Add the STQRY connector

  1. Go to claude.ai, sign in, and click Customize in the sidebar.
  2. Click Connectors, then Add, then Add custom connector.

The Connectors tab in claude.ai with the Add menu open and Add custom connector highlighted

  1. In Name, enter STQRY. In MCP server URL, paste this address:
https://mcp.stqry.com/mcp

The Add custom connector dialog with STQRY as the name and the STQRY server address filled in

  1. Click Continue. Claude detects the right sign-in settings, so leave them as they are and click Add.

Step 2: Sign in and choose what Claude can use

  1. On the STQRY connector page, click Connect. Builder opens in a new page and asks you to sign in if you aren't already.
  2. Check what Claude will be able to do. To let Claude view your content without changing it, turn on Read-only access.
  3. Under Accounts Claude may use, untick any account you want to keep out. In each account you leave ticked, Claude can do what you can.
  4. Click Connect. You're sent back to claude.ai, which shows Connected to STQRY.

The STQRY Connect Claude page listing what Claude will be able to do, with the Read-only access switch

To include accounts you're added to in future, turn on All my accounts, including ones I get later.

Step 3: Start using Claude with your content

Start a new chat in claude.ai or Claude Desktop and ask Claude in plain language. For example:

"Using STQRY, list the projects in my account and tell me how many screens each one has"

Claude asks before it uses STQRY. Click Allow once to approve one action, or Always allow for actions you're happy for it to take without asking.

Claude asking for permission to use List STQRY accounts from the STQRY connector, with Allow once and Always allow buttons

To stop Claude asking each time, switch the permission mode under the message box from Manual to Auto. Claude then works on its own and only pauses if something looks unsafe.

The permission mode menu under the claude.ai message box, with Manual and Auto options

Claude's answer listing the projects in a STQRY account with the number of screens in each

Work with your files

Claude can upload images and other files to your STQRY account. The first time, Claude installs the STQRY Studio CLI by itself, then sends each file straight to STQRY.

Claude needs internet access to do this. You set it once, and it applies to both claude.ai and Claude Desktop.

  1. In claude.ai, open Settings, then Capabilities.
  2. Turn on Create and edit files and Use the internet while making files.
  3. Check Allowed websites shows Any website.

Claude's Capabilities settings with Create and edit files and Use the internet while making files turned on

On a Claude Team plan, only people who manage your Claude organization can change these settings.

If you'd rather not allow every website, choose Standard download sites only, then add the storage address for your region.

Region Storage address
United States stqry-us-uploads-production.s3.us-west-2.amazonaws.com
Canada stqry-ca-uploads-production.s3.ca-central-1.amazonaws.com
Europe stqry-eu-uploads-production.s3.eu-central-1.amazonaws.com
Singapore stqry-sg-uploads-production.s3.ap-southeast-1.amazonaws.com
Australia stqry-au-uploads-production.s3.ap-southeast-2.amazonaws.com

In Claude Desktop, click Project or folder, then Add folder, and choose the folder that holds your files. Then ask Claude to upload them. Claude Desktop is the best fit for a folder of photos or other media.

"Upload all the photos in this folder to STQRY as image media items"
"Using STQRY, create a tour from the photos in this folder, with one stop per photo"

In claude.ai, attach your files to the chat and ask Claude to upload them.

If Claude can't get online, it gives you a command to run in your own terminal instead. Tell Claude once it has run, and Claude finishes the upload.

Use the connector in Claude Code

Claude Code can use the same STQRY connector from your terminal.

If you signed in to Claude Code with your Claude account, the connector you added in claude.ai is already there. Run /mcp in Claude Code to check that STQRY is in the list.

Otherwise, add it yourself:

claude mcp add --transport http --scope user stqry https://mcp.stqry.com/mcp

Then run /mcp in Claude Code, choose stqry, and follow the sign-in steps in your browser. Builder shows the same page as in Step 2. A connection you add this way is listed as Claude Code in Builder, separately from Claude.

Change what Claude can use

You can change a connection's accounts and access at any time, without connecting again.

  1. In Builder, open your profile and go to Connected apps.
  2. Next to Claude, click Change access.
  3. Tick or untick accounts, or switch Read-only access on or off.
  4. Click Save changes.

Claude also gives you a link to this page when it needs an account or access it doesn't have. Check what it asked for, click Save changes, then tell Claude you've saved it.

Disconnect Claude

To disconnect Claude, open your profile in Builder, go to Connected apps, and click Disconnect. Claude is signed out of your accounts at once, and you can connect it again later.

Removing the STQRY connector in claude.ai doesn't disconnect it in STQRY. Claude stays listed under Connected apps until you click Disconnect there.

Troubleshooting

What you see What to do
Claude asks you to connect or sign in again The connection was disconnected, or it wasn't used for 90 days. Click Connect and sign in again.
Claude can't find one of your accounts Open Connected apps, click Change access, and tick the account. If it isn't in the list, ask an Account Admin to add you to that account as a Builder user.
Claude can view your content but can't change it Open Change access and turn off Read-only access.
Claude says your role doesn't allow something Claude can only do what you can in each account. Ask an Account Admin of that account to change your role.
"This link has expired" when you connect A connection link works once, for ten minutes. Start the connection again from Claude.
Claude gives you an upload command instead of uploading Claude couldn't get online. Run the command in your own terminal and tell Claude when it has finished.

Use the STQRY Studio CLI with an API key

The STQRY Studio CLI is a command-line tool that an AI agent runs for you, signed in with a STQRY API key. An API key works without anyone signing in, so this is the way to connect scripts and scheduled jobs.

You'll need:

  • A STQRY account with Account Admin access
  • A STQRY API key: see How to Generate a STQRY API Key. You can create multiple API keys for different purposes. For example, one key for content uploads and another for access code management.
  • A Claude, OpenAI or Meta account, depending on the AI agent you use

Claude Code

Claude Code is a command-line tool for developers and power users. This method requires familiarity with a terminal (macOS/Linux/Windows Subsystem for Linux).

Step 1: Install Claude Code

  1. Visit the Claude Code quickstart guide
  2. Copy and paste the installation command for your operating system into your terminal.
  3. Run claude and follow the prompts to log in to your Claude account.
claude
  1. Exit your terminal.

Step 2: Install STQRY Studio CLI

  1. Open your terminal and run:
curl -fsSL https://downloads.stqry.com/stqry-cli/install.sh | sh
  1. Then run:
stqry setup claude
  1. Exit your terminal. STQRY Studio CLI is now ready to be used in Claude Code.

Step 3: Set up your STQRY Project

First, choose a project name. This can match your existing project name or be any name you like. It must be alphanumeric with no special characters (hyphens are allowed). Pick something short and easy to remember so you can navigate to it quickly.

  1. Open your terminal and create a project folder:
mkdir <project_name>
cd <project_name>
claude
  1. Tell Claude to initialize your STQRY Account:
"Init a STQRY Account with API Key <api_key>"

Step 4: Start using Claude with your content

Navigate to your project folder and launch Claude:

cd <project_name>
claude

Then give Claude instructions in plain language:

"List 10 screens in this STQRY Project"
"Upload all images in ~/Downloads/tour-photos/ into this STQRY Project"

Updating STQRY Studio CLI: To update to the latest version, run:

stqry update

Codex

Codex is OpenAI's AI agent, available as a desktop app and a command-line tool. It uses the same STQRY Studio CLI as Claude Code, and a one-time terminal step installs it.

Step 1: Install Codex

  1. Install Codex (the desktop app or the CLI) and sign in to your OpenAI account. See OpenAI’s Codex documentation for the download.

Step 2: Install STQRY Studio CLI

  1. On macOS or Linux, open your terminal and run:
curl -fsSL https://downloads.stqry.com/stqry-cli/install.sh | sh

On Windows, open PowerShell and run the command below, then open a new PowerShell window:

powershell -c "irm https://downloads.stqry.com/stqry-cli/install.ps1|iex"
  1. Then run:
stqry setup codex
  1. Restart Codex. STQRY Studio CLI is now ready to be used in Codex.

Step 3: Connect your STQRY Project

Tell Codex your API key to connect to your project:

"Use STQRY with API Key <api_key>"

Step 4: Start using Codex with your content

Give Codex instructions in plain language:

"List 10 screens in this STQRY Project"
"Upload all images in ~/Downloads/tour-photos/ into this STQRY Project"

Updating STQRY Studio CLI: To update to the latest version, run:

stqry update

Meta Muse

Meta Muse is Meta's personal AI agent. Setup is simple. It takes one message.

Step 1: Install Meta Muse

  1. Download Meta Muse on iOS or Android.
  2. Sign in with your Meta account.

Step 2: Connect your STQRY Project

Send Muse the following message with your API key:

"Please connect my STQRY account. Pip install stqry. API Key: <your_api_key>"

Muse will install the STQRY CLI, verify your key, and confirm the connection. You're ready to go.

Note: Muse does not store your API key between sessions. You'll need to share it again each time you start a new conversation.

Step 3: Start using Muse with your content

Give Muse instructions in plain language:

"List all collection"
"Upload all images from my tour-photos folder into this STQRY Project"

Frequently asked questions

What is the ideal workflow for building content with an AI agent?

Start with the smallest elements and work your way up. Upload media files first, then verify they uploaded correctly. Next, build your screens and check they were created as expected. Finally, move on to building collection lists and tours. This step-by-step approach makes it easy to catch and fix issues early.

Which AI agents work with STQRY Studio?

STQRY Studio currently supports Claude by Anthropic (via claude.ai, Claude Desktop, or Claude Code), Codex by OpenAI, and Meta Muse by Meta. We're actively adding support for more agents. Contact your CSM to stay updated.

Can I use an AI agent to generate text-to-speech audio on STQRY?

Yes, through the STQRY Studio CLI in Claude Code, Codex or Meta Muse. The AI agent can generate audio narration for your screens and tours using STQRY's text-to-speech. The STQRY connector doesn't generate audio.

Can I build quizzes?

Yes, with the STQRY connector or the STQRY Studio CLI. You can ask the AI agent to create quizzes for your tours and experiences.

Can I create badges?

Yes, with the STQRY connector or the STQRY Studio CLI. You can ask the AI agent to create badges that visitors earn, for example by answering quiz questions or visiting a location.

Can I ask an AI agent to choose a frame for my video thumbnail image?

Yes. The AI agent saves a frame from your video as a new image and adds it as a media item. It then sets that image as the video's thumbnail.

Which regions are available?

STQRY Studio Connect supports all regions STQRY supports.

What can I ask an AI agent to do?

You can ask the AI agent to upload images, create tours with stops and descriptions, list and manage screens, and organize collections. It can also generate access codes, and more. Describe what you need in plain language.

Where does my content go when I use an AI agent?

The AI agent receives the content it asks STQRY for, and its provider handles that content under its own terms. See AI on STQRY: Frequently Asked Questions for details.

Is my API key secure?

Your API key is stored locally on your computer and is sent to STQRY's servers when making API calls. When you type it into a chat, the AI agent's provider receives it too. Treat it like a password and don't share it publicly.

The STQRY connector doesn't use an API key. You sign in to Builder and choose which accounts Claude can use.

Need help getting started? Our team is here to assist. Contact your CSM or reach out to support@stqry.com.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article