Getting Started

Imagine. Build. Ship.

If you can imagine it, OBTO can build it. Connect your AI client and deploy your first application through conversation.

Start in two minutes

Pick the AI app you already use. Not sure? Choose Claude: it is one click and needs no setup.

For Claude on the web, the desktop app, your phone, and Cowork.

Open OBTO in the Claude directory and click Add.
Sign in with Google when Claude asks. Your OBTO workspace is created right then. No card, no API key.
Start a new chat and say “build me a todo app on OBTO”.

Open OBTO in the Claude directory

ChatGPT connects to OBTO through developer mode.

In ChatGPT, open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
Back in Apps & Connectors, click Create. Name it OBTO, paste https://app.obto.co/ms/mcp as the server URL, choose OAuth, and save.
Sign in with Google when asked. Your OBTO workspace is created right then.
In a new chat, pick OBTO from the + menu and say “build me a todo app on OBTO”.

No Developer mode option? Your ChatGPT plan or workspace may not offer it yet. Claude works on every plan.

Paste this into Claude Code. It installs OBTO, walks you through sign-in, and builds a first app with you.

Set me up on OBTO, one step at a time.
1. Run in the terminal: claude plugin marketplace add obto-inc/platform
2. Then run: claude plugin install obto@obto
3. Tell me to restart Claude Code with `claude --continue` so the plugin loads, and wait for me.
4. After the restart, call obto_whoami. If it says I need to sign in, tell me to type /mcp, pick the OBTO server and choose Authenticate. I will finish the Google sign-in in my browser.
5. When whoami answers, read obto://guide/quickstart. Then help me build a one-page todo app on OBTO as a first test: ask me for the build contract first, and give me the live URL when it is done.

Rather type it yourself? /plugin marketplace add obto-inc/platform, then /plugin install obto@obto, then restart.

For the Codex app and the Codex CLI. They share one setup, so do this once. Paste the prompt into Codex and approve the commands when it asks.

Set me up on OBTO, one step at a time.
1. Run: codex plugin marketplace add obto-inc/platform
2. Run: codex plugin add obto@obto
3. Run: codex mcp login obto. A browser window opens and I will finish the Google sign-in.
4. Tell me to restart Codex and open a new thread. Then help me build a one-page todo app on OBTO as a first test and give me the live URL when it is done.

If Codex cannot run a command, paste the three codex lines into your terminal yourself, then restart Codex.

Cursor, VS Code, Windsurf, JetBrains and any other MCP client use one address:

https://app.obto.co/ms/mcp

Find your client in Step 2 below for the exact settings. You sign in with Google the first time it connects.

Connect with OBTO MCP

OBTO uses one universal endpoint — the same URL for everyone. Nothing to generate, no API key. Copy it; you'll paste it into your AI client in Step 2.

https://app.obto.co/ms/mcp

💡 You can create your workspace with Google first — or skip it. The first time your client connects to this endpoint, OAuth signs you in and provisions your workspace automatically.

Add It to Your AI Client

Pick your client below — every config uses the one universal endpoint https://app.obto.co/ms/mcp from Step 1. Copy & paste as-is.

Claude.ai — Web Interface

Easiest

Add OBTO from the Claude directory in one click. Use the custom connector below only if your organisation blocks the directory.

Manual setup through Connectors.

Settings → Connectors (claude.ai/settings/connectors)

Click "Add custom connector"

Paste your OBTO MCP endpoint URL

Click "Add" — transport auto-detected

In chat: "+" → "Connectors" to toggle on

Plan Note

Free: 1 connector. Pro/Max/Team/Enterprise: unlimited. Team/Enterprise orgs add via Org settings → Connectors first.

Claude Desktop App

Easiest

Add OBTO from the Claude directory in one click. Use the manual setup below only if your organisation blocks the directory.

Uses Connectors UI for remote servers — not the config file.

Recommended: Connectors UI

"+" at bottom of chat → "Connectors" → "Manage Connectors"

Add custom connector with your endpoint URL

Syncs across Claude.ai, Desktop, and Mobile

Alternative: Config file with mcp-remote

Requires Node.js. Bridges stdio to HTTP.

macOS~/Library/Application Support/Claude/claude_desktop_config.json Windows%APPDATA%\Claude\claude_desktop_config.json Linux~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "obto": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.obto.co/ms/mcp"
      ]
    }
  }
}

Common Pitfall

The config file does not support a direct "url" field. {"url":"https://..."} silently fails. Use Connectors UI or mcp-remote. Fully quit & restart after changes.

Claude Code (CLI)

Native HTTP support — simplest CLI setup.

One-command setup

claude mcp add --transport http obto-mcp https://app.obto.co/ms/mcp

With scope

# User scope (all projects)
claude mcp add --transport http --scope user obto-mcp https://app.obto.co/ms/mcp

# Project scope (team via .mcp.json)
claude mcp add --transport http --scope project obto-mcp https://app.obto.co/ms/mcp

Flag Order

All flags must come before the server name. claude mcp add obto-mcp --transport http fails.

Config file

~/.claude.json (user) or .mcp.json (project root):

{
  "mcpServers": {
    "obto-mcp": {
      "type": "http",
      "url": "https://app.obto.co/ms/mcp"
    }
  }
}

Useful: claude mcp list · claude mcp get obto-mcp · /mcp · claude --mcp-debug

VS Code with GitHub Copilot (Agent Mode)

Built-in since VS Code 1.99+. Requires Copilot extension + chat.agent.enabled: true.

Option A — Workspace (recommended)

Create .vscode/mcp.json:

{
  "servers": {
    "obto": {
      "type": "http",
      "url": "https://app.obto.co/ms/mcp"
    }
  }
}

Option B — User settings.json

{
  "mcp": {
    "servers": {
      "obto": {
        "type": "http",
        "url": "https://app.obto.co/ms/mcp"
      }
    }
  }
}

Critical

VS Code uses "servers" — not "mcpServers". #1 config error. Verify: Copilot Chat → Agent mode → tools icon.

VS Code with Continue.dev

YAML config. Tools only in Agent mode.

macOS/Linux~/.continue/config.yaml Windows%USERPROFILE%\.continue\config.yaml

mcpServers:
  - name: OBTO
    type: streamable-http
    url: https://app.obto.co/ms/mcp

Tip

If streamable-http fails, try sse. Continue uses kebab-case: sse, stdio, streamable-http.

VS Code with Cline

Access: MCP Servers icon → Configure → Configure MCP Servers

macOS~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json Windows%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "obto": {
      "url": "https://app.obto.co/ms/mcp",
      "type": "sse",
      "disabled": false,
      "timeout": 60
    }
  }
}

Tip

Start with "sse" — more reliable than "streamableHttp" (Cline uses camelCase). Green dot = connected.

VS Code with Roo Code

Access: 🔌 MCP icon → Edit Global/Project MCP

macOS~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json Windows%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json Project.roo/mcp.json (overrides global)

{
  "mcpServers": {
    "obto": {
      "type": "sse",
      "url": "https://app.obto.co/ms/mcp",
      "disabled": false,
      "timeout": 60
    }
  }
}

Required

type is required — omitting it errors. Kebab-case: "sse", "streamable-http", "stdio".

Cursor IDE

Native remote MCP. Simplest IDE config.

Project.cursor/mcp.json Global~/.cursor/mcp.json UIPreferences → Cursor Settings → Tools & MCP

{
  "mcpServers": {
    "obto": {
      "url": "https://app.obto.co/ms/mcp"
    }
  }
}

Auto-detects transport. No "type" needed. Green indicator in Settings → Tools & MCP.

Tool Limit

Cursor caps at ~40 tools across all servers. Toggle off/on or restart if tools don't appear.

Windsurf IDE (Codeium)

Own config path, different key name for URL.

macOS/Linux~/.codeium/windsurf/mcp_config.json Windows%USERPROFILE%\.codeium\windsurf\mcp_config.json UISettings → Cascade → Manage MCPs

{
  "mcpServers": {
    "obto": {
      "serverUrl": "https://app.obto.co/ms/mcp"
    }
  }
}

Windsurf Key

"serverUrl" not "url". Most common Windsurf MCP error.

JetBrains IDEs

All IntelliJ-based IDEs since 2025.1.

Settings → Tools → AI Assistant → Model Context Protocol (MCP)

+ Add → HTTP type

Paste config, OK → Apply

{
  "mcpServers": {
    "obto": {
      "url": "https://app.obto.co/ms/mcp"
    }
  }
}

Tip

"Import from Claude" button imports existing Claude Desktop configs.

Zed Editor

Stdio only — needs mcp-remote (Node.js required).

{
  "context_servers": {
    "obto": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.obto.co/ms/mcp"],
      "env": {}
    }
  }
}

Zed Quirk

"source": "custom" is required or Zed silently skips the server.

Amazon Q Developer

Native HTTP. Config: ~/.aws/amazonq/default.json or .amazonq/default.json:

{
  "mcpServers": {
    "obto": {
      "type": "http",
      "url": "https://app.obto.co/ms/mcp"
    }
  }
}

Universal Fallback (Any stdio-only Client)

mcp-remote bridges stdio to HTTP. Wrap in whatever root key your client expects:

{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://app.obto.co/ms/mcp"]
}

Install the OBTO Skill

The OBTO Skill (obto-developer) teaches your AI model how to build and deploy on OBTO. Install it into your coding agent with a single command — no manual file placement:

npx skills add obto-inc/platform

Your agent is auto-detected — Claude Code, Codex, Cursor, Windsurf, and 70+ others — and the skill lands in the right place. Handy variants:

# Preview the skill before installing
npx skills add obto-inc/platform --list

# Install into a specific agent
npx skills add obto-inc/platform -a claude-code

Installation runs on vercel-labs/skills, the open agent-skills installer — it pulls the skill straight from github.com/obto-inc/platform. Requires Node.js (bundled with npx).

Chat clients (Claude.ai / Desktop)

No skills directory? Grab SKILL.md from GitHub and attach it to your conversation or project knowledge.

Build

You're connected. Select the obto-developer skill and then just describe what you want:

"Build me a landing page for my coffee shop called Daily Grind with a hero section, menu with prices, photo gallery, and a contact form that saves submissions."

The AI reads the OBTO Skill, writes the backend logic, creates the frontend, deploys everything in the correct order, and your app goes live at yourapp.obto.co.

Ready to build?

Add OBTO from the Claude directory and ship your first app today.

Get Started →

Documentation GitHub Contact