For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt, and this page is available as Markdown at /en/guide/concepts/connectors.md.
  • English
  • 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

    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

    ConnectorWhat you can ask the expert to do
    Tencent DocsRead and write docs, smart sheets, and workspace files
    Tencent MeetingLook up and manage meetings, recordings, and AI minutes
    Tencent LexiangSearch, read, and create knowledge-base documents
    Tencent WeiyunList, upload, download, and share drive files
    Tencent ArdotUse design collaboration after official MCP authorization
    Feishu CLIDrive docs, Bitable, calendar, and messages through lark-cli on the host
    WeCom CLIDrive docs, schedules, and messages through wecom-cli on the host
    DingTalk CLIDrive contacts, calendar, and docs through dws on the host. After you save, sign in with a device code in the connector settings
    Agent MailGive the expert its own mailbox. Install the host CLI, then click Sign in to authorize

    Notes and knowledge

    ConnectorWhat you can ask the expert to do
    Tencent IMARead, write, search, and manage notes and knowledge bases
    Youdao NoteCreate, search, and organize notes
    NotionSearch and read or write pages and databases
    OpenAlexSearch papers and authors
    ObsidianOpen a local Obsidian vault through the host CLI
    Yuque (official MCP)Use Yuque with a personal token
    WeKnoraSearch and read a WeKnora knowledge base you run
    RAGFlowList 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

    ConnectorWhat you can ask the expert to do
    FliggySearch flights, hotels, attractions, and itineraries
    Baidu MapsLook up places, routes, and weather
    Trip.com WendaoAsk about hotels, flights, and itineraries
    Meituan TravelAsk about hotels, flights, train tickets, attractions, and itineraries
    DiDiUse DiDi tools after you paste a personal MCP key from the developer console

    Mail and tasks

    ConnectorWhat you can ask the expert to do
    Personal MailConnect QQ Mail, NetEase Mail, Gmail, and others over IMAP/SMTP
    TickTickWork with tasks after official MCP authorization

    News and media

    ConnectorWhat you can ask the expert to do
    Tencent NewsSearch news and follow topics
    Weixin ReadingSync a bookshelf and reading notes
    QQ MusicSearch songs, charts, playlists, and listening reports

    Professional

    ConnectorWhat you can ask the expert to do
    YuandianLook up laws, cases, and companies, and check legal hallucinations
    QichachaLook up companies. Click Authorize, or paste an API key

    Self-hosted

    ConnectorWhat you can ask the expert to do
    DifyConnect 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:

    {
      "deepwiki": {
        "display_name": "DeepWiki",
        "url": "https://mcp.deepwiki.com/mcp",
        "transport": "streamable_http"
      }
    }
    TypeWhen to use it
    HTTP ServerThe server has a URL, for example streamable_http
    Stdio ServerThe 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.