Realm
DownloadDownloadDownload

Extend Realm

Connections and skills

Give a space's agents your apps and tools through one MCP gateway that keeps your credentials out of their hands, and teach them how you work with skills.

On this page
  1. How connections work
  2. Connect an app
  3. Add any MCP server
  4. Realm's own tools
  5. See every call
  6. Skills

How connections work

Connections belong to a space, not to an agent. Every session in the space gets one endpoint, Realm's MCP gateway, and through it the tools of every server the space has connected. When an agent calls a tool, it calls Realm, and Realm calls the server. The credentials a server needs stay with Realm and never reach the agent.

So one connection works for every agent you run in the space: Claude, Codex, Cursor and the rest all see the same tools.

Connect an app

The Connections page, Connect an app: cards for Linear, Notion, Slack, GitHub, Jira & Confluence, Figma and Sentry, each saying what it grants, with a Connect button and a link to the vendor's docs.
The apps a space can connect in one click.Three of the apps a space can connect, each with what it lets an agent do.

Connections on the rail starts with Connect an app: a card for each app whose own remote MCP server Realm can sign you in to. Press Connect and sign in on the app's own page. From then on it's an ordinary server in the list below.

AppWhat its agents can do
LinearRead and update issues, projects and cycles. Paste an issue link and the agent has it.
NotionSearch and read pages and databases, and write back.
SlackRead channels and threads, search messages, post as you.
GitHubIssues, pull requests, code search and Actions on your repositories.
Jira & ConfluenceJira issues and boards, Confluence pages, through Atlassian's own server.
FigmaRead designs, components and variables straight from a file link.
SentryIssues, stack traces and releases, so an error link is a starting point.

Apps that need an app of your own

Slack doesn't hand out sign-in clients on the fly, so its card asks for the Client ID and Client secret of a Slack app you create, before it signs you in. The card lists the steps, including the redirect URL to add:

  1. At api.slack.com/apps, create an app in your workspace (From scratch).
  2. Under OAuth & Permissions, add the redirect URL https://realm.computer/oauth/callback.
  3. Copy the Client ID and Client Secret from Basic Information into the card.
  4. Install the app to the workspace, or have an admin approve it.
NoteThat redirect is a page on this site that only bounces the sign-in back to Realm on your own computer. It never leaves your computer's loopback address.

GitHub

GitHub's card connects with your GitHub CLI's sign-in if you have one, otherwise with a code you enter on GitHub, or a token you paste.

Add any MCP server

Under MCP servers, Add server connects any other server:

FieldFor
NameLetters, digits, underscore or hyphen
Transportstdio for a program Realm starts, or http or sse for a server at a URL
Command and ArgumentsThe program to start (stdio)
URLWhere the server is (http, sse)
AuthenticationOAuth, where the server offers it, or API key headers
Environment variables or HeadersValues the server needs, such as an API key

Each server's row shows its state and has Test, Refresh tools, Edit and Remove…. A server that exits, by crashing or quitting when idle, is connected again on its next call. One whose connection keeps failing has its calls blocked until Retry reconnects it, and one whose sign-in expired says Needs reauth.

A server can be set up for This space, for every space in your profile (From <profile>), or Everywhere. Move to profile… and Move to this space… change that.

NoteOAuth sign-ins are kept encrypted, with the key in your keychain. The environment variables and headers you type into a server's form are stored in Realm's database on your computer, not encrypted, so prefer OAuth where a server offers it.

Realm's own tools

Realm gives every session tools of its own through the same gateway: the browser, terminals, documents, schedules, simulators, sub-agents, computer use and more. They run under Realm's permission rules, not as servers you configured. The list under Realm's own tools has a switch for each, for this space. Most are on by default; the ones that reach outside a pane Realm made (other Mac apps, another machine, Realm's own interface) start off.

See every call

MCP Activity (View ▸ MCP Activity, the palette, or Activity beside the server list) lists every tool call that went through the gateway: which server and tool, how long it took, and whether it was blocked. In a transcript, a call to a connected app wears that app's mark.

TipPaste a link from a connected app (a Linear issue, a Notion page, a Slack thread) into the prompter, and where Realm can name what it points at, it becomes a chip with that name. The agent gets the link, and opens it through the connection.

Skills

A skill is a folder with a SKILL.md in it: instructions, and any files they need, that teach an agent how to do one thing your way. Realm keeps your skills in ~/Realm/skills, and can also read the folders you point it at.

  • Library ▸ Skills, or a space's Skills tab, lists every skill Realm found, each with a switch for this space. A skill's own page says whether it's On in this space or Off in this space.
  • Like servers, a skill can belong to This space, your profile, or Everywhere.
  • Add a folder… adds another place to look. Where Realm looks for skills lists every place and how many skills each holds.
  • In a session, + ▸ Skills turns one on, and @ with a skill's name mentions it in a message.

How each agent uses them on the skills page says what each agent does with a skill, since they don't all take them the same way. Codex reads skill folders per connection rather than per space, so a skill on in any space is visible to Codex sessions in every space.

Realm ships a few skills of its own, such as the browsing playbook its browser agent follows. Settings ▸ Import copies the skills you already have in Claude Code, Codex and Cursor into Realm, without changing the originals.