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, sign in to Orion, 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 Codex

Run the following command in your terminal:
The Codex CLI and IDE extension share this server list, so you add it once. Then authenticate:
  1. Run codex mcp login orion
  2. Sign in with your Orion credentials in the browser window that opens
On a machine without a local browser, run codex mcp login orion --no-browser, open the printed URL elsewhere, and paste the full redirect URL back into the terminal. To check the connection, type /mcp in the Codex TUI, or run codex mcp list from your shell.

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.

Signing In to Orion

Every client opens the same Orion sign-in page in your browser. Orion asks for your email address first, then finds your organization from that domain.
  1. Enter the email address of your Orion account
  2. Choose your organization, where your email domain belongs to more than one
  3. Sign in with your organization’s single sign-on provider or your password
Your client reaches only the organization you choose, so pick the one that holds the projects you want. Where your organization enforces single sign-on through a provider, the page offers no password form. Orion returns you to your client, and the connection is live. When your client’s authorization ends, tool calls fail until you sign in again: see Orion Returns an Authorization Error. When a sign-in step refuses you, see Authentication Fails.

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?