diff --git a/content/en/bits_ai/mcp_server/setup.md b/content/en/bits_ai/mcp_server/setup.md index fc881f358f6..12595adfdbb 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](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. 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](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. 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](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" >}}
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,7 @@ 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. - -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 -[2]: /getting_started/site/ +{{% /collapse-content %}} {{< /site-region >}} {{< site-region region="gov,gov2" >}} @@ -49,10 +53,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](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" >}} -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](/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](/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" >}}
@@ -71,11 +86,8 @@ 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.
- -[1]: /getting_started/site/ +{{% /collapse-content %}} {{< /site-region >}} {{< site-region region="gov,gov2" >}} @@ -84,7 +96,6 @@ Selected endpoint ({{< region-param key="dd_site_name" >}}): {{< region-pa {{< /site-region >}} -[1]: /getting_started/site/ {{% /tab %}} {{% tab "Codex" %}} @@ -570,8 +581,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 +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://claude.com/plugins/datadog +[54]: https://claude.ai/directory/connectors/datadog