Insites AI · Build with AI in your editor
Use Grok with Insites
Last updated 22 November 2026
Add CloudShell to Grok and deploy to your site.
Connect Grok to Insites
In Grok, add a custom connector with this address. Then sign in with your Insites account.
https://cloudshell.insites.io/mcpHaving trouble? See If you have trouble.
Get started in four steps
- Connect. Go to grok.com/connectors, click New Connector, then Custom. Paste the address above and sign in with your Insites account when Grok asks.
- Give it the Logic Engine. Paste this at the start of your project, so Grok 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. - Test it. Copy this into Grok. It lists your sites, and you pick the one to work on.
List my Insites sites. - Start building. Try this:
Build a homepage with a heading and a short welcome paragraph, and deploy it.
Note
Grok on the web cannot read files on your computer. For a large file it deploys by putting the file at a public link and asking CloudShell to fetch it. Public means public: never put a secret in it. Set secrets as environment variables instead.
If you have trouble
What you need
- An Insites account and a site. To deploy, you need the Developer role or above on it.
- A Grok account. On a Business or Enterprise workspace, an admin may need to add the connector first.
- The CloudShell address,
https://cloudshell.insites.io/mcp.
Connect CloudShell step by step
- Sign in at grok.com and go to grok.com/connectors.
- Click New Connector, then Custom.
- Enter the CloudShell address:
https://cloudshell.insites.io/mcp. - Sign in with your Insites account when Grok asks. Your browser opens for the sign-in.
No password, key or site ID goes into Grok. The menu names belong to Grok and can change, so follow Grok's own help for where the setting lives.
Use Grok Build in your terminal instead
Grok Build is xAI's coding tool for the terminal. It can read the files in your project folder. Run this in your project folder:
grok mcp add --transport http insites-cloudshell https://cloudshell.insites.io/mcpThe first time Grok uses CloudShell, your browser opens so you can sign in with your Insites account. Type /mcps in Grok Build to see the server and sign in again. See the Grok Build MCP guide.
How deploys work from a web chat
A chat on the web cannot read the files on your computer. Your AI writes the page content straight into the deploy. For a large file, it puts the file at a public address and asks CloudShell to fetch it with the insites_deploy_from_url tool. To work on a project folder directly, use Grok Build or a coding tool such as Claude Code or Cursor.
Common problems
- There is no Custom option. On a Business or Enterprise workspace, ask your admin to add the connector.
- You are signed out. Open the connector at grok.com/connectors and connect again.
- Grok Build says Auth required. You have not signed in to CloudShell yet. Start
grok, type/mcps, chooseinsites-cloudshelland pressito sign in. Rungrok mcp doctorto check the connection. - A tool is refused. Your role on that site does not allow it. Deploying needs the Developer role or above.
- Grok asks before each action. That is expected. You can disconnect CloudShell at any time.