Integrations

An integration is an account you have connected to Tunori, such as your Gmail mailbox, your Xero organisation or an MCP server. Connect it once, and your agents can work in it.

Connectors and integrations

Two words that sound similar and mean different things:

• A connector is a type of account Tunori knows how to work with, such as Google Drive. Every connector is listed in the connector reference with its tools.
• An integration is your connected account of that type. You can have several integrations of the same connector, for example two mailboxes, and name them to tell them apart.

Integrations belong to the organization, not to one person or one agent. Only Admins can connect, rename, reconnect and delete them. Editors see the organization's integrations and choose which ones each agent may use.

Connecting an account

1. Open Integrations in the sidebar and choose Add Integration.
2. Search for what you need, by name or by what you want to do (for example send email), and pick it.
3. Give the integration a name you will recognize later, for example Work account.
4. Sign in with the provider and choose what to allow.

If you cancel on the provider's page, or the sign-in fails, nothing is added; start again whenever you like. If you leave the provider's page without finishing, the integration shows as Not connected with a Finish connecting button.

Two connectors work differently: MCP servers, which include a curated directory of popular servers in the same list, and HTTP requests, where you set up a request to any web service.

Credentials are stored encrypted and are never shown to agents or to other members.

Permissions

Each connector asks only for its own permissions: connecting Google Calendar never gives Tunori access to your mail or files, even if you connected Gmail or Google Drive with the same Google account. Some providers, Google for example, let you untick individual permissions on their consent screen. Allowing less is fine: it simply means fewer tools and triggers are available.

Each integration's menu lets you see what it can do: View Permissions lists what the account allowed, and View Available Tools and View Available Triggers show which tools and triggers are available and which are not. If something you need is unavailable, reconnect the integration and allow the missing permission. The connector reference lists every connector's permissions in plain language.

Who can use an integration

Connecting an account does not give every agent access to it:

• Agents only use the integrations you switch on in their settings, with the tools you choose and approval where you require it. See agents.
• Organization chats can use every tool of every active integration, without asking for approval. See organization chats.
• Apps only use the tools you grant to the app, tool by tool. See app functions.

Everything an agent or app does in an integration happens under the connected account: an email sent through your Gmail integration comes from that mailbox.

When something stops working

Each integration shows its status:

• Active: working.
• Not connected: the sign-in was not finished. Choose Finish connecting.
• Error: the integration stopped working, usually because access was revoked at the provider or expired. The reason is shown, for example Access expired or was revoked. Choose Reconnect.

Reconnecting signs in with the provider again and restores the integration. It never makes things worse: if you cancel or it fails, the integration stays exactly as it was. An MCP server connected with a token or without sign-in has nothing to reconnect: if its token changes, delete the integration and add it again. An HTTP request's headers, keys included, are changed with Edit.

While an integration is not working, its tools fail and its triggers do not fire.

Renaming and deleting

In the integration's menu, Edit renames it (and for HTTP requests also changes the request). Delete removes the integration:

• Agents lose access to it, and its triggers are deleted.
• Apps lose the tools you granted them from it.
• Tunori also withdraws its access at the provider where the provider allows it, so Tunori disappears from the account's list of connected apps. For Google and Xero this happens once no other integration in Tunori uses the same account. Microsoft offers no way to do this: remove Tunori in your Microsoft account's app permissions if you want to.

Deleting cannot be undone.