The connector

The connector is a single MCP URL that works across all your worlds:

https://app.orbismo.com/api/v1/mcp

Instead of wiring a tool to one world with an API key, you add this one URL, sign in with your Orbismo account, and pick which worlds the tool may use. From then on the agent can switch between those worlds in conversation without you reconfiguring anything.

It’s the smoothest option for AI tools that support MCP sign-in (OAuth) — Claude and ChatGPT among them. Tools that can’t sign in use a world URL and an API key instead.

Connect a tool

1. In the portal, open Connected AI and Apps (from the user menu) and copy the connector URL shown under “Connect a new app.”
2. In your AI tool, add a new MCP server / connector and paste that URL. (See the setup guides for where this lives in each client.)
3. Your tool sends you to Orbismo to sign in and approve access.
4. Choose the worlds this tool may reach, then confirm. This set is the app’s grant — you can change it any time from the Connected AI and Apps page.

Using Claude?

Skip steps 1–2: Orbismo is listed in the Claude Connectors Directory, so you connect with a click instead of pasting a URL. See the Claude guide.

The tool is now connected. It starts with no world active (or, if you granted just one, that world); ask the agent to pick one to get going.

Switching worlds

Once connected, just tell the agent which world to work in:

List my worlds, then switch to "Family History".

The agent can list the worlds you’ve granted and activate one; from then on, its actions apply to that world until you switch again. You can change worlds as often as you like within a conversation — there’s nothing to reconnect.

An agent can only switch to a world in the app’s grant. When it lists your worlds, it can see which ones this app may use; if the one you want isn’t granted yet, add it on the Connected AI and Apps page (below). If the agent still can’t reach a world you’ve just granted, reconnect the tool (sign in again) — the connection can carry the older grant until it re-authenticates.

What the agent can do

On the connector, the agent acts with your role on whichever world is active:

• On worlds where you’re an owner or editor, it can read and make changes.
• On worlds where you’re a viewer, it’s read-only.

So the same connection is read-write on your own worlds and read-only on a world someone shares with you as a viewer — automatically, per world. See Collaborators and permissions.

Grants and roles are separate gates: the grant controls which worlds the app can reach at all; your role controls what the agent can do once it’s there. Both have to allow an action for it to go through.

Manage which worlds an app can reach

The portal’s Connected AI and Apps page lists every tool you’ve authorized and each one’s grant. For any app you can:

• Add a world — grant the app access to another of your worlds.
• Remove a world — revoke access to a single world while keeping the app connected.
• Revoke the app — disconnect it entirely.

An app can be granted up to 32 worlds. If you’ve reached the limit, remove one before adding another.

If a world shows a warning, it means you no longer have access to that world yourself (for example, a collaborator role was removed) — the agent won’t be able to use it until your access is restored.

Removing access

To disconnect a tool, open Connected AI and Apps and Revoke it (or Revoke all to disconnect everything at once). Revocation takes effect immediately, and the tool will need to sign in again to reconnect.

Because the connector uses sign-in rather than a stored key, there’s no secret to leak or rotate — revoking access in the portal is all it takes.