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

# Connect from VS Code (GitHub Copilot)

> How to connect the Nexudus MCP server to GitHub Copilot in VS Code.

# Connect from VS Code (GitHub Copilot)

GitHub Copilot in VS Code supports MCP servers through the **MCP** settings in the Copilot extension. Once added, Copilot's chat panel can call Nexudus tools alongside its other capabilities.

## Prerequisites

* **VS Code** with the **GitHub Copilot** extension installed and signed in.
* A **GitHub Copilot** subscription that supports MCP servers (Business or Enterprise at the time of writing — check your plan in VS Code).
* A **Nexudus** account with API access.

## Add the Nexudus server

VS Code stores MCP server entries in a JSON config file. The easiest way to add Nexudus is via the command palette.

<Steps>
  <Step title="Open Agent Customizations">
    From the VS Code activity bar, open **Agent Customizations** (or run **MCP: Add Server** from the command palette with **Cmd/Ctrl + Shift + P**).
  </Step>

  <Step title="Add a new MCP server">
    In the **MCP Servers** section, click the **+** button to add a new server.
  </Step>

  <Step title="Choose the HTTP transport">
    From the list, select **HTTP (HTTP or Server-Sent Events)** — *"Connect to a remote HTTP server that implements the MCP protocol"*.

    <img src="https://mintcdn.com/nexudus/0lPtcckqHPWYCku1/images/mcp/vscode-mcp-server-type.png?fit=max&auto=format&n=0lPtcckqHPWYCku1&q=85&s=ef5c2c7247232593bcf9d2134e16600b" alt="VS Code MCP server type picker with 'HTTP (HTTP or Server-Sent Events)' highlighted." width="1447" height="906" data-path="images/mcp/vscode-mcp-server-type.png" />
  </Step>

  <Step title="Enter the Nexudus server URL">
    Paste `https://mcp.nexudus.com` into the **Enter Server URL** field and press **Enter**.

    <img src="https://mintcdn.com/nexudus/0lPtcckqHPWYCku1/images/mcp/vscode-mcp-server-url.png?fit=max&auto=format&n=0lPtcckqHPWYCku1&q=85&s=9bc3143709671b5efdbcfe6a65854076" alt="VS Code prompt to enter the MCP server URL, with https://mcp.nexudus.com filled in." width="1446" height="919" data-path="images/mcp/vscode-mcp-server-url.png" />
  </Step>

  <Step title="Give it a name">
    When prompted, give the server a name (for example, `nexudus`). The server appears in the MCP Servers list once registered.

    <img src="https://mintcdn.com/nexudus/0lPtcckqHPWYCku1/images/mcp/vscode-mcp-server-config.png?fit=max&auto=format&n=0lPtcckqHPWYCku1&q=85&s=7987f6ec0c61a625f643bb8b0fa60d8a" alt="VS Code showing the configured Nexudus MCP server with name, type 'http', and the server URL." width="888" height="1382" data-path="images/mcp/vscode-mcp-server-config.png" />
  </Step>

  <Step title="Approve the authentication">
    VS Code prompts you to allow the server to authenticate. Click **Allow**.

    <img src="https://mintcdn.com/nexudus/0lPtcckqHPWYCku1/images/mcp/vscode-mcp-auth-prompt.png?fit=max&auto=format&n=0lPtcckqHPWYCku1&q=85&s=7a7b4eef7feac23d8a4557a9dc402bb4" alt="VS Code dialog: 'The MCP Server Definition wants to authenticate to mcp.nexudus.com.' with Allow and Cancel buttons." width="1432" height="894" data-path="images/mcp/vscode-mcp-auth-prompt.png" />
  </Step>

  <Step title="Sign in to Nexudus">
    VS Code opens your default browser to the Nexudus login page. Enter your Nexudus email and password and approve the connection. The
    browser redirects back to VS Code and the server appears as **Connected**.

    <img src="https://mintcdn.com/nexudus/0lPtcckqHPWYCku1/images/mcp/nexudus-oauth-login.png?fit=max&auto=format&n=0lPtcckqHPWYCku1&q=85&s=48fd1da7ca2a1027045461e7288d7a78" alt="Nexudus sign-in page asking for email and password to authorise the MCP connection." width="1566" height="1008" data-path="images/mcp/nexudus-oauth-login.png" />
  </Step>
</Steps>

## Add manually via settings

If you prefer to edit the config directly, open the command palette and run **MCP: Open User Configuration**. Add an entry:

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

Save the file. Then run **MCP: Reload Servers** from the command palette and sign in through the browser when prompted.

## Verify it works

Open the Copilot chat panel and ask:

> *"List my Nexudus locations."*

Copilot should call the Nexudus server. The chat panel shows the tool call and the response inline.

## Things to try

* *"Generate a CSV of all bookings for last week, one row per booking."*
* *"List the meeting rooms at my main location and their hourly rates."*
* *"Create a new event called 'Community Coffee' next Friday at 10am."*

<Warning>
  Copilot can create, update, and delete real data through the connector. Read the tool call before approving it, especially for deletions and bulk
  updates.
</Warning>

## Disconnect or re-authenticate

Open the command palette and run **MCP: Manage Servers** to remove or reconnect Nexudus. After the 8-hour session expires, Copilot's tool calls
return an auth error — reconnect from the same menu.

## Common issues

| Issue                                          | Solution                                                                       |
| ---------------------------------------------- | ------------------------------------------------------------------------------ |
| **MCP: Add Server** command is missing         | Update the GitHub Copilot extension to the latest version.                     |
| Nexudus server shows but no tools appear       | Run **MCP: Reload Servers** from the command palette.                          |
| Browser does not open during sign-in           | Check VS Code's output panel for the MCP server log and open the URL manually. |
| Tool calls fail with "Authentication required" | Your 8-hour session has expired. Reconnect from **MCP: Manage Servers**.       |

For more, see [Troubleshooting](/mcp/troubleshooting).

## Next steps

<CardGroup cols={2}>
  <Card title="Available tools" icon="wrench" href="/mcp/tools">
    What the AI assistant can do for you.
  </Card>

  <Card title="Sessions and re-auth" icon="clock" href="/mcp/sessions">
    Why sessions expire after 8 hours.
  </Card>
</CardGroup>
