> ## 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 GitHub Copilot

> Integrate your Linkly AI local knowledge base with GitHub Copilot, letting the AI coding assistant search and read your private documents

## Prerequisites

* [VS Code](https://code.visualstudio.com) installed with the GitHub Copilot extension enabled
* Linkly AI Desktop running with the MCP service active

## Configuration Steps

<Tabs>
  <Tab title="MCP HTTP (Recommended)" icon="globe">
    <Steps>
      <Step title="Open the command palette">
        In VS Code, press `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows), then type `MCP: Add Server`.
      </Step>

      <Step title="Select HTTP type and fill in the information">
        Select **HTTP or HTTPS endpoint** and fill in:

        * URL: `http://127.0.0.1:60606/mcp`
        * Server ID: `linkly-ai`

        Choose where to save (User Settings for global effect, Workspace Settings for current project only).
      </Step>
    </Steps>

    You can also directly edit the configuration file and add the following to `.vscode/mcp.json` or the user MCP config:

    ```json theme={null}
    {
      "servers": {
        "linkly-ai": {
          "url": "http://127.0.0.1:60606/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="MCP Stdio" icon="terminal">
    First [install Linkly AI CLI](/docs/en/use-cli).

    Add the following to `.vscode/mcp.json` or the user MCP config:

    ```json theme={null}
    {
      "servers": {
        "linkly-ai": {
          "command": "linkly",
          "args": ["mcp"]
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Tip>
  We recommend also installing [Linkly AI Skills](/docs/en/use-skills) to teach the
  AI assistant how to efficiently use Linkly AI's tools, improving search and
  reading efficiency.
</Tip>

## Getting Started

Once configured, ask questions directly in Copilot Chat (`Cmd+Shift+I`), and GitHub Copilot will automatically call Linkly AI's tools. For example:

* "Search my documents for content about database design"
* "Read the project's API documentation"

## FAQ

<AccordionGroup>
  <Accordion title="Cannot see the Linkly AI tools">
    Run `MCP: List Servers` in the command palette and confirm the linkly-ai
    server status is Running. If an error is shown, check whether Linkly AI
    Desktop is running.
  </Accordion>

  <Accordion title="Difference between Workspace and User Settings">
    * **User Settings**: applies to all projects, suitable for personal use -
      **Workspace Settings** (`.vscode/mcp.json`): applies only to the current
      project, can be committed to Git for team sharing
  </Accordion>
</AccordionGroup>