Connect an app

Connecting an app lets DataMind Oda use that app's tools in your chats: you start from the app's card in Settings > Connectors, and finish the sign-in either in your browser or with a personal access token. Connectors covers the page itself and its cards; servers you add yourself are covered in MCP servers.

Connect an app in your browser

Open Settings > Connectors, find the app on the Connectors tab, and choose Connect on its card. The sign-in dialog opens.
Choose Continue in browser. Your browser opens the app's sign-in page; the dialog explains: Your browser opens the <app> sign-in page. Sign in there and allow access, then come back here.
Sign in on that page and allow access.
Come back to DataMind Oda. When the sign-in finishes, the dialog shows Connected. Its tools are available in your chats now. Choose Done to close it.

While the dialog waits:

It shows Waiting for you to finish signing in in your browser….
If the sign-in page did not open, or you lost it, choose Open the sign-in page again to reopen it, or Copy link to put the sign-in link on your clipboard; copying confirms with Link copied.
Keep the dialog open while you finish: closing it, or choosing Cancel, stops a sign-in that is still running.

Connect with a personal access token

Some apps sign in with a token instead of a browser page; the dialog offers the ways the app supports.

Open Settings > Connectors, find the app on the Connectors tab, and choose Connect on its card.
In the Personal access token section, paste your token into the Paste the token field. The section explains what to create: Create a fine-grained personal access token for the repositories and permissions you want DataMind Oda to use, then paste it here. It also links to How to create a fine-grained personal access token.
The token connect button becomes available once the field holds a token; choose it.
When the sign-in finishes, the dialog shows Connected. Its tools are available in your chats now. Choose Done.

Messages you may see

Message	What it means	What to do
`Waiting for you to finish signing in in your browser…`	The dialog is waiting for you to finish on the sign-in page your browser opened.	Finish signing in there and allow access; keep the dialog open.
`Connected. Its tools are available in your chats now.`	The sign-in finished and the app is connected.	Choose Done to close the dialog.
`Could not connect: <message>`	The sign-in finished with a failure; the text after the colon names the reason when there is one.	Choose Cancel and start the sign-in again from the app's card.
`The sign-in could not start. Try again.`	DataMind Oda could not open the sign-in flow.	Try the sign-in again from the app's card.

When a sign-in expires

If a saved sign-in stops working, the app's card shows Sign-in expired with a Sign in again action. Choosing it runs the sign-in flow again; finish it the same way as the first time.

Disconnect an app

Open the app card's … menu (its name reads More actions for <app>) and choose Disconnect.
A confirmation opens: Disconnect <app>? It explains: DataMind Oda signs out of <app> on this computer and its tools leave your chats. You can connect it again later.
Confirm to sign out. If the sign-out fails, the card shows Could not complete the change: <message>.

Questions, answered

What happens if I close the dialog before the sign-in finishes?

A sign-in that is still running is cancelled, and the app stays not connected. Open its card and choose Connect to start again.

The sign-in page did not open. What can I do?

Choose Open the sign-in page again to reopen it, or Copy link to put the sign-in link on your clipboard; it confirms with Link copied. If the flow cannot start at all, the dialog says The sign-in could not start. Try again.

What does `Waiting for you to finish signing in in your browser…` mean?

The dialog is waiting for you to finish on the sign-in page your browser opened. Finish signing in there and allow access, and keep the dialog open; the sign-in completes on its own when you are done.

How do I know the app is connected?

The dialog shows Connected. Its tools are available in your chats now. Choose Done, and the app's tools are ready to use in your chats.

What does `Could not connect: <message>` mean?

The sign-in finished with a failure. The text after the colon names the reason when there is one; a sign-in page that was closed before you finished also ends as a failure. Choose Cancel and start the sign-in again from the app's card; if it keeps failing, contact your DataMind OS administrator with the message.

Which sign-in will my app show: browser or token?

It depends on the app. The dialog offers what the app supports: some apps sign in through your browser, and some accept a personal access token.

What is a personal access token, and where do I get one?

You create it with the app you are connecting, with the access you want DataMind Oda to use. The dialog's hint says: Create a fine-grained personal access token for the repositories and permissions you want DataMind Oda to use, then paste it here., and it links to How to create a fine-grained personal access token. Paste the token and connect.

Why is the sign-in page in English?

The sign-in page is always shown in English, whichever language you use in DataMind Oda.

What does Sign-in expired mean?

A saved sign-in stopped working. Choose Sign in again on the app's card, and finish the sign-in the same way as the first time.

How do I disconnect an app, and what happens when I do?

Open the app card's … menu and choose Disconnect, then confirm. DataMind Oda signs out of the app on this computer, the app's tools leave your chats, and you can connect it again later.