Skip to content

Insites AI · Build with AI in your editor

Use Cursor with Insites

Last updated 20 November 2026

Add CloudShell to Cursor with one CLI command and deploy to your site.

Cursor logoConnect Cursor to Insites

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

insites-cli ai init --tool cursor --yes

Having trouble? See If you have trouble.

Get started in four steps

  1. Connect. Run the command above, then restart Cursor. The first time your AI uses CloudShell, your browser opens so you can sign in with your Insites account.
  2. Give it the Logic Engine. Paste this at the start of your project, so your AI 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 AI. 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.
  • Cursor, with your project folder open.
  • The Insites CLI. See insites-cli ai init.

What the command does

It adds the CloudShell server to .cursor/mcp.json. It merges the entry in and never replaces the other servers in the file. To see the change before it is written, add --dry-run.

Set it up by hand

Add CloudShell yourself in Cursor's MCP settings as a remote server at https://cloudshell.insites.io/mcp, then sign in with your Insites account when asked. The settings screen belongs to Cursor and can change, so follow Cursor's own help for where it lives.

Common problems

  • The tools do not appear. Restart Cursor. It loads new servers only at start.
  • A tool is refused. Your role on that site does not allow it. Deploying needs the Developer role or above.
  • A large file will not deploy. Small text files, under about 32 KB, go straight through. Ask your AI to use the upload tools for anything larger.

Related