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 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.

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 you’ve granted this tool access to. If you ask for a world that isn’t granted yet, add it on the Connected apps page (below) and try again.

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.

Manage which worlds an app can reach

The portal’s Connected apps page lists every tool you’ve authorized and the worlds each one can access. 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 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.