{"article":{"id":48004395674011,"url":"https://zeroheightsupport.zendesk.com/api/v2/help_center/en-us/articles/48004395674011.json","html_url":"https://help.zeroheight.com/hc/en-us/articles/48004395674011-zeroheight-MCP-overview","author_id":7296095922715,"comments_disabled":true,"draft":false,"promoted":false,"position":0,"vote_sum":1,"vote_count":1,"upvote_count":1,"downvote_count":0,"section_id":48047026729883,"created_at":"2026-03-19T11:29:27Z","updated_at":"2026-11-19T09:42:53Z","name":"zeroheight MCP overview","title":"zeroheight MCP overview","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-19T09:42:53Z","user_segment_id":null,"permission_group_id":6414167334427,"content_tag_ids":[],"label_names":[],"body":"<div class=\"call-out call-out--information\">Available on all plans. Free and Starter are limited to 500 calls per month. Search requires an Enterprise plan with AI features enabled.<a class=\"c-link c-link--focus-visible\" href=\"https://zeroheight.com/pricing\" target=\"_blank\" rel=\"noopener noreferrer\" tabindex=\"-1\" data-stringify-link=\"https://zeroheight.com/pricing\" data-sk=\"tooltip_parent\" data-remove-tab-index=\"true\"> Upgrade</a> for higher limits and other premium features.</div><p>The zeroheight MCP server connects AI tools like Claude, Cursor, Figma Make and GitHub Copilot to your design system. Your AI tool can read your documentation, components and tokens as it works — so the answers it gives, and the code it writes, stay aligned with your design system without you pasting guidelines into every prompt.</p><p>It works in both directions. With <strong>MCP write</strong>, admins and editors can also have their agent create and edit pages in zeroheight, using the context it already has from your codebase, Figma files and other tools.</p><h2 id=\"h_01KM2X8EBGXVYRA3ACVD3DRNCA\">What you can do</h2><p>Four main workflows benefit from connecting AI tools to zeroheight:</p><figure class=\"wysiwyg-table\" style=\"width: 100%;\"><table class=\"wysiwyg-table-resized\" style=\"margin-left: 0px; margin-right: auto;\">\n<colgroup>\n<col style=\"width: 38%;\">\n<col style=\"width: 62%;\">\n</colgroup>\n<tbody>\n<tr>\n<td>Workflow</td>\n<td>What the MCP enables</td>\n</tr>\n<tr>\n<td>\n<p>Traditional design + handoff</p>\n<p>Designers work in Figma, developers build in VS Code or Cursor</p>\n</td>\n<td>Developers and designers can ask their AI tool questions about the design system — which component to use, what the spacing rules are, how to implement a pattern — without leaving their editor.</td>\n</tr>\n<tr>\n<td>\n<p>AI-accelerated prototyping</p>\n<p>PMs and designers using vibe-coding tools like Figma Make</p>\n</td>\n<td>The AI prototyping tool has direct access to your documented guidelines and components, so generated prototypes stay aligned with the design system from the start.</td>\n</tr>\n<tr>\n<td>\n<p>Full AI-driven development</p>\n<p>Engineers using AI agents to generate production code</p>\n</td>\n<td>The coding agent reads your design system documentation as it generates code, so compliance is baked in rather than checked afterwards.</td>\n</tr>\n<tr>\n<td>\n<p>Maintaining documentation</p>\n<p>Admins and editors using agents to create and update pages</p>\n</td>\n<td>With MCP write, an agent can draft a new page from your codebase or Figma files, make targeted edits to an existing page, work through review comments and merge drafts — all from the conversation. <a href=\"https://help.zeroheight.com/hc/en-us/articles/54955157637659\">Learn more about writing to zeroheight via MCP.</a>\n</td>\n</tr>\n</tbody>\n</table></figure><p>Coding agents can also check the style values in your code against your design tokens and swap in the right token where it's safe. <a href=\"https://help.zeroheight.com/hc/en-us/articles/47435348091291\">Learn more about token linting.</a></p><h2 id=\"h_01M5WAYS2C0NNECT00000000001\">Ways to connect</h2><p>There are three ways to connect an AI tool to zeroheight. Which one to use depends on who's connecting and how they sign in to zeroheight.</p><figure class=\"wysiwyg-table\" style=\"width: 100%;\"><table class=\"wysiwyg-table-resized\" style=\"margin-left: 0px; margin-right: auto;\">\n<colgroup>\n<col style=\"width: 19%;\">\n<col style=\"width: 27%;\">\n<col style=\"width: 27%;\">\n<col style=\"width: 27%;\">\n</colgroup>\n<thead><tr>\n<th> </th>\n<th>Remote MCP</th>\n<th>Access via link</th>\n<th>Local MCP server</th>\n</tr></thead>\n<tbody>\n<tr>\n<td>Who it's for</td>\n<td>Admins and editors, viewers who sign in to zeroheight via SSO, private viewers, guests on Public styleguides, and CI/CD pipelines</td>\n<td>Not recommended for new connections. Being deprecated, and only supported while existing connections move to your team's MCP URL</td>\n<td>Teams whose organization restricts remote MCP connections</td>\n</tr>\n<tr>\n<td>How you connect</td>\n<td>Sign in to zeroheight from your AI tool, with your username and password or via SSO. Private viewers use a one-time code sent to their email, and guests connect without signing in. Or send API credentials as headers (Enterprise)</td>\n<td>A unique URL per person, per styleguide. No sign-in needed, so anyone with the URL can connect</td>\n<td>Runs on your machine. Signs in through your browser by default, or uses your zeroheight API Client ID and Access Token</td>\n</tr>\n<tr>\n<td>Private pages</td>\n<td>Accessible, except for private viewers and guests</td>\n<td>Not accessible</td>\n<td>Accessible</td>\n</tr>\n<tr>\n<td>Write access</td>\n<td>Admins and editors, when signed in and MCP write is enabled. Read only with API credentials</td>\n<td>Read only</td>\n<td>Admins and editors, when signed in and MCP write is enabled. Read only with API credentials</td>\n</tr>\n<tr>\n<td>Setup guide</td>\n<td><a href=\"https://help.zeroheight.com/hc/en-us/articles/51467311835803\">Set up MCP access via login</a></td>\n<td><a href=\"https://help.zeroheight.com/hc/en-us/articles/43737291730331\">Set up MCP access via link</a></td>\n<td><a href=\"https://help.zeroheight.com/hc/en-us/articles/39914754674843\">Set up the local MCP server</a></td>\n</tr>\n</tbody>\n</table></figure><p>Admins control which methods are enabled for the organization under <strong>Your organization → MCP</strong> (or the <strong>zeroheight MCP</strong> shortcut in your profile menu), and which styleguides each method can reach under <strong>Styleguide settings → MCP</strong>. These settings don't apply to connections that use API credentials.</p><h2 id=\"h_01KM2XG6YFWKJFH81PHVXKAYMV\">Get started</h2><p>If you're a zeroheight admin or editor, the quickest way to try the MCP is to add the following URL as a custom MCP server in your AI tool:</p><p><a href=\"https://mcp.zeroheight.com/mcp\"><code>https://mcp.zeroheight.com/mcp</code></a></p><p>Your tool will prompt you to sign in with your zeroheight account.</p><p>For <strong>Cursor</strong>, <strong>VS Code</strong>, <strong>Claude Code</strong>, <strong>Codex</strong> and <strong>Kiro</strong>, you can find one-click and copy-paste installation commands under <strong>Styleguide settings → MCP</strong>.</p><p>If you're using <a href=\"https://help.figma.com/hc/en-us/articles/35440096186007\" target=\"_blank\" rel=\"noopener noreferrer\"><strong>Figma</strong></a><strong>, </strong> <a href=\"https://chatgpt.com/apps/zeroheight/asdk_app_69cd22ef3fcc819197d418b99a2db6e6\" target=\"_blank\" rel=\"noopener noreferrer\"><strong>ChatGPT/Codex</strong></a> or <a href=\"https://claude.ai/directory/connectors/7a89a36d-94db-40c5-98e9-d7615e9c6edb\" target=\"_blank\" rel=\"noopener noreferrer\"><strong>Claude</strong></a> connect via the respective partner connector.</p><p>For all other tools, see their documentation:</p><p><a href=\"https://code.claude.com/docs/en/mcp\" target=\"_blank\" rel=\"noopener noreferrer\">Claude Code</a> · <a href=\"https://code.visualstudio.com/docs/agent-customization/mcp-servers\" target=\"_blank\" rel=\"noopener noreferrer\">VS Code + GitHub Copilot</a> · <a href=\"https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers\" target=\"_blank\" rel=\"noopener noreferrer\">GitHub Copilot CLI</a> · <a href=\"https://docs.windsurf.com/windsurf/cascade/mcp\" target=\"_blank\" rel=\"noopener noreferrer\">Windsurf</a> · <a href=\"https://zed.dev/docs/ai/mcp\" target=\"_blank\" rel=\"noopener noreferrer\">Zed</a> · <a href=\"https://www.jetbrains.com/help/air/mcp-servers.html\" target=\"_blank\" rel=\"noopener noreferrer\">JetBrains AI</a> · <a href=\"https://geminicli.com/docs/tools/mcp-server/\" target=\"_blank\" rel=\"noopener noreferrer\">Gemini CLI</a> · <a href=\"https://opencode.ai/docs/mcp-servers/\" target=\"_blank\" rel=\"noopener noreferrer\">Opencode</a> · <a href=\"https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/qdev-mcp.html\" target=\"_blank\" rel=\"noopener noreferrer\">Amazon Q</a> · <a href=\"https://kiro.dev/docs/mcp/\" target=\"_blank\" rel=\"noopener noreferrer\">Kiro</a> · <a href=\"https://learn.microsoft.com/en-us/microsoft-copilot-studio/agent-extend-action-mcp\" target=\"_blank\" rel=\"noopener noreferrer\">Copilot Studio</a> · <a href=\"https://support.bolt.new/building/using-bolt/connect-mcp\" target=\"_blank\" rel=\"noopener noreferrer\">Bolt</a> · <a href=\"https://cursor.com/docs/mcp#one-click-installation\" target=\"_blank\" rel=\"noopener noreferrer\">Cursor</a></p><p>To keep your AI tool grounded in your design system as it works, add something like this to your prompts: <em>\"Follow the design system guidelines available via the zeroheight MCP\"</em>. Or learn more about use cases for zeroheight MCP <a href=\"https://zeroheight.com/mcp/use-cases/\" target=\"_blank\" rel=\"noopener noreferrer\">here</a>.</p><h2 id=\"h_01KTPB552212DYHC6XXJ3EQECZ\">Roll it out to your team</h2><p>Viewers connect with your team's MCP URL in one of three ways: with their SSO sign-in, if they sign in to zeroheight via SSO; as private viewers, with a one-time code sent to their email; or as guests, on styleguides whose MCP access is set to <strong>Public</strong>. <a href=\"https://help.zeroheight.com/hc/en-us/articles/51467311835803\">Set up MCP access via login.</a></p><p><strong>Access via link</strong>, where each person gets their own unique URL, is being deprecated. <a href=\"https://help.zeroheight.com/hc/en-us/articles/43737291730331\">Set up MCP access via link.</a></p><p>In all cases, add the <strong>remote MCP details</strong> block to a page in your styleguide so viewers can pick up their connection details, and one-click install commands for popular tools, without leaving the styleguide.</p><h2 id=\"h_01M5GUIDES00000000000000002\">Guides</h2><ul>\n<li data-list-item-id=\"e29ca7a7d692e85314b92cc097e269a4f\">\n<a href=\"https://help.zeroheight.com/hc/en-us/articles/51467311835803\">Set up MCP access via login</a> — for admins, editors, SSO viewers, private viewers and guests, and for CI/CD with API credentials</li>\n<li data-list-item-id=\"eca7352c3f64662ee32f71ddad4dd97a2\">\n<a href=\"https://help.zeroheight.com/hc/en-us/articles/43737291730331\">Set up MCP access via link</a> — being deprecated</li>\n<li data-list-item-id=\"e96bb73262e2e3199f39832fa54ee63a4\">\n<a href=\"https://help.zeroheight.com/hc/en-us/articles/39914754674843\">Set up the local MCP server</a> — for restricted networks</li>\n<li data-list-item-id=\"ea8922f8c904b04babdf7b74ce599a836\">\n<a href=\"https://help.zeroheight.com/hc/en-us/articles/54955157637659\">Writing to zeroheight via MCP</a> — create and edit pages with an agent</li>\n<li data-list-item-id=\"e146178b1ac184de3d4225f3a8c85dd73\">\n<a href=\"https://help.zeroheight.com/hc/en-us/articles/47435348091291\">Token linting</a> — check code against your design tokens</li>\n<li data-list-item-id=\"ea7845987d47869ef2af8eaf00a8061ac\">\n<a href=\"https://help.zeroheight.com/hc/en-us/articles/51478956166939\">zeroheight MCP tools reference</a> — every read and write tool, and how agents use them</li>\n</ul><h2 id=\"h_01KV7T5RZ4BSDAQBXPDDPKDGMR\">FAQ</h2><h3 id=\"h_01KV7T2END3GE3PS0VMHMBGT5W\">Can my AI tool access private pages and styleguides via MCP?</h3><p>It depends on two separate security settings, which behave differently:</p><p>A styleguide's <strong>Website access</strong> settings (such as a password or SSO) only affect guests. A styleguide with a password or SSO can't have its MCP access set to <strong>Public</strong>, so guests can't connect to it. For everyone else, a password or SSO on the styleguide doesn't change MCP access. Who can connect is set by the styleguide's <strong>MCP access</strong> option under <strong>Styleguide settings → MCP</strong>.</p><p><strong>Page-level privacy</strong> (individual pages marked as private) does affect what's reachable, depending on how you've connected:</p><ul>\n<li data-list-item-id=\"ea9e11e8a092d844d90ff9aa4c76e68ed\">\n<strong>Remote MCP</strong> (signing in with your zeroheight account, or viewers via SSO): private pages <em>are</em> accessible. Because you're authenticated, your AI tool can read the same content you can. Private viewers and guests are the exception: private pages are <em>not</em> accessible to them.</li>\n<li data-list-item-id=\"e1c981a2af3b51983da7dc86178988fd9\">\n<strong>Access via link</strong>: private pages are <em>not</em> accessible — only public pages are. Since the link has no authentication, we assume you wouldn't want private content reachable through it.</li>\n<li data-list-item-id=\"e742eff1d62a1fdc53ad6c0b7c75bf160\">\n<strong>Local MCP server</strong>, and API credentials with the <strong>remote MCP</strong>: private pages <em>are</em> accessible. We assume anyone signed in, or with your zeroheight API keys, is entitled to read private content.</li>\n</ul><h3 id=\"h_01M5FAQWRITE000000000000003\">Can my AI tool create or edit pages in zeroheight?</h3><p>Yes, if you're an admin or editor and you signed in to the remote MCP or the local MCP server. MCP write is on by default; a team admin can turn it off under <strong>Your organization → MCP</strong>. Viewers, private viewers, guests, and anyone connected via Access via link, get the read tools only.</p><p>Connections that use API credentials are read only, even if the API token has write scopes.</p><p>On Professional and Enterprise, new pages and edits go into a draft unless you explicitly ask your agent to publish directly. On Free and Starter, where drafts aren't available, changes go straight to the published page and count towards the monthly call limit. <a href=\"https://help.zeroheight.com/hc/en-us/articles/54955157637659\">Learn more about writing to zeroheight via MCP.</a></p><p> </p>"}}