Most teams should use the remote MCP server — it requires no installation and works with all major AI tools. Use the local MCP server if your organization restricts remote MCP connections.
To connect from a CI/CD pipeline, use API credentials with Access via login instead.
Not sure which to use? Read the zeroheight MCP overview.
What you'll need
Before you start:
- Node.js version 22 or higher
- A zeroheight account with at least one styleguide
- Optional: your zeroheight Client ID and Access Token, if you don't want to sign in through your browser
- A tool that can connect to MCP servers.
Sign in or use API credentials
By default, the local MCP server opens your browser the first time it connects, so you can sign in to zeroheight. This works the same way as Access via login: admins and editors can create and edit pages, and viewers who sign in via SSO can read.
To sign in, leave out the ZEROHEIGHT_ACCESS_TOKEN and ZEROHEIGHT_CLIENT_ID environment variables in the setup examples below. To use API credentials instead, include them.
Connections that use API credentials are read only, even if the API token has write scopes. The Access via login settings for your organization and for each styleguide don't apply to them. They reach every styleguide the API token can access.
Get your API credentials
Skip this step if you're signing in through your browser. Only Enterprise teams can create API tokens with the scopes the MCP needs.
- Open your zeroheight account settings
- Navigate to the API section
- Generate a Client ID (starts with
zhci_) and Access Token (starts withzhat_)
If you need help creating API credentials, see the API authentication guide.
Setup
Claude Desktop
- Download and install Claude Desktop
- Open Claude Desktop settings
- Go to the Developer tab
- Click "Edit Config"
- Add this configuration:
{
"mcpServers": {
"zeroheight": {
"command": "npx",
"args": ["-y", "@zeroheight/mcp-server@latest"],
"env": {
"ZEROHEIGHT_ACCESS_TOKEN": "zhat_abc123",
"ZEROHEIGHT_CLIENT_ID": "zhci_abc123"
}
}
}
}Replace the example tokens with your actual credentials.
- Restart Claude Desktop
- Look for the MCP indicator in the chat interface
VS Code with GitHub Copilot
- Create
.vscode/mcp.jsonin your workspace:
{
"inputs": [
{
"type": "promptString",
"id": "zeroheight-token",
"description": "Zeroheight Access Token",
"password": true
},
{
"type": "promptString",
"id": "zeroheight-client",
"description": "Zeroheight Client ID",
"password": true
}
],
"servers": {
"zeroheight": {
"command": "npx",
"args": ["-y", "@zeroheight/mcp-server@latest"],
"env": {
"ZEROHEIGHT_ACCESS_TOKEN": "${input:zeroheight-token}",
"ZEROHEIGHT_CLIENT_ID": "${input:zeroheight-client}"
}
}
}
}
- Open Command Palette (⇧⌘P on macOS, F1 on Windows) and run
MCP: Add Server - Enter your credentials when prompted
- Enable Agent Mode in GitHub Copilot Chat
Cursor IDE
- Open Settings → MCP Servers
- Click "Create New MCP Server"
- Configure:
- Name:
zeroheight - Command:
npx - Args:
["-y", "@zeroheight/mcp-server@latest"] - Environment variables:
-
ZEROHEIGHT_ACCESS_TOKEN: your token -
ZEROHEIGHT_CLIENT_ID: your client ID
-
- Name:
- Save and restart Cursor
What you can do with the MCP
Once connected, the local MCP server provides the same read tools as the remote server. See the zeroheight MCP tools reference for full details. The write tools are available to admins and editors who sign in, not to connections that use API credentials.
Troubleshooting
Server not appearing after setup?
- Check Node.js version:
node --version(needs 22+) - If you use API credentials, verify they're correct
- Check JSON syntax in config file
- Restart your client completely
"There are no accessible styleguides..." error?
- If you use API credentials, confirm your access token and client ID
- Make sure your account has styleguide access
- If you use API credentials, check whether they've expired
Server won't start?
- Test manually:
npx @zeroheight/mcp-server@latest - Check internet connection
- Look for firewall issues
For more help, contact support@zeroheight.com or check the help center.