Skip to content

A desktop coding agent with free access to frontier models.

TypeScript
2.9 KB
Raw Blame
---
title: "OmniRush.ai MCP for OpenCode"
sidebarTitle: "OpenCode"
description: "OpenCode MCP setup for OmniRush.ai Connect, the MCP server of a self-hosted Den for Gmail, Calendar, Drive, shared connections, skills, and Cloud resources."
---

The OmniRush.ai MCP server ([OmniRush.ai Connect](/cloud/run-in-the-cloud/cloud-mcp))
enables OpenCode to use the OmniRush.ai capabilities your organization has made
available to you: Gmail read/search, Calendar list/create, Drive search/read,
Gmail draft creation, shared MCP connections such as Notion, Linear, Slack,
Stripe, Exa, and Context7, shared skills, and OmniRush.ai Cloud resources like
skills, plugins, Collections, workers, members, roles, teams, and LLM
providers. The server exposes only `search_capabilities` and
`execute_capability`, so OpenCode searches what you can access and runs exact
capability names instead of loading hundreds of tool definitions into context.

## Server URL

```text
https://api.omnirush.example.com/mcp/agent
```

omnirush.ai does not run a hosted Den, so there is no public endpoint: use the
`/mcp/agent` URL on the API origin of your [self-hosted Den](/start-here/self-host)
(`api.omnirush.example.com` above is a placeholder). OAuth sign-in uses your
account on that Den, and the organization you pick is pinned into the token.

## Setup

1. Add this MCP entry to your `opencode.json` file:

   ```json
   {
     "mcp": {
       "omnirush": {
         "type": "remote",
         "enabled": true,
         "url": "https://api.omnirush.example.com/mcp/agent",
         "oauth": {}
       }
     }
   }
   ```

2. Authenticate the server:

   ```sh
   opencode mcp auth omnirush
   ```

3. Finish the browser sign-in, then choose the organization OpenCode should use.

If OpenCode runs on a remote machine or SSH host, follow
[Connect OmniRush.ai MCP from a remote machine](/cloud/run-in-the-cloud/connect-omnirush-mcp-remote-machine).

## Switch organizations

Log out, then authenticate again and pick the organization you want in the
browser:

```sh
opencode mcp logout omnirush
opencode mcp auth omnirush
```

<Note>
OpenCode is the verified OmniRush.ai Connect client. Native remote MCP OAuth passed
end-to-end implementation testing.
</Note>

## What you can ask

- "Which OmniRush.ai organization am I connected to?"
- "Add [email protected] to my organization."
- "Create a skill that writes weekly status reports and share it with my whole organization."
- "Find the Q3 launch page in Notion and summarize it."

## What's next

- Read the [hub overview](/cloud/run-in-the-cloud/cloud-mcp) for OAuth, token,
  server exposure, and troubleshooting details.
- Publish Notion, Linear, Slack, and other shared tools with
  [shared MCP connections](/cloud/share-with-your-team/shared-mcp-connections).
- Connect from an SSH host with
  [OmniRush.ai MCP on a remote machine](/cloud/run-in-the-cloud/connect-omnirush-mcp-remote-machine).