diff --git a/develop-docs/engineering-practices/ai-assisted-development.mdx b/develop-docs/engineering-practices/ai-assisted-development.mdx index c619f9b65a3ca..17624ef4ef51a 100644 --- a/develop-docs/engineering-practices/ai-assisted-development.mdx +++ b/develop-docs/engineering-practices/ai-assisted-development.mdx @@ -90,18 +90,22 @@ Run `/agents` to get started, or see the [custom agents documentation](https://c Connect your AI assistant to the services your team already uses. These are the MCP servers and CLIs we've found most useful at Sentry. -| Tool | What it gives you | Setup | -| ---- | ----------------- | ----- | -| [Sentry MCP](https://docs.sentry.io/product/sentry-mcp/) | Query errors, search issues, analyze traces, and get root cause analysis directly from your editor. | `claude mcp add sentry -- npx @sentry/mcp` | -| [Linear MCP](https://github.com/jerhadf/linear-mcp-server) | Create, search, and update Linear issues without leaving your session. Great for turning bug findings into tickets on the spot. | See repo README | -| [Notion MCP](https://github.com/makenotion/notion-mcp-server) | Search and read Notion pages. Useful for pulling in specs, RFCs, and team docs as context. | See repo README | -| [Slack MCP](https://github.com/nicholasgriffintn/slack-mcp-server) | Read Slack threads and channels. Paste a bug report thread and say "fix." | See repo README | + + When connecting AI tools to external services, review and follow Sentry's LLM data access policies to avoid sending any sensitive customer data. + + +| Tool | What it gives you | +| ---- | ----------------- | +| [Sentry MCP](https://docs.sentry.io/product/sentry-mcp/) | Query errors, search issues, analyze traces, and get root cause analysis directly from your editor. | +| [Linear MCP](https://github.com/jerhadf/linear-mcp-server) | Create, search, and update Linear issues without leaving your session. | +| [Notion MCP](https://github.com/makenotion/notion-mcp-server) | Search and read Notion pages. Useful for pulling in specs, RFCs, and team docs as context. | +| [Slack MCP](https://github.com/nicholasgriffintn/slack-mcp-server) | Read Slack threads and channels. Paste a bug report thread and say "fix." | #### CLIs AI assistants can use any CLI tool you have installed. A few that work especially well: -- **`gcloud`** — Fetch logs, query BigQuery, and inspect GCP resources. Point Claude at `gcloud logging read` output to troubleshoot production issues. +- **`gcloud`** — Fetch logs, query BigQuery, and inspect GCP resources. - **`gh`** — Read PRs, issues, CI logs, and review comments from GitHub. - **`bq`** — Run BigQuery queries for ad-hoc analytics (see [Data & Analytics](#data--analytics)).