MCP servers and skills

In Admin, open Oda. The page has three tabs: General, MCP and Skills. This page covers MCP and Skills, where you push items to the company's DataMind Oda users. An MCP server gives Oda the tools of another service; a skill teaches it a task that should be done the same way every time.

Changes reach Oda users within 10 minutes: both tabs say so, and every save message repeats it. What users see on their side is described in Memory, skills and connectors.

Push an MCP server

  1. Open Admin > Oda and go to the MCP tab.
  2. Click Add server. The dialog Add MCP server opens on the Connection tab.
  3. Enter a Name ("Users see this name in Oda.").
  4. Enter the Server address the provider gives you. It starts with https:// and usually ends in /mcp.
  5. Add any Headers the server needs. The hint reads "Sent with every request, for example an API key. Leave empty if the server signs users in.".
  6. For a server that runs as a program on each user's computer, open Advanced and enter a Local command (stdio) with its Arguments ("One argument per line.") and any Environment variables.
  7. On the Access tab, choose the Mode and who receives the server. Both are explained below.
  8. Click Add server. The message reads "{name} saved. Oda users get the change within 10 minutes.".

Push a skill

  1. Open Admin > Oda and go to the Skills tab.
  2. Click Add skill. The dialog Add skill opens on the Content tab.
  3. Fill the form, or click Load from SKILL.md to read an existing skill file.
  4. Enter a Name: lowercase letters, digits and single hyphens, for example weekly-sales-report. Users run the skill by typing / and this name. The name cannot change after you add the skill.
  5. Enter a Description. Oda decides from this text whether to load the skill, so name the tasks it is for.
  6. Optionally add When to use (optional) guidance, and write the Instructions in Markdown.
  7. Optionally turn on Only when someone types /name if Oda should never load the skill by itself.
  8. On the Access tab, choose the Mode and who receives the skill.
  9. Click Add skill. The message reads "/{name} saved. Oda users get the change within 10 minutes.".

Choose who gets an item

The Access tab is the same for a server and a skill. It decides how the item updates and who receives it.

Mode is how later edits work:

Audience is who receives the item:

Note

The Mode is fixed once the item is added. To change it, remove the item and add it again.

A saved item whose roles have all become inactive warns "No active roles, so nobody gets it" on its row. It never falls back to everyone by itself; open it and pick active roles to fix it.

Headers, variables and shared values

An MCP server can carry values that travel with it: Headers sent with every request, and Environment variables for a local command. Add rows with Add header or Add variable. Each row works in one of two ways:

Switching a row back to Each user enters clears the stored value. When any row is shared, the form warns: "Shared values are sent to every Oda user and can be read on their computer.". For anything a person should keep private, use Each user enters.

Edit or remove an item

Limits and messages

Limits:

Messages you may meet:

Who can do this

Questions, answered

Who receives an item when I do not pick roles?

Everyone with Oda. Turn on Only for specific roles on the item's Access tab to narrow it to one or more roles.

When do users get a change I save?

Within 10 minutes: both tabs and every save message say "Oda users get the change within 10 minutes.". A Managed item updates in place for the people who have it. An Install once item stays as it was for people who already installed it; only later installs get your edits.

Can I switch an item from Install once to Managed later?

No. The Mode is fixed once the item is added. Remove the item and add it again with the other mode.

A row warns "No active roles, so nobody gets it". What do I do?

Every role you picked is now inactive or gone, so the item reaches no one. Open the item, choose who should get it on the Access tab, and save. It does not fall back to everyone on its own.

Can users read a value I mark as a shared value?

Yes. The form warns "Shared values are sent to every Oda user and can be read on their computer.". Use Each user enters for anything people should keep to themselves.

Can I rename a skill after saving?

No. The name is the command users run, so it cannot change. Add the skill again under the new name, then remove the old one.

What happens to values users typed when I remove a server?

For a Managed server, the values users entered are deleted from their Oda. For an Install once server, the copies users already installed stay on their computers.

Do I have to remove and re-add a server to change its settings?

No. Click Edit and change what you need. A Managed server confirms changes that affect users first, and some edits warn about what happens, such as values being replaced or the server restarting for everyone.

Why does saving fail with "Use a server address or a local command, not both."?

A server connects either to a Server address or to a Local command (stdio), not both. Clear one of the two and save again.

Where do users find what I pushed?

After the change reaches them, a pushed MCP server appears in the person's Oda under Settings > MCP servers, and a pushed skill under Settings > Skills. The user side is described in Memory, skills and connectors.