Skip to content

Insites AI · Build with AI in your editor

Use VS Code

Last updated 20 November 2026

Add CloudShell to VS Code through Copilot or Claude Code and deploy to your site.

VS Code logoConnect VS Code to Insites

Copy this command and run it in your project folder. Then sign in with your Insites account.

insites-cli ai init --tool vscode --yes

Having trouble? See If you have trouble.

Get started in four steps

  1. Connect. Run the command above, then reload VS Code. The first time your assistant uses CloudShell, your browser opens so you can sign in with your Insites account. Use GitHub Copilot in agent mode or the Claude Code extension.
  2. Give it the Logic Engine. Paste this at the start of your project, so your assistant builds the Insites way:
    Before you write any code for this project, read the Insites Logic Engine at
    https://github.com/insites-io/insites-logic-engine
    Start with skills/insites/SKILL.md and follow its decision trees, then use the
    reference docs in skills/insites/references/ and the rules in logic-engine/rules/.
    Whenever you are unsure how something works on Insites, check the Logic Engine
    first instead of guessing, and follow its conventions over your own assumptions.
  3. Test it. Copy this into your assistant. It lists your sites, and you pick the one to work on.
    List my Insites sites.
  4. Start building. Try this:
    Build a homepage with a heading and a short welcome paragraph, and deploy it.

If you have trouble

What you need

  • An Insites account and a site. To deploy, you need the Developer role or above on it.
  • VS Code, with your project folder open.
  • GitHub Copilot, the Claude Code extension, or both.
  • The Insites CLI. See insites-cli ai init.

What the command does

It adds the CloudShell server to .vscode/mcp.json and keeps the other servers in the file.

Connect GitHub Copilot by hand

  1. Open the Command Palette and run MCP: Add Server.
  2. Choose the HTTP option and enter https://cloudshell.insites.io/mcp.
  3. Choose where to save the server, for this project or for your user profile.
  4. Start the server when VS Code asks, and sign in with your Insites account in the browser window that opens.

Then ask your questions in the Chat view, using an agent that can call tools. If a step looks different, follow the VS Code MCP guide.

Connect Claude Code by hand

Install the Claude Code extension, then run this in the VS Code terminal:

claude mcp add --transport http insites-cloudshell https://cloudshell.insites.io/mcp

Type /mcp, choose insites-cloudshell and select Authenticate to sign in. See Claude for more.

Common problems

  • The tools do not appear. Reload VS Code, and check the chat is using an agent that can call tools.
  • A tool is refused. Your role on that site does not allow it. Deploying needs the Developer role or above.

Related