# MCP

## DevDynamics MCP – Full Setup & Login Guide

A detailed, step-by-step manual to set up the DevDynamics MCP server, log in, and start using it in your chat tools.

## **Step 1 — Understand MCP (quickly)**

Model Context Protocol (MCP) lets your AI assistant securely access live data from DevDynamics. Instead of only using pre-trained knowledge, your assistant can call real tools like “get team data” and “get contributor data.”

## **Step 2 — Install Node.js**

• Download and install Node.js from [nodejs.org](http://nodejs.org).

• Open Console/ Terminal and verify with: node --version

## **Step 3 — Choose your client**

You can now connect your Devdynamics account to AI assistants like Claude, Cursor, and VScode(Copilot Agent mode).\
Linux users can use: unofficial Claude Desktop builds or Claude Code (CLI).

## **Step 4 — Configure Claude Desktop (Windows/macOS)**

1\) Open Claude Desktop → Settings → Developer → Edit Config.!\[]

<figure><img src="https://4171758421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4rgvJ71tpXan8RhYTT4%2Fuploads%2FJeg0kTTmgHf5dPNmxUZQ%2Fimage%20(176).png?alt=media&#x26;token=2d3c2917-1ad5-4e32-a6e6-3eb94731e93e" alt=""><figcaption></figcaption></figure>

2\) Paste this into claude\_desktop\_config.json and save:

```
{
"mcpServers": {
"Devdynamics MCP": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.devdynamics.ai/mcp"]
}
}
} 
```

3\) Fully quit and relaunch Claude Desktop.

4\) In a new chat, open the tools (hammer) icon and make sure **Devdynamics MCP** is enabled. If it doesn’t appear, restart once more.

## **Step 5 — Configure VS Code (Copilot Agent Mode)**

1\) Open Command Palette in VS Code.

It's opened with:

* Windows/Linux: `Ctrl + Shift + P`
* Mac: `Cmd + Shift + P`

Type MCP: Add Server

2\) Select **Command (stdio)** and enter: npx -y mcp-remote <https://mcp.devdynamics.ai/mcp>

3\) Give it a name (e.g., Devdynamics MCP) and choose a workspace.

4\) In Copilot Chat, click the tools gear and verify **Devdynamics MCP** is enabled.

<figure><img src="https://4171758421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4rgvJ71tpXan8RhYTT4%2Fuploads%2FALe91HSE9pXcC09DzFKI%2Fimage%20(177).png?alt=media&#x26;token=dbab5c54-e383-419b-86f7-20a8646da76e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4171758421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4rgvJ71tpXan8RhYTT4%2Fuploads%2Fey4KEI5GADDs79nWIkbE%2Fimage%20(181).png?alt=media&#x26;token=0c6c7a73-409f-4208-8ec5-a013a0de670b" alt=""><figcaption></figcaption></figure>

## **Step 6 — Linux options (if you don’t use macOS/Windows)**

• Unofficial Claude Desktop builds ([aaddrick](https://github.com/aaddrick/claude-desktop-debian) Debian/Ubuntu or [k3d3 Nix flake](https://github.com/k3d3/claude-desktop-linux-flake)).

• After install, put the same JSON in \~/.config/Claude/claude\_desktop\_config.json.

• Or use **Claude Code** (npm). Run “claude”, then “/mcp add” and provide the remote URL: <https://mcp.devdynamics.ai/mcp>

## **Step 7 — Trigger MCP on your first message**

Include **devdynamics** in your opening message, or mention a tool name like **get team data** or **get contributor data**. This ensures MCP starts immediately. MCP will check your login status automatically.

## **Step 8 — Start the login flow (from chat)**

When MCP detects you’re not logged in, it posts a login card with a unique link. Click the link to authenticate.

<figure><img src="https://4171758421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4rgvJ71tpXan8RhYTT4%2Fuploads%2F2n2TDsRFsreQpTFUXtIA%2Fimage%20(178)-redacted_dot_app-redacted_dot_app.png?alt=media&#x26;token=f69cdc3d-5745-4281-ae37-145f9adecaac" alt=""><figcaption></figcaption></figure>

## **Step 9 — Sign in to DevDynamics**

Use your DevDynamics email and password to sign in on the authorization screen.

<figure><img src="https://4171758421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4rgvJ71tpXan8RhYTT4%2Fuploads%2FumPbb3zg5CWjq2fmzbzR%2Fimage%20(179)-redacted_dot_app.png?alt=media&#x26;token=61fc9b5e-06b0-44ce-b4ba-eed1d1824ea6" alt=""><figcaption></figcaption></figure>

## **Step 10 — Confirm authentication**

After a successful login you’ll see a confirmation message. Close the browser tab and go back to your chat window.

<figure><img src="https://4171758421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4rgvJ71tpXan8RhYTT4%2Fuploads%2FkyqHdgc5UqTnCP9gsqaW%2Fimage%20(182).png?alt=media&#x26;token=6dd266d5-ed2d-43a3-99da-49bf752b686a" alt=""><figcaption></figcaption></figure>

## **Step 11 — Use DevDynamics MCP (example first)**

Here is an example right after login. MCP first checks your login status, then fetches live data.

<figure><img src="https://4171758421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4rgvJ71tpXan8RhYTT4%2Fuploads%2F0GKtqNj4jBSZtuoz7gkH%2Fimage%20(180)-redacted_dot_app.png?alt=media&#x26;token=a0610fd3-9072-48e9-a2a5-d4437e6971a0" alt=""><figcaption></figcaption></figure>

Other things you can ask (short examples): team summaries, PR/issue metrics like cycle time, sprint progress and goals, and monthly engineering summaries. Use natural language—MCP understands common team and delivery questions.

## **Step 12 — Tips & Troubleshooting**

• If the Devdynamics MCP tool is missing, restart your client and re-check the config file.

• If you’re asked to log in again, your session expired—click the link and authenticate once more.

• Behind a proxy or firewall, allow access to <https://mcp.devdynamics.ai/>

• To trigger MCP reliably in new chats, include the word **devdynamics** in your opening message.