The connector

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

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

It is the same address the Claude and ChatGPT directories use. 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 work in any of those worlds, and move between them 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.

The connector is stateless and implements the current MCP specification revision (2026-07-28), while still accepting clients on the 2025 revisions.

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 AI or app.” It is the URL above.
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. Ask the agent to list your worlds and tell it which one to work in.

Choosing a world

Every tool on the connector acts on one world, so the agent’s first step is to find out which worlds it can reach:

List my worlds, then work in "Family History".

The agent calls list_my_worlds, which returns the worlds you can reach, each with its name, ID, description, entity count, your role, and whether this app is granted it. From there it names that world on each call, so you can move to a different world at any point just by naming it. There is nothing to reconnect.

If the app is granted only one world, that world is used whenever a call does not name one. With several granted worlds, the agent can instead call set_active_world once to choose a default world. The default applies from the next call on, and list_my_worlds lists it first. If no world is named and no default is set, the agent is told to ask you which world to use rather than guess. Every response says which world it ran against and whether you named it or the default was used, so a wrong world is easy to spot.

Several worlds on one app?

The default world belongs to you and the app, not to the conversation. Choosing a world in one chat, or on another device, changes the default for every other conversation that uses the same app. Name the world in your prompt when you work in several worlds at once. Removing a world from the app’s grant also changes the default. With one world left in the grant, that world is used.

An agent can only work in 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, the agent can give you a link to add it, or you can 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 the world it is working in:

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