MCP servers

An MCP server gives DataMind Oda the tools of another service, such as a task tracker or a code repository, and Oda can use them while it works in your chats. You add and manage your own servers on the MCP servers tab of Settings > Connectors.

The catalogue apps (such as ClickUp and GitHub) live on the Connectors tab beside it (Connectors). What a connected server gives Oda in a chat is covered in MCP tools and resources for Oda, a broken connection in MCP servers: recovery and troubleshooting, and connections that arrive with an installed bundle in Plugins and MCP connections.

Add a server

  1. On the MCP servers tab, choose Add server.
  2. In the Add MCP server dialog, give the server a Name and its Server address, for example https://mcp.example.com/mcp. The address may carry an access token, and it is stored encrypted.
  3. Add any Headers the service needs, for example an Authorization header.
  4. For a server that runs as a program on this computer, open Advanced and fill in the Local command (stdio), its Arguments and any Environment variables.
  5. Set the Tool call timeout (seconds) if the server needs longer than the default.
  6. Choose Test connection to check the details, then Save. If a value is refused, the dialog says why and stays open.

You can add at most 64 servers.

Warning

A server started by a Local command (stdio) runs as a program on this computer, outside Oda's usual command sandbox (Command sandboxing and approvals). Add only programs you trust.

What the fields accept

Edit a server

  1. Open the row's More actions for <name> menu and choose Edit.
  2. Change what you need. Saved addresses, commands, arguments and values stay hidden, and an untouched field keeps its saved entry: Saved address <masked>. Leave empty to keep it. and Saved value. Leave empty to keep it.
  3. Choose Save.

Test a connection

Test connection connects once, reads the server's tools and closes. It saves and changes nothing.

Sign in to a server

Some servers ask for a browser sign-in before they give Oda their tools. While a server needs one, its row shows Sign in; while the browser step runs, it shows Finish in your browser….

  1. Choose Sign in. The server's sign-in page opens in your browser.
  2. Sign in there and allow access. The page confirms with You are signed in and You can close this tab and return to DataMind Oda.; if it cannot finish, it reads Sign-in did not finish and Return to DataMind Oda for details, then try again. The page is shown in English only.
  3. Come back to DataMind Oda. The row then shows Signed in as <account>.

Two kinds of server cannot sign in this way:

The sign-in renews quietly while it stays valid. When it stops working, the row shows Sign-in needed with Sign in to use this server. The saved sign-in is missing or no longer accepted., and you sign in again from the row.

Turn a server on or off

The switch beside a server reads Use <name>.

Remove a server

  1. Open the row's More actions for <name> menu and choose Remove.
  2. Confirm Remove <name>? and Its tools will no longer be available in chats. You can add the server again later.

Removing a server cancels a sign-in that is still running, deletes the server and its stored details, and revokes its tokens where the sign-in server allows it.

What a server's row shows

Where your connection details are kept

Addresses, headers, commands, arguments and environment values are stored encrypted on this computer. The tab itself says: Connect MCP servers so DataMind Oda can use their tools in your chats. Addresses, headers and environment values are stored encrypted on this computer.

Questions, answered

Can I manage MCP servers in the browser app?

No. The MCP servers list appears in the desktop app and the VS Code extension, not in the browser app. Without a desktop connection, a saved server cannot start; it stays at Connecting….

How many servers can I add?

At most 64. When the list is full, adding another is refused: You can add at most 64 MCP servers.

Why was my server name refused?

Names run from 1 to 64 characters, with no leading or trailing spaces, and two servers cannot share one even with different capitalisation: A server named "<name>" already exists. Choose another name.

Why does Oda refuse an address with a user name and password?

Credentials inside an address are refused, so a password never sits in the address string: Remove the user name and password from the address and send them as a header instead. Add the value as a header in the same dialog.

Why can't I set a header like Content-Type?

The app sets some header names itself, and those cannot be changed: The header "<name>" is set by the app and cannot be changed. Remove that row; the app supplies the header. Other header rules: names use letters, digits and dashes, one row per name, and up to 32 headers.

What happens if secure storage is not available on this computer?

Oda cannot save or read connection details, and says so: Secure storage is not available on this computer, so connection details cannot be saved or read. A server that needs stored details cannot connect until secure storage works.

Why did the sign-in page I opened say Not found?

That page answers only a request that belongs to a running sign-in; anything else gets Not found. Start the sign-in again from the server's row and finish it on the fresh page.

What do the statuses in a server's row mean?

Connected: the server is up and its tools are available. Connecting…: Oda is still connecting. Not connected: the last connection could not be made. Turned off: you switched the server off. Sign-in needed: its saved sign-in is missing or no longer accepted. A reason follows the status when there is one.

Can I turn a server off without removing it?

Yes. The switch reads Use <name>; turning it off takes the server's tools out of your chats and keeps the server in the list. Turn it on again to connect it back.

Why is the server address in my list shortened?

So a token inside an address is never shown in full: the scheme and host stay, the last part of the address keeps only its first four and last two characters, as in https://…abcd…12, and any query, fragment or credentials are never shown. Messages about a server are shortened the same way.