Skip to documentation
Press slash to search. Press Enter to open the first result, or Tab to choose a link.
Sign inGet started
Browse guides

Connect an agent

Connect Grok, Gemini, Muse, Hermes, OpenClaw or Composio Instant

Add Orion to Grok, Gemini CLI, Antigravity, Muse, Hermes Agent, OpenClaw or Composio Instant, then sign in through your browser.

On this page

Grok

Add Orion as a custom connector in Grok, on the web or in its apps. On Grok Business and Enterprise, an admin adds Orion first in the xAI console, then each person connects.

Grok Build, xAI’s terminal agent
grok mcp add --transport http orion https://orionaiapp.com/api/mcp

  1. Open Grok’s connectors

    Go to grok.com/connectors, choose New Connector, then Custom.

  2. Add Orion

    Name it Orion, paste the Orion address and choose Add Connector.

  3. Sign in and allow access

    Sign in to Orion in the window that opens and allow access. Allow pop-ups if Grok asks.

Gemini CLI and Antigravity

Gemini CLI works with a Gemini API key or a Google Cloud license. On a Google AI Pro or Ultra plan, use Antigravity: add Orion to ~/.gemini/config/mcp_config.json as a server with serverUrl set to the Orion address, then choose Authenticate under MCP Servers.

Gemini CLI
gemini mcp add --scope user --transport http orion https://orionaiapp.com/api/mcp

  1. Add Orion

    Run the command below in your terminal.

  2. Sign in

    Start Gemini CLI and run /mcp auth orion. Sign in to Orion in the browser that opens and allow access.

  3. Check it

    Run /mcp list to see Orion, then ask Gemini to read your workspace.

Muse

Muse, Meta’s assistant, adds custom connectors from a chat. It is available in the US and Canada.

  1. Ask Muse to add Orion

    In a new chat, ask Muse to create a custom connector for the remote MCP server Orion at the Orion address, using streamable HTTP and OAuth sign-in.

  2. Sign in and allow access

    Sign in to Orion when Muse asks, check the access it requests, then allow it.

  3. Check it

    Ask Muse to read your Orion workspace. The reply should name your workspace.

Hermes Agent

Hermes Agent by Nous Research signs in to Orion in your browser when you add it.

Hermes Agent
hermes mcp add orion --url https://orionaiapp.com/api/mcp --auth oauth

  1. Add Orion

    Run the command below. Hermes opens your browser to sign in to Orion.

  2. Allow access and test

    Allow access in Orion, then run hermes mcp test orion.

  3. Use it

    In a Hermes chat, run /reload-mcp and ask it to read your Orion workspace.

OpenClaw

OpenClaw signs in to Orion from its command line. Stop the OpenClaw gateway before you add Orion, and start it again afterwards.

OpenClaw
openclaw mcp add orion --url https://orionaiapp.com/api/mcp --transport streamable-http --auth oauth && openclaw mcp login orion

  1. Add Orion and sign in

    Run the command below. Sign in to Orion in the browser that opens and allow access.

  2. Check it

    Run openclaw mcp doctor orion --probe, start the gateway and ask OpenClaw to read your Orion workspace.

Composio Instant

Composio Instant adds Orion as a custom MCP toolkit, then uses it in a session next to Instant tools. You sign in to Orion yourself. Instant tools can spend your Composio balance. This connection does not.

Discovery URL
https://orionaiapp.com/.well-known/oauth-authorization-server

  1. Create the toolkit

    In Composio, create a custom MCP toolkit named Orion. Set the server to the Orion address and choose DCR OAuth. Set the discovery URL to the authorization server below.

  2. Sign in and allow access

    Open the connect link, sign in to Orion and allow access.

  3. Add it to a session

    Add the toolkit slug Composio returns to a session. Ask it to read your Orion workspace.

Check the connection in Orion

Orion marks a connection verified once the assistant successfully reads its tools. Open AI connections to see it under Your connections, and choose Disconnect to end its access at any time.

Start with your own workspace.

Create a free account, upload your data and prepare your next customer conversation. Choose a paid plan when you need it.