Skip to main content

​
Prerequisites

  • An Orion account with login credentials
Orion runs a remote MCP server; you do not need to install a server locally. Connect your client below, then optionally add Orion Guide to help your assistant use it.

​
Server URL

​
Connecting to Claude Code

Run the following command in your terminal:
--scope user makes Orion available in every directory. Without it, Claude Code adds the server only for the directory you ran the command in. Claude Code loads servers when a session starts, so open a new session, then authenticate:
  1. Type /mcp in Claude Code
  2. Select the orion server
  3. Choose Authenticate
  4. Sign in with your Orion credentials in the browser window that opens

​
Connecting to Claude

Open Orion by Gravity in Claude’s connector directory and choose Add to Claude. To add it from inside Claude instead:
  1. Go to Settings > Customize > Connectors
  2. Search for Orion in the Connectors search bar
  3. Click to add the Orion connector
  4. Authenticate with your Orion credentials when prompted

​
Connecting to ChatGPT

Open the Orion plugin in ChatGPT’s plugin directory and add it. Sign in with your Orion credentials when prompted.

​
Connecting to Cursor

  1. Open Cursor Settings
  2. Go to MCP Servers
  3. Click Add Server
  4. Set Type to http
  5. Set URL to https://g.runorion.com/mcp
  6. Authenticate with your Orion credentials when prompted

​
Connecting to Gemini Enterprise

Gemini Enterprise connects through a custom MCP server data store in the Google Cloud console, which needs OAuth client credentials from your Gravity Solution Consultant and an organization policy override. See Gemini Enterprise for the full walkthrough.

​
Verifying the Connection

Once connected, ask your AI assistant to list your Orion projects:
“List my Orion projects”
If the connection is working, you should see a list of projects you have access to.

​
Add the Orion Guide skill

Orion Guide helps your assistant use relevant context and work with Orion. Add it to your assistant alongside the MCP connection. Download the skill from the Orion examples repository:

SKILL.md

For Codex, ChatGPT, and other assistants.

orion-guide-skill.zip

Packaged skill for Claude.
Download the ZIP without unzipping it. In Customize → Skills, choose + → Create skill → Upload a skill, upload the ZIP, and enable it. Skills require code execution; your organization may also need to enable them. See Claude’s skill installation guide.

​
Get started

After connecting Orion and adding the skill, try:
Already have a task in mind?