WBX Sandbox
Get started

Tutorials

Step-by-step guides with real screenshots. Pick your track: no code at all, or straight to the API.

Prefer video? See WBX Sandbox in action on our YouTube channel.

No coding needed: your first result in Claude

About five minutes. You need a Claude account (any plan) and a free WBX Sandbox account. The example below is real: we asked Claude for a Snake game and played it in the browser.

  1. Open Customize → Connectors → Add → Add custom connector

    In claude.ai or the Claude desktop app: click your name, then Settings → Customize.

    Claude settings, Customize – Connectors, with the Add menu open showing Add custom connector
  2. Name it and paste the address

    Name: WBX Sandbox (any name works). Address: https://sandbox.wbx.cz/mcp. Click Continue and confirm; leave the advanced OAuth fields empty.

    The Add custom connector dialog with the name WBX Sandbox and the MCP server URL filled in
  3. Sign in to WBX Sandbox and click Allow access

    Claude opens our sign-in page. Don't have an account yet? Create one for free – no card needed.

    sandbox.wbx.cz/oauth/authorize Connect Claude Claude is asking for access to WBX Sandbox in your team. It will be able to: create, use and delete sandboxes … Cancel Allow access
  4. In a new chat, switch the connector on

    Click + → Connectors and make sure the switch next to your WBX connector is on. (In our screenshots the connector is called “WBX Connect”.)

    The + menu in a Claude chat with Connectors open and the WBX connector switched on
  5. Ask for a result

    Start with “Use WBX Sandbox to …” and say what you want back. We typed: “Use WBX Sandbox to make me a Snake game I can play in my browser, and send me the link.” About half a minute later Claude answered with a private link.

    Claude replies with a link to the Snake game running in a WBX sandbox, instructions and when the sandbox ends
  6. Open the link

    The game runs in the sandbox and works on a phone too. The link contains an access token – whoever has it can open the page – and stops working when the sandbox ends.

    The Snake game opened from the sandbox link in a browser

How to ask so it works the first time

  • Name the tool. “Use WBX Sandbox to …” – otherwise the assistant may try to answer from memory.
  • Say what you want back: a link you can open, a file (the assistant gives you a download link), a chart, or just the answer.
  • Your files: paste or attach small ones; for larger files give a link the sandbox can download from – it has internet unless you turn it off.
  • Long work? Ask it to “run it as a background job and tell me when it's done” – you can close the chat.
  • Need it longer, or done early? Say “keep the sandbox for two hours” or “stop the sandbox now”. You pay only while it runs.
  • Curious what happened? Click Used WBX Connect above the answer to see every step.
Expanded tool steps: created a sandbox, wrote index.html, started a web server and got a public URL of the port
What Claude did for the Snake game: created a sandbox, wrote index.html, started a small web server and asked for a public address of its port.

Ideas to try

“Use WBX Sandbox to read this PDF aloud and give me an MP3.”

“Use WBX Sandbox: which month in this spreadsheet had the best sales? Draw me a chart.”

“Use WBX Sandbox to shrink these photos for the web and make a GIF from the video.”

“Use WBX Sandbox to take screenshots of example.com on a phone and on a laptop.”

“Use WBX Sandbox without internet to run this script and tell me what it does.”

“Use WBX Sandbox to process all these files as a background job, with a limit of $1.”

Using ChatGPT? The steps are similar – see Connect ChatGPT. Cursor, VS Code, Codex or Gemini CLI? See Connect your AI → For developers. Something not working? See troubleshooting.

For developers

The same platform without the chat window: one command for Claude Code, a dependency-free Python SDK, or plain REST.

Claude Code in one minute

claude mcp add --transport http wbxsandbox https://sandbox.wbx.cz/mcp
claude
> /mcp            # sign in to WBX Sandbox in the browser, approve access
> Clone my repo into a WBX sandbox, run the tests and fix what fails.

Long test runs come back as a short summary (get_job_logs with mode=summary) instead of thousands of log lines. In CI pass an API key instead: --header "Authorization: Bearer YOUR_API_KEY".

Python SDK quickstart

pip install wbxsandbox
export WBXSANDBOX_URL=https://sandbox.wbx.cz
export WBXSANDBOX_API_KEY=YOUR_API_KEY

python3 - <<'EOF'
from wbxsandbox import Sandbox
with Sandbox.create(template="base") as sb:
    print(sb.run("python3 -c 'print(6 * 7)'").stdout)
EOF

Create the key in the portal under API keys. Next: SDK reference.

Where to go next

Give your own model a “run code” tool
Tool calling with any model, executed in a sandbox.
Background jobs and batches
Submit and disconnect; price limits, retries, result files and receipts.
Web apps and public URLs
Exactly what Claude did for the Snake game, from your code.
LangChain Deep Agents
Use a sandbox as the agent's execution backend.
REST API
Plain HTTPS and JSON from any language.

Source code

Videos: our YouTube channel.