Skip to content

README.md

Latest commit

 

History

History
49 lines (32 loc) · 2.68 KB

README.md

File metadata and controls

49 lines (32 loc) · 2.68 KB

@sentry/junior-datadog

Warning

This plugin does not currently work. Datadog's hosted MCP server requires OAuth Dynamic Client Registration (DCR, RFC 7591) for third-party clients like Junior, and DCR is locked down on Datadog's side. Until Datadog exposes DCR (or an equivalent registration path) on mcp.datadoghq.com, Junior cannot complete the OAuth handshake and every Datadog tool call will fail.

The package is kept in-tree so the integration is ready to ship the moment Datadog unblocks DCR. Do not add it to a production deployment in the meantime.

@sentry/junior-datadog adds read-only Datadog telemetry workflows to Junior through Datadog's hosted MCP server.

Install it alongside @sentry/junior:

pnpm add @sentry/junior @sentry/junior-datadog

Then register the plugin package in juniorNitro(...):

juniorNitro({
  pluginPackages: ["@sentry/junior-datadog"],
});

This package does not use DD_API_KEY, DD_APP_KEY, or a shared workspace integration. Each user connects their own Datadog account the first time Junior calls a Datadog MCP tool. Junior sends the OAuth link privately and resumes the thread automatically after the user authorizes.

Junior intentionally keeps this package read-only by limiting the MCP tool surface to search, fetch, and log analytics tools. The plugin does not expose notebook writes, monitor edits, or other mutating Datadog tools.

Datadog site

The packaged manifest defaults to the US1 endpoint (mcp.datadoghq.com) and enables the core, apm, and error-tracking toolsets. Teams on other Datadog sites (US3, US5, EU, AP1, AP2, GovCloud) set DATADOG_SITE in their Junior deployment env to their site host (e.g. us5.datadoghq.com, datadoghq.eu, ddog-gov.com). No code changes or plugin copy needed. See the Datadog plugin docs for the full site table.

Optional channel defaults

If a Slack channel usually investigates the same Datadog environment or service, store that as a conversation-scoped default:

jr-rpc config set datadog.env prod
jr-rpc config set datadog.service checkout

These defaults are optional fallbacks. If a user names a different env or service in a request, Junior should follow the explicit request instead.

Auth model

  • Datadog MCP requires user-based OAuth (OAuth 2.1 + PKCE) and does not accept shared bearer tokens here.
  • This package is not suitable for fully headless or unattended automation.
  • Users can disconnect from Junior App Home with Unlink, or by asking Junior to disconnect Datadog.

Full setup guide: https://junior.sentry.dev/extend/datadog-plugin/