> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Linkly AI in WorkBuddy

> Integrate your Linkly AI local knowledge base with WorkBuddy, letting the AI work assistant search and read your private documents

## What You Can Do

<AccordionGroup>
  <Accordion title="Reference local documents when creating tasks">
    When creating tasks in WorkBuddy, let AI first search your relevant local
    materials through Linkly AI, then combine the retrieved results to complete
    reports, proposals, and other tasks — outputs that are traceable and
    grounded in real sources.
  </Accordion>

  <Accordion title="Collaborate with Tencent ecosystem connectors">
    Combine your local knowledge base with built-in connectors like Tencent Docs
    and Tencent Lexiang. WorkBuddy can simultaneously retrieve cloud
    collaboration content and local private documents, covering a more complete
    range of information sources.
  </Accordion>

  <Accordion title="Persistent knowledge source for your AI assistant">
    Using WorkBuddy's Assistant feature, let AI call Linkly AI at any time
    during conversations to search your notes, reference materials, and
    historical documents — no need to manually upload attachments each time.
  </Accordion>
</AccordionGroup>

## Prerequisites

* [WorkBuddy](https://www.codebuddy.cn/docs/workbuddy/Quickstart) installed
* Linkly AI Desktop running with the MCP service active

## Configuration Steps

<Tabs>
  <Tab title="Local MCP HTTP (Recommended)" icon="globe">
    <Steps>
      <Step title="Open Connectors">
        Click **Experts·Skills·Connectors** in the left navigation, switch to
        the **Connectors** tab at the top, then click **Custom connectors** in
        the top right.

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-connectors.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=3f23b5db3c1cd20338ddfbd045aff64d" alt="WorkBuddy Connectors entry and Custom connectors button" width="2472" height="1646" data-path="images/workbuddy-connectors.webp" />
      </Step>

      <Step title="Open the MCP configuration editor">
        In the **MCP Server Management** dialog that appears, click **Configure
        MCP** in the top right to open the JSON configuration editor.

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-mcp-configure.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=61471d03ca64fcb0be7cad0d08158e61" alt="Click Configure MCP to open JSON editor" width="2472" height="1646" data-path="images/workbuddy-mcp-configure.webp" />
      </Step>

      <Step title="Fill in the configuration and save">
        Enter the following configuration in the editor, then click **Save**:

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "url": "http://127.0.0.1:60606/mcp"
            }
          }
        }
        ```

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-mcp-http.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=961091fc3ac04d0bcbd0eb49d95ca5ee" alt="Fill in local MCP HTTP configuration" width="2472" height="1646" data-path="images/workbuddy-mcp-http.webp" />
      </Step>

      <Step title="Trust the server">
        After saving, return to the MCP list, find the **linkly-ai** entry, and
        click **Trust** to complete the first-time authorization.

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-mcp-trust.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=1d08f7ee79deb61e794f453455dbe487" alt="Click Trust to authorize the MCP server" width="2472" height="1646" data-path="images/workbuddy-mcp-trust.webp" />
      </Step>
    </Steps>
  </Tab>

  <Tab title="Remote MCP" icon="cloud">
    Complete [remote access configuration](/en/use-in-remote) first, with the
    desktop tunnel showing <Badge stroke color="green">● Connected</Badge>.

    <Steps>
      <Step title="Open Connectors">
        Same as above — go to **Connectors → Custom connectors → Configure
        MCP**.
      </Step>

      <Step title="Fill in the remote configuration and save">
        Enter the following configuration in the editor, then click **Save**:

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "url": "https://mcp.linkly.ai/mcp"
            }
          }
        }
        ```

        After saving, click **Trust** in the MCP list to authorize.
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI Stdio (Fallback)" icon="terminal">
    [Install Linkly AI CLI](/en/use-cli) first.

    <Steps>
      <Step title="Open Connectors">
        Same as above — go to **Connectors → Custom connectors → Configure
        MCP**.
      </Step>

      <Step title="Fill in the CLI configuration and save">
        Enter the following configuration in the editor, then click **Save**:

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "command": "linkly",
              "args": ["mcp"]
            }
          }
        }
        ```

        After saving, click **Trust** in the MCP list to authorize.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Getting Started

Once configured, simply describe your needs when creating a new task in
WorkBuddy and AI will automatically call Linkly AI to search and read your local
documents.

<img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-in-use.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=7c3b96949ab478332754757087ec57dc" alt="WorkBuddy calling Linkly AI tools" width="2472" height="1646" data-path="images/workbuddy-in-use.webp" />

Examples:

* "Search my local materials and compile an analysis report on XX"
* "What content about project requirements is in my documents?"

## FAQ

<AccordionGroup>
  <Accordion title="linkly-ai shows a yellow dot in the MCP list">
    Yellow means it is connecting — wait a moment and it usually turns green. If
    it stays yellow, check that Linkly AI Desktop is running and the MCP service
    shows Running.
  </Accordion>

  <Accordion title="No Trust button visible after saving">
    Click **Back to MCP List** to return to the list, then expand the linkly-ai
    entry to see the Trust button.
  </Accordion>

  <Accordion title="Where is the MCP configuration file located">
    WorkBuddy's user-level MCP configuration is stored at
    `~/.workbuddy/mcp.json`. The full path is shown in the Configuration File
    Path field at the top of the Configure MCP editor.
  </Accordion>
</AccordionGroup>
