> For the complete documentation index, see [llms.txt](https://docs.duplocloud.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.duplocloud.com/docs/armor/additional-components/configuring-duplo-mcp-server.md).

# Configuring the DuploCloud MCP Server

The DuploCloud MCP (Model Context Protocol) server exposes your DuploCloud HelpDesk as a set of tools that AI assistants can call directly. Once configured, the assistant can create tickets, manage workspaces, agents, skills, environments, providers, and more — without leaving the chat interface.

This guide covers configuration in the **Claude desktop app** and **Claude Code (VSCode)**.

***

## Part 1 — Claude Desktop App

### Step 1 — Open Developer Settings

Open the Claude desktop app and go to **Settings → Developer** (under the Desktop app section in the left sidebar). The **Local MCP servers** panel shows all configured servers. Initially it is empty.

![](/files/CMB8kQTuJCgBVWHwHqx9)

### Step 2 — Edit the Config File

Click **Edit Config**. This opens `claude_desktop_config.json` in your editor — located at `~/Library/Application Support/Claude/claude_desktop_config.json`.

Add the `duplo-helpdesk` entry under `mcpServers`. Replace the URL with your HelpDesk endpoint and the Bearer token with your API token. To find the path to `npx`, run `which npx` in your terminal.

```json
{
  "mcpServers": {
    "duplo-helpdesk": {
      "command": "<full path to npx>",
      "args": [
        "-y",
        "mcp-remote",
        "https://helpdesk.duplo.yourcompany.com/mcp",
        "--header",
        "Authorization: Bearer <your API token>"
      ]
    }
  }
}
```

![](/files/HoI9VKTNgho4j3kTR7ix)

Save the file, then reload the Claude desktop app for the changes to take effect.

### Step 3 — Verify the Server is Running

Return to **Settings → Developer**. The `duplo-helpdesk` server now appears in the list with a **running** status. The panel shows the resolved command path and arguments. Click **View Logs** to inspect connection output if needed.

![](/files/PH6hLchdg4z8iea0XAa3)

### Step 4 — Confirm Access in Chat

Open a new chat and ask Claude whether it has access to the DuploCloud MCP server. Claude will confirm and list all available tool categories.

![](/files/c1500YcdpyRj1vn45USq)

***

## Part 2 — Claude Code (VSCode)

There are two ways to add the DuploCloud MCP server to Claude Code: via the CLI (recommended) or by manually editing `~/.claude.json`.

### Option 1 — CLI (Recommended)

Open the terminal in VSCode and run the following command, replacing the URL and token with your own:

```bash
claude mcp add --transport http duplo-helpdesk \
  "https://helpdesk.duplo.yourcompany.com/mcp" \
  --header "Authorization: Bearer <your-token>" \
  --scope use
```

![](/files/riG0mKpi2lAuwQO619Oe)

![](/files/deZM5h13k3vtyzoCiFQS)

The command confirms the server has been added and shows the URL and headers registered. It also confirms that `~/.claude.json` has been updated.

### Option 2 — Manual Edit

Open `~/.claude.json` in your editor and add the following entry inside the `mcpServers` object (create the key if it does not exist):

```json
"mcpServers": {
  "duplo-helpdesk": {
    "type": "http",
    "url": "https://helpdesk.duplo.yourcompany.com/mcp",
    "headers": {
      "Authorization": "Bearer <your API token>"
    }
  }
}
```

### Reload the Window

After adding the server via either method, reload the VSCode window to apply the changes. Open the command palette with **Cmd+Shift+P**, type **Reload Window**, and select **Developer: Reload Window**.

![](/files/pxPK03nF4W8zpyyASpCW)

### Verify the Connection

Once the window reloads, open the MCP servers panel in Claude Code by running `/mcp`. The `duplo-helpdesk` server appears under **User** with a **Connected** status.

![](/files/acChK1oWMlEKRLlwttqD)

### Confirm Access in Chat

Open a new Claude Code chat and ask whether Duplo MCP access is available. Claude confirms access to the `duplo-helpdesk` server and lists all available tool namespaces.

![](/files/BOs5wx0I38B8QGDlweWt)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.duplocloud.com/docs/armor/additional-components/configuring-duplo-mcp-server.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.