Getting Started with STQRY Studio Connect

STQRY integrates with Claude by Anthropic and Codex by OpenAI to help you upload content, create tours, and manage your projects faster. Instead of adding content manually one item at a time, you can describe what you need in plain language and let an AI agent do the heavy lifting.

What can you do with STQRY Studio Connect?

• Upload images in bulk — drop a folder of photos and have them added to your project automatically
• 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 programmatically

Prerequisites

• A STQRY Account with Account Admin access
• A STQRY API key — see How to Generate a STQRY API Key for instructions. You can create multiple API keys for different purposes. For example, one key for content uploads and another for access code management.
• A Claude or OpenAI account — sign up for free at claude.ai or chatgpt.com (use a paid plan for best experience)

Choose your setup method

There are four ways to connect Claude or Codex to STQRY. Choose the one that fits your workflow:

Option A: Claude Cowork — A visual desktop app with a chat interface. Best for non-technical users who prefer a point-and-click experience. No terminal needed.

Option B: Claude Code — A command-line tool for developers and power users. Best for automation, scripting, and integrating STQRY Studio CLI into existing workflows.

Option C: Claude.ai — Claude in your web browser, nothing to install. Good for quick tasks, though more limited (no workspace folder).

Option D: Codex — OpenAI’s AI agent, available as a desktop app and a command-line tool. A good fit if your team already works with OpenAI / ChatGPT tools.

Option A: Setting up Claude Cowork

Step 1: Install Claude Desktop

1. Go to claude.ai/download and download Claude for your operating system.

2. Install and open the application.

3. Log in to your Claude account.

Step 2: Install STQRY Studio for Claude

1. Download STQRY Studio for Claude from downloads.stqry.com/stqry-cli/stqry-skill.zip.

2. In Claude Desktop, switch to Cowork mode, then click Customize in the sidebar.

3. Click Skills, click the + icon, then select Upload a skill.

4. Drag STQRY Studio for Claude .zip file into the dialog, or click to upload it.

5. Go back to Claude Cowork. STQRY Studio for Claude is now ready to be used in Claude Cowork.

Step 3: Connect your STQRY Project

Tell Claude your API key to connect to your project.

"Use STQRY with API Key <api_key>"

Claude will confirm the connection and you're ready to start working with your content.

Step 4: Start using Claude with your content

Once connected, you can give Claude natural language instructions. Here are some examples:

"List 10 screens in this STQRY Project"

"Upload all images from the tour-photos/ folder in my Cowork workspace into this STQRY Project"

"Create a tour about the Rochester subway. Make sure there's a stop highlighting Car 60. Use CC/public domain images from Wikimedia"

Option B: Setting up Claude Code

This method requires familiarity with a terminal (macOS/Linux/Windows Subsystem for Linux). If you prefer a visual interface, use Option A above.

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

4. 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

2. Then run:

stqry setup claude

3. 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

2. 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

Option C: Setting up Claude.ai

You can also use STQRY Studio for Claude straight from your web browser at claude.ai — nothing to install. This is great for quick tasks, but it's more limited than Claude Cowork or Claude Code: there's no workspace folder, so you can't point Claude at files or folders on your computer.

Step 1: Sign in to Claude.ai

Go to claude.ai and sign in to your Claude account.

Step 2: Allow network access

STQRY Studio CLI needs internet access to install itself and connect to STQRY. In your Claude settings, turn on Allow all for network egress.

Step 3: Install STQRY Studio for Claude

Upload STQRY Studio for Claude .zip file the same way as in Claude Cowork (see Option A, Step 2): open Skills, select Upload a skill, and upload the file from downloads.stqry.com/stqry-cli/stqry-skill.zip.

Step 4: Start using Claude with your content

Tell Claude to connect to your project:

"Use STQRY with API Key <api_key>"

Then give instructions in plain language, for example:

"List 10 screens in this STQRY Project"

Option D: Setting up Codex

This method uses the same STQRY Studio CLI as Option B, and works with both the Codex desktop app and the Codex command-line tool. A one-time terminal step installs the CLI.

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. Open your terminal and run:

curl -fsSL https://downloads.stqry.com/stqry-cli/install.sh | sh

2. Then run:

stqry setup codex

3. 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

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.

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

Yes. The AI agent can generate audio narration for your screens and tours using STQRY's text-to-speech capabilities.

Can I build quizzes?

Yes. You can ask the AI agent to create quizzes for your tours and experiences.

Can I create badges?

Yes. 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 can select a frame from your video to use as the thumbnail image.

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, organize collections, generate access codes, and more. Just describe what you need in plain language.

Is my API key secure?

Your API key is stored locally on your computer and is only shared with STQRY's servers when making API calls. Treat it like a password and don't share it publicly.

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