Skip to content

Update MCP docs: recommend custom connectors for Claude Desktop & claude.ai #35285

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
rgwood-dd wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

Update MCP docs: recommend custom connectors for Claude Desktop & claude.ai #35285

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 19 additions & 29 deletions content/en/bits_ai/mcp_server/setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -108,39 +108,27 @@ Use this option if remote authentication is not available. After installation, y
[1]: /getting_started/site/
{{% /tab %}}

{{% tab "Claude Desktop" %}}
{{% tab "Claude Desktop & claude.ai" %}}

Claude Desktop has limited support for remote authentication. Use **local binary authentication** for reliable setup.
Connect Claude Desktop or claude.ai to the Datadog MCP Server by adding it as a **custom connector** with the remote MCP URL.

1. Install the Datadog MCP Server binary:

- macOS and Linux: Install the binary to `~/.local/bin/datadog_mcp_cli`:

```bash
curl -sSL https://coterm.datadoghq.com/mcp-cli/install.sh | bash
```
{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
1. Follow the [Claude help center guide on custom connectors][1] to add a new custom connector.
2. When prompted for a URL, enter the Datadog MCP Server endpoint for your [Datadog site][2] ({{< region-param key="dd_site_name" >}}):
<pre><code>{{< region-param key="mcp_server_endpoint" >}}</code></pre>
3. Complete the OAuth login flow when prompted.

- Windows: Download the [Windows version][1].
[1]: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp
[2]: /getting_started/site/
{{< /site-region >}}

2. Run `datadog_mcp_cli login` manually to walk through the OAuth login flow and choose a [Datadog site][2].
{{< site-region region="gov" >}}
Point your AI agent to the MCP Server endpoint for your regional [Datadog site][1].

3. Configure Claude Desktop to use the Datadog MCP Server. Add to your Claude Desktop configuration (location varies by OS) with the `stdio` transport pointing to `datadog_mcp_cli`:
```json
{
"mcpServers": {
"datadog": {
"type": "stdio",
"command": "/Users/<USERNAME>/.local/bin/datadog_mcp_cli",
"args": [],
"env": {}
}
}
}
```
On Windows, replace the `command` path with the location of the downloaded `.exe` file (for example, `C:\Users\<USERNAME>\bin\datadog_mcp_cli.exe`).
<div class="alert alert-danger">Datadog MCP Server is not supported for your selected site ({{< region-param key="dd_site_name" >}}).</div>

[1]: https://coterm.datadoghq.com/mcp-cli/datadog_mcp_cli.exe
[2]: /getting_started/site/
[1]: /getting_started/site/
{{< /site-region >}}

{{% /tab %}}

Expand Down Expand Up @@ -341,7 +329,8 @@ Local authentication is recommended for Cline and when remote authentication is
|--------|------|------|
| [Cursor][3] | Cursor | Datadog [Cursor & VS Code extension][15] recommended. |
| [Claude Code][4] | Anthropic | |
| [Claude&nbsp;Desktop][5] | Anthropic | Limited support for remote authentication. Use [local binary authentication](?tab=claude-desktop#installation) as needed. |
| [claude.ai][19] | Anthropic | Use [custom connector setup](?tab=claude-desktop--claude.ai#installation). |
| [Claude&nbsp;Desktop][5] | Anthropic | Use [custom connector setup](?tab=claude-desktop--claude.ai#installation). |
| [Codex CLI][6] | OpenAI | |
| [VS Code][7] | Microsoft | Datadog [Cursor & VS Code extension][16] recommended. |
| [JetBrains IDEs][18] | JetBrains | [Datadog plugin][18] recommended. |
Expand Down Expand Up @@ -411,4 +400,5 @@ For security, use a scoped API key and application key from a [service account][
[15]: /ide_plugins/vscode/?tab=cursor
[16]: /ide_plugins/vscode/
[17]: /getting_started/site/#navigate-the-datadog-documentation-by-site
[18]: /ide_plugins/idea/
[18]: /ide_plugins/idea/
[19]: https://claude.ai
Loading