Plugins and MCP connections

DataMind Oda is built from plugins, and a bundle groups plugins together. You can extend it: a bundle can add new capabilities to Oda, and it can connect an MCP server so Oda can use another service's tools in your chats. This page covers installing an extension, approving what it runs, and checking that a connection works.

Install a plugin or bundle

A bundle is a package folder on this computer that declares the plugins it adds. Ask Oda to install it, and point Oda at the folder:

  1. In a chat, ask Oda to install the bundle and tell Oda where the bundle is on this computer.
  2. Approve the install. Installing runs the bundle's plugin code on this computer, so it needs Full access or your approval before anything runs.
  3. If the package wants to run build scripts during the install, Oda lists them and waits. Nothing runs until you approve those scripts.
  4. Once installed, the bundle stays with your app on this computer and survives a restart.

Oda performs the installation and the bundle selection itself; do not install the package with package manager commands.

Turn plugins and bundles on or off

The Plugins page lists your app's plugins and bundles, each shown with the details its package declares. You can switch one plugin's row, or a whole bundle, on or off.

You can check what is loaded on this computer in Settings > Plugins; Built-in plugins covers that list.

What a plugin's card shows

Connect an MCP server through a bundle

An MCP server gives Oda the tools of another service. Ask Oda to set up the connection as part of a bundle; to connect tools to Oda in general, see Memory, skills and connectors.

To add and manage servers yourself, see MCP servers.

What the states mean

A switch, an install or a replaced package can report one of these states:

StateWhat it meansWhat to do
failedThe plugin could not load, and it needs diagnosis.Keep the message it reports, and repair the same bundle instead of installing another copy of it.
overriddenA higher-priority setting on this computer decides the plugin's state.Change the setting that decides it, or leave it as it is.
restart-requiredThe change is not live yet.Restart DataMind Oda. Replacing an installed package always needs a restart before its new code is used.

Questions, answered

How do I install a new plugin or bundle?

In a chat, ask Oda to install it and tell Oda where the bundle is on this computer. Oda performs the install itself and asks for your approval, because installing runs the bundle's plugin code.

What runs on my computer when I install a plugin?

The bundle's plugin code. Installing a bundle executes its plugin code on this computer, so Oda needs Full access or your approval. If the package wants to run build scripts, they are listed and must be approved separately. For how wider access is approved, see When Oda needs more access.

Why does Oda ask me to approve build scripts?

Some packages want to run their own build steps during an install. Oda does not run them on its own: it lists the scripts and waits, and they run only if you approve them. Approve only a bundle you trust.

Can I turn off one plugin without removing its bundle?

Yes. Switch the plugin's own row and the rest of the bundle is untouched; only that plugin's state changes. Switching the bundle itself turns its plugins off or on together.

Why did my change come back as overridden?

A higher-priority setting, such as a settings file on this computer, decides that plugin's state. That setting wins, so the switch cannot change it. Change the setting that decides it, or leave it as it is.

Why does Oda ask me to restart after a change?

The new code is not loaded yet. Some changes are not live, and Oda reports restart-required until a restart loads them. Replacing an installed package always needs a restart before its new code is used.

What does failed mean for a plugin I installed?

The plugin could not load, and it needs to be fixed before it can load again. Keep the message it reports, and repair the same bundle instead of installing another copy of it.

Can a bundle connect an MCP server?

Yes. A connection can bundle a server that answers at an HTTP address, or a local command that runs on this computer. Ask Oda to set the connection up for you.

How do I check that a connection works?

Use it: ask Oda to call one of the server's tools. The tools a connection offers are named after the server it came from, and a working call shows that the connection is up.

Where do I manage the MCP servers I add myself?

On the MCP servers tab of Settings > Connectors: add, edit, test and remove servers there. See MCP servers; to connect tools to Oda in general, see Memory, skills and connectors.

What shows on a plugin's card?

The name, description and icon the plugin's package declares, read before the plugin runs. An icon may be SVG, PNG, JPEG or WebP up to 256 KiB and must stay inside the package's folder. When a package declares none of these, the card falls back to the package's name and description and to default artwork.