From 3bcd273be889c8f4906224b2326457b5e3071336 Mon Sep 17 00:00:00 2001 From: Sumedha Mehta Date: Wed, 13 May 2026 13:22:36 -0400 Subject: [PATCH 1/3] Recommend Datadog plugin/connector as default for Claude clients The Datadog plugin for Claude Code and the Datadog Connector for Claude are now GA. Make these the recommended install paths on the MCP Server setup page, since they remove the manual MCP-configuration friction that gates adoption. - Claude Code tab: lead with /plugin marketplace add DataDog/claude-marketplace + /ddsetup; collapse the existing claude mcp add / ~/.claude.json flow into a "manual MCP Server configuration" fallback - Claude tab: lead with the directory connector + Add Connector flow; collapse the existing custom-connector URL flow into a "manual setup with a custom connector" fallback - Supported clients table: note the plugin/connector as recommended for the two clients Co-Authored-By: Claude Opus 4.7 (1M context) --- content/en/bits_ai/mcp_server/setup.md | 47 +++++++++++++++++++------- 1 file changed, 34 insertions(+), 13 deletions(-) diff --git a/content/en/bits_ai/mcp_server/setup.md b/content/en/bits_ai/mcp_server/setup.md index fc881f358f6..df4f08284e3 100644 --- a/content/en/bits_ai/mcp_server/setup.md +++ b/content/en/bits_ai/mcp_server/setup.md @@ -21,12 +21,20 @@ Learn how to set up and configure the Datadog MCP Server, which lets you retriev {{< tabs >}} {{% tab "Claude" %}} -Connect Claude (including Claude Cowork) to the Datadog MCP Server by adding it as a {{< ui >}}custom connector{{< /ui >}} with the remote MCP URL. +Install the [Datadog Connector][1] from the Claude Connectors Directory—the official connector is the recommended way to connect Datadog to Claude (including Claude Cowork) and includes MCP Apps for in-product visualizations. If you previously added Datadog as a custom connector, remove it to avoid conflicts. {{< 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. +1. In Claude, click the **+** icon at the bottom of any prompt, then click {{< ui >}}Add Connector{{< /ui >}}. +1. Find **Datadog** in the directory and enable it. +1. Complete the OAuth login flow when prompted. +1. Verify that you have the required [permissions](#required-permissions) for the Datadog resources you want to access. + +{{% collapse-content title="Manual setup with a custom connector" level="h4" expanded=false id="claude-custom-connector" %}} +If the directory connector is not available to you, you can add Datadog as a [custom connector][3] using the remote MCP URL for your [Datadog site][2] ({{< region-param key="dd_site_name" >}}). For the correct instructions, use the {{< ui >}}Datadog Site{{< /ui >}} selector on the right side of this documentation page to select your site. -1. When prompted for a URL, enter the Datadog MCP Server endpoint for your [Datadog site][2] ({{< region-param key="dd_site_name" >}}). For the correct instructions, use the {{< ui >}}Datadog Site{{< /ui >}} selector on the right side of this documentation page to select your site. +1. Follow the Claude help center guide on [custom connectors][3] to add a new custom connector. + +1. When prompted for a URL, enter: 
{{< region-param key="mcp_server_endpoint" >}}
To enable [product-specific tools](#toolsets), include the `toolsets` query parameter at the end of the endpoint URL. For example, this URL enables _only_ APM and LLM Observability tools (use `toolsets=all` to enable all generally available toolsets, best for clients that support tool filtering): @@ -34,11 +42,11 @@ Connect Claude (including Claude Cowork) to the Datadog MCP Server by adding it 
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
1. Complete the OAuth login flow when prompted. +{{% /collapse-content %}} -1. Verify that you have the required [permissions](#required-permissions) for the Datadog resources you want to access. - -[1]: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp +[1]: https://claude.ai/directory [2]: /getting_started/site/ +[3]: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp {{< /site-region >}} {{< site-region region="gov,gov2" >}} @@ -49,10 +57,21 @@ Connect Claude (including Claude Cowork) to the Datadog MCP Server by adding it {{% tab "Claude Code" %}} -Point your AI agent to the MCP Server endpoint for your regional [Datadog site][1]. For the correct instructions, use the {{< ui >}}Datadog Site{{< /ui >}} selector on the right side of this documentation page to select your site. +Install the [Datadog plugin][2] from the [Claude Code Plugin Marketplace][3]—the plugin packages the Datadog MCP Server with the `/ddsetup` slash command for first-time configuration, and auto-updates as new toolsets and skills ship. If you previously installed the Datadog MCP Server manually, remove it from your Claude Code configuration to avoid conflicts. {{< site-region region="us,us3,us5,eu,ap1,ap2" >}} -Selected endpoint ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}. +1. Add the Datadog marketplace to Claude Code: + 
/plugin marketplace add DataDog/claude-marketplace
+ +1. Install the Datadog plugin when prompted, or run: + 
/plugin install datadog@datadog
+ +1. Run `/ddsetup` to choose your [Datadog site][1] and organization. + +1. Verify that you have the required [permissions](#required-permissions) for the Datadog resources you want to access. + +{{% collapse-content title="Manual MCP Server configuration" level="h4" expanded=false id="claudecode-manual" %}} +If the plugin is not available to you, point Claude Code at the MCP Server endpoint for your regional [Datadog site][1] directly. Selected endpoint ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}. 1. Run in terminal: 
claude mcp add --transport http datadog-mcp {{< region-param key="mcp_server_endpoint" >}}
@@ -71,11 +90,11 @@ Selected endpoint ({{< region-param key="dd_site_name" >}}): {{< region-pa 
{{< region-param key="mcp_server_endpoint" >}}?toolsets=apm,llmobs
-1. Verify that you have the required [permissions](#required-permissions) for the Datadog resources you want to access. -
If remote authentication is not available, use local binary authentication instead.
+{{% /collapse-content %}} -[1]: /getting_started/site/ +[2]: https://github.com/DataDog/claude-marketplace +[3]: https://docs.claude.com/en/docs/claude-code/plugin-marketplaces {{< /site-region >}} {{< site-region region="gov,gov2" >}} @@ -570,8 +589,8 @@ These toolsets are in Preview. Sign up for a toolset by completing the Product P | Client | Developer | Notes | |--------|------|------| | [Cursor][3] | Cursor | Datadog [Cursor & VS Code extension][15] recommended. | -| [Claude Code][4] | Anthropic | | -| [Claude][19] | Anthropic | Use [custom connector setup](?tab=claude#installation). Includes Claude Cowork. | +| [Claude Code][4] | Anthropic | Datadog [Claude Code plugin][53] recommended. | +| [Claude][19] | Anthropic | Datadog [Claude Connector][54] recommended. Includes Claude Cowork. | | [Codex CLI][6] | OpenAI | | | [Gemini CLI][50] | Google | | | [Warp][28] | Warp | | @@ -739,3 +758,5 @@ Local authentication is recommended for Cline and when remote authentication is [49]: /bits_ai/mcp_server/tools [50]: https://github.com/google-gemini/gemini-cli [51]: /containers/monitoring/kubernetes_explorer/ +[53]: https://github.com/DataDog/claude-marketplace +[54]: https://claude.ai/directory From ad73c8b9c21f04a907c1f2f777b15934c7a10043 Mon Sep 17 00:00:00 2001 From: Sumedha Mehta Date: Wed, 13 May 2026 15:23:30 -0400 Subject: [PATCH 2/3] Inline URLs and drop em dashes in Claude tabs Reference-style markdown links do not resolve inside tab blocks in this docs build. Hardcode the URLs inline in the Claude and Claude Code tabs, and remove the now-orphaned reference definitions. Also replace the em dashes in the lead-in sentences with periods. Co-Authored-By: Claude Opus 4.7 (1M context) --- content/en/bits_ai/mcp_server/setup.md | 20 ++++++-------------- 1 file changed, 6 insertions(+), 14 deletions(-) diff --git a/content/en/bits_ai/mcp_server/setup.md b/content/en/bits_ai/mcp_server/setup.md index df4f08284e3..a8fbf7f22fa 100644 --- a/content/en/bits_ai/mcp_server/setup.md +++ b/content/en/bits_ai/mcp_server/setup.md @@ -21,7 +21,7 @@ Learn how to set up and configure the Datadog MCP Server, which lets you retriev {{< tabs >}} {{% tab "Claude" %}} -Install the [Datadog Connector][1] from the Claude Connectors Directory—the official connector is the recommended way to connect Datadog to Claude (including Claude Cowork) and includes MCP Apps for in-product visualizations. If you previously added Datadog as a custom connector, remove it to avoid conflicts. +Install the [Datadog Connector](https://claude.ai/directory) from the Claude Connectors Directory. The official connector is the recommended way to connect Datadog to Claude (including Claude Cowork) and includes MCP Apps for in-product visualizations. If you previously added Datadog as a custom connector, remove it to avoid conflicts. {{< site-region region="us,us3,us5,eu,ap1,ap2" >}} 1. In Claude, click the **+** icon at the bottom of any prompt, then click {{< ui >}}Add Connector{{< /ui >}}. @@ -30,9 +30,9 @@ Install the [Datadog Connector][1] from the Claude Connectors Directory—the of 1. Verify that you have the required [permissions](#required-permissions) for the Datadog resources you want to access. {{% collapse-content title="Manual setup with a custom connector" level="h4" expanded=false id="claude-custom-connector" %}} -If the directory connector is not available to you, you can add Datadog as a [custom connector][3] using the remote MCP URL for your [Datadog site][2] ({{< region-param key="dd_site_name" >}}). For the correct instructions, use the {{< ui >}}Datadog Site{{< /ui >}} selector on the right side of this documentation page to select your site. +If the directory connector is not available to you, you can add Datadog as a [custom connector](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) using the remote MCP URL for your [Datadog site](/getting_started/site/) ({{< region-param key="dd_site_name" >}}). For the correct instructions, use the {{< ui >}}Datadog Site{{< /ui >}} selector on the right side of this documentation page to select your site. -1. Follow the Claude help center guide on [custom connectors][3] to add a new custom connector. +1. Follow the Claude help center guide on [custom connectors](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) to add a new custom connector. 1. When prompted for a URL, enter: 
{{< region-param key="mcp_server_endpoint" >}}
@@ -43,10 +43,6 @@ If the directory connector is not available to you, you can add Datadog as a [cu 1. Complete the OAuth login flow when prompted. {{% /collapse-content %}} - -[1]: https://claude.ai/directory -[2]: /getting_started/site/ -[3]: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp {{< /site-region >}} {{< site-region region="gov,gov2" >}} @@ -57,7 +53,7 @@ If the directory connector is not available to you, you can add Datadog as a [cu {{% tab "Claude Code" %}} -Install the [Datadog plugin][2] from the [Claude Code Plugin Marketplace][3]—the plugin packages the Datadog MCP Server with the `/ddsetup` slash command for first-time configuration, and auto-updates as new toolsets and skills ship. If you previously installed the Datadog MCP Server manually, remove it from your Claude Code configuration to avoid conflicts. +Install the [Datadog plugin](https://github.com/DataDog/claude-marketplace) from the [Claude Code Plugin Marketplace](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces). The plugin packages the Datadog MCP Server with the `/ddsetup` slash command for first-time configuration, and auto-updates as new toolsets and skills ship. If you previously installed the Datadog MCP Server manually, remove it from your Claude Code configuration to avoid conflicts. {{< site-region region="us,us3,us5,eu,ap1,ap2" >}} 1. Add the Datadog marketplace to Claude Code: @@ -66,12 +62,12 @@ Install the [Datadog plugin][2] from the [Claude Code Plugin Marketplace][3]—t 1. Install the Datadog plugin when prompted, or run: 
/plugin install datadog@datadog
-1. Run `/ddsetup` to choose your [Datadog site][1] and organization. +1. Run `/ddsetup` to choose your [Datadog site](/getting_started/site/) and organization. 1. Verify that you have the required [permissions](#required-permissions) for the Datadog resources you want to access. {{% collapse-content title="Manual MCP Server configuration" level="h4" expanded=false id="claudecode-manual" %}} -If the plugin is not available to you, point Claude Code at the MCP Server endpoint for your regional [Datadog site][1] directly. Selected endpoint ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}. +If the plugin is not available to you, point Claude Code at the MCP Server endpoint for your regional [Datadog site](/getting_started/site/) directly. Selected endpoint ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}. 1. Run in terminal: 
claude mcp add --transport http datadog-mcp {{< region-param key="mcp_server_endpoint" >}}
@@ -92,9 +88,6 @@ If the plugin is not available to you, point Claude Code at the MCP Server endpo
If remote authentication is not available, use local binary authentication instead.
{{% /collapse-content %}} - -[2]: https://github.com/DataDog/claude-marketplace -[3]: https://docs.claude.com/en/docs/claude-code/plugin-marketplaces {{< /site-region >}} {{< site-region region="gov,gov2" >}} @@ -103,7 +96,6 @@ If the plugin is not available to you, point Claude Code at the MCP Server endpo {{< /site-region >}} -[1]: /getting_started/site/ {{% /tab %}} {{% tab "Codex" %}} From 9bbbe019306a9158c2f06f170443d04f4a103e22 Mon Sep 17 00:00:00 2001 From: Sumedha Mehta Date: Wed, 13 May 2026 15:30:22 -0400 Subject: [PATCH 3/3] Update Claude plugin and connector links to the canonical URLs Use the GA marketing pages instead of the GitHub repo and directory root: - Datadog plugin: https://claude.com/plugins/datadog - Datadog Connector: https://claude.ai/directory/connectors/datadog Updates the inline links in both tabs and the supported-clients table footer references. Co-Authored-By: Claude Opus 4.7 (1M context) --- content/en/bits_ai/mcp_server/setup.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/bits_ai/mcp_server/setup.md b/content/en/bits_ai/mcp_server/setup.md index a8fbf7f22fa..12595adfdbb 100644 --- a/content/en/bits_ai/mcp_server/setup.md +++ b/content/en/bits_ai/mcp_server/setup.md @@ -21,7 +21,7 @@ Learn how to set up and configure the Datadog MCP Server, which lets you retriev {{< tabs >}} {{% tab "Claude" %}} -Install the [Datadog Connector](https://claude.ai/directory) from the Claude Connectors Directory. The official connector is the recommended way to connect Datadog to Claude (including Claude Cowork) and includes MCP Apps for in-product visualizations. If you previously added Datadog as a custom connector, remove it to avoid conflicts. +Install the [Datadog Connector](https://claude.ai/directory/connectors/datadog) from the Claude Connectors Directory. The official connector is the recommended way to connect Datadog to Claude (including Claude Cowork) and includes MCP Apps for in-product visualizations. If you previously added Datadog as a custom connector, remove it to avoid conflicts. {{< site-region region="us,us3,us5,eu,ap1,ap2" >}} 1. In Claude, click the **+** icon at the bottom of any prompt, then click {{< ui >}}Add Connector{{< /ui >}}. @@ -53,7 +53,7 @@ If the directory connector is not available to you, you can add Datadog as a [cu {{% tab "Claude Code" %}} -Install the [Datadog plugin](https://github.com/DataDog/claude-marketplace) from the [Claude Code Plugin Marketplace](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces). The plugin packages the Datadog MCP Server with the `/ddsetup` slash command for first-time configuration, and auto-updates as new toolsets and skills ship. If you previously installed the Datadog MCP Server manually, remove it from your Claude Code configuration to avoid conflicts. +Install the [Datadog plugin](https://claude.com/plugins/datadog) from the [Claude Code Plugin Marketplace](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces). The plugin packages the Datadog MCP Server with the `/ddsetup` slash command for first-time configuration, and auto-updates as new toolsets and skills ship. If you previously installed the Datadog MCP Server manually, remove it from your Claude Code configuration to avoid conflicts. {{< site-region region="us,us3,us5,eu,ap1,ap2" >}} 1. Add the Datadog marketplace to Claude Code: @@ -750,5 +750,5 @@ Local authentication is recommended for Cline and when remote authentication is [49]: /bits_ai/mcp_server/tools [50]: https://github.com/google-gemini/gemini-cli [51]: /containers/monitoring/kubernetes_explorer/ -[53]: https://github.com/DataDog/claude-marketplace -[54]: https://claude.ai/directory +[53]: https://claude.com/plugins/datadog +[54]: https://claude.ai/directory/connectors/datadog