> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat/connected-services.md).

# Connected Services

Manage the external services an Agent accesses on your behalf. View authorization status, reauthorize, or disconnect services in Connected Services in the Agent Marketplace and Web Chat, and learn wha

When an Agent needs to use **your own account** to check a calendar, read cloud drive files, or work with an external system, it first asks for your authorization in the conversation. All services you have authorized appear in the <mark style="color:blue;">Connected Services</mark> window: you can view authorization status and expiration, reauthorize, or disconnect at any time. You manage these connections yourself, without asking an administrator to do it for you.

{% hint style="info" %}
This page covers authorization for an Agent to access services on your behalf, for users of the Agent Marketplace and Web Chat. The connectors that MaiGPT users connect through the “+” menu, such as Notion and Slack, use a separate entry point. See [MaiGPT Connectors](https://docs.maiagent.ai/maiagent-user-guide/en/work/maigpt/connectors.md).
{% endhint %}

## Where to Open It <a href="#where-to-open" id="where-to-open"></a>

| Usage scenario                                                                                                | Entry point                                                                                                                                                                                                                                                                                 | Who can see it                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Admin console → <mark style="color:blue;">Agent Marketplace</mark> → Chat with an **official built-in Agent** | The <mark style="color:blue;">Connected Services</mark> button at the top of the conversation page                                                                                                                                                                                          | All members chatting with official built-in Agents (this button does not appear on conversation pages for Agents created by your organization)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Web Chat on a website (full-screen page or public access URL)                                                 | The link icon in the title bar; hovering over it displays “Connected Services.” [Show Connected Services](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/function-settings.md#show-connected-services) must be enabled for the chat platform | Identified visitors: those who have [logged in](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat.md#login-config), or whose identity the website passes through a [Source ID](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat/source-id-access.md). Visitors who have only filled out a [Pre-chat Form](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat.md#pre-chat-form) do not count as identified (the form data has not been authenticated). The entry point is hidden for these visitors and anonymous visitors, and in the bottom-right floating window and MaiGPT window mode |

## First Authorization: The Authorization Card in the Conversation <a href="#authorization-card" id="authorization-card"></a>

When an Agent first needs a service, a “Connect {service}” card appears in the conversation. It lists the <mark style="color:blue;">Permissions to Be Granted</mark> and explains that credentials are stored encrypted on the backend, not in your browser. Clicking <mark style="color:blue;">Go to Authorization</mark> (<mark style="color:blue;">Authorize Connection</mark> in the admin console) opens a new window where you log in to the service and grant consent (you enter your account credentials only on the service’s official page; MaiAgent never handles them). Once authorization is complete, the card changes to “Connected to {service},” and the Agent can continue retrieving data using your identity.

{% hint style="warning" %}
If you see “Your browser blocked the new window. Please allow pop-ups and try again,” allow pop-ups for this website in your browser, then click the authorization button again.
{% endhint %}

{% hint style="info" %}
After the authorization window closes, the card continues checking the result for around ten to twenty seconds. It usually changes to “Connected to {service}” quickly. If it still has not changed after you wait, click the authorization button again.
{% endhint %}

## What Is in the Window <a href="#window-layout" id="window-layout"></a>

When you open <mark style="color:blue;">Connected Services</mark>, the service list appears on the left and details for the selected service appear on the right.

**Service list on the left**

* <mark style="color:blue;">Search services…</mark> filters services by name.
* Each service displays a status: <mark style="color:blue;">Authorized</mark> (ready to use), <mark style="color:blue;">Pending Authorization</mark> (not yet authorized), or <mark style="color:blue;">Reconnection Required</mark> (authorization has expired or become invalid, and the Agent cannot currently retrieve data).
* An empty list displays “No services available to connect,” which means none of the Agents you use require your personal authorization for a service.

**Service details on the right**

| Section                                                        | Contents                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Status message                                                 | Pending authorization displays “Not yet authorized” and <mark style="color:blue;">Authorize Connection</mark>; when reconnection is required, it displays “Connection expired. Reauthorization required” and <mark style="color:blue;">Reauthorize</mark>. Reauthorizing does not affect any of your content in that service                                                                  |
| <mark style="color:blue;">Assistants Using This Service</mark> | The Agents that access data through this authorization                                                                                                                                                                                                                                                                                                                                        |
| <mark style="color:blue;">Authorization Information</mark>     | <mark style="color:blue;">Authorized Account</mark> (the account you logged in to the service with), <mark style="color:blue;">Authorization Method</mark> (OAuth 2.0), <mark style="color:blue;">Authorization Time</mark>, <mark style="color:blue;">Credential Expiration</mark> (for example, “In N days”), and <mark style="color:blue;">Token Storage</mark> (encrypted on the backend) |
| Authorization scopes                                           | Authorized services list <mark style="color:blue;">Granted Scopes</mark>; services not yet authorized list <mark style="color:blue;">Requested Scopes</mark>. Review them before authorizing                                                                                                                                                                                                  |
| <mark style="color:blue;">Disconnect</mark>                    | See the next section                                                                                                                                                                                                                                                                                                                                                                          |

## Disconnect <a href="#disconnect" id="disconnect"></a>

Click <mark style="color:blue;">Disconnect</mark> in the service details. The confirmation window lists “The following assistants will be affected.” Once you confirm, these Agents immediately lose access to the service on your behalf. You will need to authorize again to use it later.

{% hint style="info" %}
Disconnecting revokes the credentials stored by MaiAgent. If you see “Disconnected on the platform side. To remove access completely, check your account settings in {service},” the service may still list MaiAgent as an authorized application. To remove it completely, revoke its access again in that service’s account settings.
{% endhint %}

## Frequently Asked Questions <a href="#faq" id="faq"></a>

### The service shows “Reconnection Required,” and the Agent says it cannot retrieve data? <a href="#faq-reauthorize" id="faq-reauthorize"></a>

Your authorization credentials have expired. Open <mark style="color:blue;">Connected Services</mark>, select the service, and click <mark style="color:blue;">Reauthorize</mark>. Once complete, ask the Agent again.

### I cannot see the “Connected Services” button? <a href="#faq-no-button" id="faq-no-button"></a>

* Web Chat: You are currently an anonymous visitor or are using the bottom-right floating window. Open the full-screen page and fill out the form or log in first.
* Web Chat: The website administrator has disabled [Show Connected Services](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/function-settings.md#show-connected-services) for this chat platform (it is disabled by default for new platforms). Contact the website administrator.
* Admin console: This button appears only on conversation pages for official built-in Agents.

### Whose account am I authorizing? Can other colleagues use it? <a href="#faq-whose-account" id="faq-whose-account"></a>

It is the account you log in to the service with, and it is used only in your own conversations with Agents. Other people must each authorize the service themselves. If an administrator wants the entire organization to share one account, they set the authorization subject to “Organization-wide Sharing” when creating the tool. Those services do not appear in this window.

## For Administrators: Make Services Appear Here <a href="#for-admins" id="for-admins"></a>

For Web Chat visitors to see the entry point, <mark style="color:blue;">Feature Settings</mark> → <mark style="color:blue;">Show Connected Services</mark> must be enabled for the chat platform. It is disabled by default for new platforms. See [Feature Settings: Show Connected Services](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/function-settings.md#show-connected-services).

This window lists the OAuth MCP tools configured for the Agent whose authorization subject is “Individual Contact Authorization.” For setup instructions, see [Create an MCP Tool: OAuth Connectors and Authorization Subjects](https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/mcp-setup.md#oauth-auth-subject). Administrators can also view or revoke a contact’s authorization in the <mark style="color:blue;">Connector Authorization</mark> tab of the <mark style="color:blue;">Contact</mark> edit window. To supply credentials from an existing system for a contact in advance (without OAuth), see [Contact MCP Credential Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/setup-contacts-mcp-credentials.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat/connected-services.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
