> For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt.

# Connectors: let an expert use your apps

A connector is an external app an expert can operate. You authorize it once. After that you do not need the tool name: say “Check my Tencent Meeting schedule for tomorrow” or “Write these notes into Tencent Docs.” The expert decides when to call it.


![Connectors](/images/en/ui-connectors.png "Connectors")

## Connect one app you already use


### Open Built-in connectors

In the sidebar, open **Connectors**, then **Built-in connectors**.

### Click to connect

Pick a service and click **Click to connect**. You can create several instances of the same service, for example two mail accounts.

### Authorize and probe

Follow the page to scan a QR code, click **Authorize**, or paste a secret, then click **Probe**. Save after the probe succeeds. Tokens stay on this machine under `~/.octop/secrets/`.

### Select it in Conversation and ask in plain language

Open **Conversation**, open **Connectors** in the composer, and tick the instance. Then say what you want done. To include it every time, edit the instance and turn on **Enable by default**. That switch applies only to your own new chats.

Turn on **Share with others** and other people signed in on this instance can select the instance. They cannot view or edit its configuration. Only the owner can edit it.


> **WARNING**
> 
> If you revoke access in the external service, the stored token stops working. The next call fails. Authorize again from **Connectors** to restore it.
> 


## Pick by the job

The groups below match the categories on the page.

### Office

| Connector           | What you can ask the expert to do                                                                                                  |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Tencent Docs**    | Read and write docs, smart sheets, and workspace files                                                                             |
| **Tencent Meeting** | Look up and manage meetings, recordings, and AI minutes                                                                            |
| **Tencent Lexiang** | Search, read, and create knowledge-base documents                                                                                  |
| **Tencent Weiyun**  | List, upload, download, and share drive files                                                                                      |
| **Tencent Ardot**   | Use design collaboration after official MCP authorization                                                                          |
| **Feishu CLI**      | Drive docs, Bitable, calendar, and messages through `lark-cli` on the host                                                         |
| **WeCom CLI**       | Drive docs, schedules, and messages through `wecom-cli` on the host                                                                |
| **DingTalk CLI**    | Drive contacts, calendar, and docs through `dws` on the host. After you save, sign in with a device code in the connector settings |
| **Agent Mail**      | Give the expert its own mailbox. Install the host CLI, then click **Sign in to authorize**                                         |

### Notes and knowledge

| Connector                | What you can ask the expert to do                                                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tencent IMA**          | Read, write, search, and manage notes and knowledge bases                                                                                                     |
| **Youdao Note**          | Create, search, and organize notes                                                                                                                            |
| **Notion**               | Search and read or write pages and databases                                                                                                                  |
| **OpenAlex**             | Search papers and authors                                                                                                                                     |
| **Obsidian**             | Open a local Obsidian vault through the host CLI                                                                                                              |
| **Yuque (official MCP)** | Use Yuque with a personal token                                                                                                                               |
| **WeKnora**              | Search and read a WeKnora knowledge base you run                                                                                                              |
| **RAGFlow**              | List datasets, search parsed documents, and read a returned passage. Enter the service URL and API key. This does not copy files into an Octop knowledge base |

### Travel and maps

| Connector           | What you can ask the expert to do                                            |
| ------------------- | ---------------------------------------------------------------------------- |
| **Fliggy**          | Search flights, hotels, attractions, and itineraries                         |
| **Baidu Maps**      | Look up places, routes, and weather                                          |
| **Trip.com Wendao** | Ask about hotels, flights, and itineraries                                   |
| **Meituan Travel**  | Ask about hotels, flights, train tickets, attractions, and itineraries       |
| **DiDi**            | Use DiDi tools after you paste a personal MCP key from the developer console |

### Mail and tasks

| Connector         | What you can ask the expert to do                               |
| ----------------- | --------------------------------------------------------------- |
| **Personal Mail** | Connect QQ Mail, NetEase Mail, Gmail, and others over IMAP/SMTP |
| **TickTick**      | Work with tasks after official MCP authorization                |

### News and media

| Connector          | What you can ask the expert to do                      |
| ------------------ | ------------------------------------------------------ |
| **Tencent News**   | Search news and follow topics                          |
| **Weixin Reading** | Sync a bookshelf and reading notes                     |
| **QQ Music**       | Search songs, charts, playlists, and listening reports |

### Professional

| Connector    | What you can ask the expert to do                                  |
| ------------ | ------------------------------------------------------------------ |
| **Yuandian** | Look up laws, cases, and companies, and check legal hallucinations |
| **Qichacha** | Look up companies. Click **Authorize**, or paste an API key        |

### Self-hosted

| Connector | What you can ask the expert to do                                   |
| --------- | ------------------------------------------------------------------- |
| **Dify**  | Connect a published Dify app or workflow through its MCP Server URL |

CLI connectors need the matching command on the machine that runs `octop run`. The page can **Install CLI**, or you can hand the command to an administrator.

## When the built-in list does not have it

Under **Connectors → Custom connectors**, register any MCP server with the visual form or by pasting JSON:

```json
{
  "deepwiki": {
    "display_name": "DeepWiki",
    "url": "https://mcp.deepwiki.com/mcp",
    "transport": "streamable_http"
  }
}
```

| Type             | When to use it                                      |
| ---------------- | --------------------------------------------------- |
| **HTTP Server**  | The server has a URL, for example `streamable_http` |
| **Stdio Server** | The server is a local program that Octop starts     |


> **NOTE**
> 
> A stdio program must be installed on the machine running `octop run`. An HTTP URL must be reachable from that machine. Custom MCP on public HTTPS can use OAuth: Octop discovers the authorization server from the MCP URL (401 / RFC 9728), stores encrypted tokens, and sends `Authorization: Bearer` when it loads tools. When the server has no dynamic client registration, the probe sets `oauth.client_required` and you fill in a pre-registered client id. A client secret is optional and is not returned after you save. Register `<public base>/api/connectors/oauth/callback` as the redirect URI. Loopback and private addresses skip remote OAuth discovery. Only the person who created a shared connector can edit it.
> 


When the server exposes standard protected-resource metadata, save first, then click **Probe**. If the probe says authorization is required, click **Authorize**. OAuth callbacks on a non-loopback address need a public HTTPS URL for this Octop.

Turn on **Selected by default in chat** when web UI chats, IM, and scheduled tasks that do not pick a connector should include this MCP automatically. Leave it off to choose it on each turn.


> **TIP**
> 
> If no public server exists yet, you can run your own and register it here.
> 

