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

# VS Code (GitHub Copilot)

> Connect Keupera to VS Code's Copilot Chat as an HTTP MCP server.

[VS Code](https://code.visualstudio.com) connects to the Keupera MCP server via
**GitHub Copilot Chat** over HTTP. Authorize with OAuth (browser sign-in) or an
API key.

## Option A — OAuth (sign in)

<Steps>
  <Step title="Add the server">
    Create `.vscode/mcp.json` in your workspace:

    ```json theme={null}
    {
      "servers": {
        "keupera": { "type": "http", "url": "https://mcp.keupera.com/mcp" }
      }
    }
    ```

    Or add it from the CLI:

    ```bash theme={null}
    code --add-mcp '{"name":"keupera","type":"http","url":"https://mcp.keupera.com/mcp"}'
    ```
  </Step>

  <Step title="Authorize">
    Start **keupera** in the Copilot Chat MCP view and sign in to Keupera in the
    browser when prompted.
  </Step>
</Steps>

## Option B — API key

```json theme={null}
{
  "servers": {
    "keupera": {
      "type": "http",
      "url": "https://mcp.keupera.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_your_key" }
    }
  }
}
```

Get your key from **Settings → API Keys** in the
[dashboard](https://app.keupera.com).

## Verify and use

Open the Copilot Chat MCP view and confirm `keupera` is running, then ask, for
example: *"Show my top keyword opportunities and outline an article for the best
one."*

## Troubleshooting

<AccordionGroup>
  <Accordion title="Server doesn't start">
    Confirm `.vscode/mcp.json` uses the `servers` key with `"type": "http"`, and
    that MCP support is enabled in Copilot Chat. Reload the window.
  </Accordion>

  <Accordion title="401 or 'unauthorized' errors">
    For OAuth, restart the server in the MCP view and sign in again. For an API
    key, confirm the `sk_live_…` value and that your plan includes API access.
  </Accordion>
</AccordionGroup>