Connect your AI client

Claude (web and desktop)

Add COSMOS as a custom connector.

1. Open Settings, then Connectors, then Add custom connector.
2. Paste the URL below and save.
3. Sign in with your Reach account when asked, then pick what Claude may use.

https://cosmic-mcp.app/mcp

ChatGPT

Add COSMOS as an MCP connector (workspace admins may need to allow custom connectors first).

1. Open Settings, then Connectors (or Apps and connectors), then Create.
2. Use the URL below and choose OAuth.
3. Sign in with your Reach account and approve.

https://cosmic-mcp.app/mcp

Claude Code

One command adds the remote server; run /mcp inside Claude Code to sign in.

claude mcp add --transport http cosmos https://cosmic-mcp.app/mcp

Cursor and VS Code

Add the server to your MCP config file (Cursor: .cursor/mcp.json; VS Code: .vscode/mcp.json uses "servers" instead of "mcpServers"). The editor opens the sign-in page on first use.

{
  "mcpServers": {
    "cosmos": {
      "url": "https://cosmic-mcp.app/mcp"
    }
  }
}

Local bridge and browser extension

The Browser leg drives your own browser through the TheOne Agent extension. cosmos-bridge is its local helper: it keeps one outbound, signed-in connection to COSMOS. Check each file against SHA256SUMS before you run it.

SHA256SUMS

shasum -a 256 -c SHA256SUMS --ignore-missing
chmod +x cosmos-bridge-*
./cosmos-bridge-* install   # registers the native messaging host for the extension