TL;DR - Get your AI coding assistant to understand MentraOS instantly. Works with Zed, Cursor, VS Code, Windsurf, Claude Code, and more.

​
Why Connect Your AI IDE?

When you connect your AI coding assistant to MentraOS docs, it can:
  • Answer questions about the MentraOS SDK
  • Help you write smart glasses apps faster
  • Look up API references automatically
  • Debug your code with context about how MentraOS works

​
MCP Server URL

All setups below use this URL: 
https://docs.mentraglass.com/mcp
This is the docs MCP (SDK reference and guides). It is not the Developer Console.

​
Developer Console MCP (incidents, optional)

MentraOS also ships a local MCP server for the Developer Console (cloud/packages/console-mcp). Use it to triage bug-report incidents from Cursor (list incidents, fetch metadata, filter logs). It is separate from the docs URL above.
CredentialEnables
MENTRA_AGENT_API_KEYincident_list, incident_get, incident_get_logs
MENTRA_CLI_TOKENApp and org management tools (optional)
MENTRA_ADMIN_JWTInternal admin review tools (Mentra staff only)
The agent API key must match the cloud server’s MENTRA_AGENT_API_KEY (see cloud/.env when running API locally). MiniApp and CLI-key creation stay in the Developer Console — not via MCP. Full setup, env vars, and tests: cloud/packages/console-mcp/README.md in the MentraOS repo.

​
Setup by IDE

​
Zed

Add this to your settings.json (open with Cmd+, or zed: open settings): 
{
  "context_servers": {
    "mentraos-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.mentraglass.com/mcp"],
      "env": {}
    }
  }
}
Restart Zed and you’re done.
Open the Agent Panel and check the MCP servers indicator in settings. A green dot means the server is active. You can also type / in a chat to see available prompts from the server.

​
Cursor

Add this to your Cursor MCP config file at ~/.cursor/mcp.json (create it if it doesn’t exist): 
{
  "mcpServers": {
    "mentraos-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.mentraglass.com/mcp"]
    }
  }
}
Then restart Cursor.
Clone MentraOS and add a second server entry. Use the wrapper script so Bun is found when Cursor starts MCP with a minimal PATH:
{
  "mcpServers": {
    "mentraos-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.mentraglass.com/mcp"]
    },
    "mentra-console": {
      "command": "/absolute/path/to/MentraOS/cloud/packages/console-mcp/scripts/run-mcp.sh",
      "args": []
    }
  }
}
run-mcp.sh reads export MENTRA_AGENT_API_KEY=... from ~/.zshrc if not already set. You can also pass keys in an "env" block on the server entry.After restart, ask the agent to run console_auth_status — you should see incidents: true when the key is configured. For local API dev, set MENTRA_API_HOST to http://localhost:8002 in env or ~/.zshrc.
You can also create .cursor/mcp.json in your project root to enable MentraOS docs only for that project.

​
VS Code (with GitHub Copilot)

VS Code 1.99+ has built-in MCP support with GitHub Copilot.
  1. Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
  2. Run “MCP: Add Server”
  3. Select “HTTP” as the transport type
  4. Enter URL: https://docs.mentraglass.com/mcp
  5. Name it mentraos-docs
Add to your VS Code settings.json:
{
  "mcp.servers": {
    "mentraos-docs": {
      "type": "http",
      "url": "https://docs.mentraglass.com/mcp"
    }
  }
}

​
Windsurf

  1. Open Windsurf Settings (Cmd+, / Ctrl+,)
  2. Search for “MCP” and click to open the Manage Plugins panel
  3. Click “View raw config” to open mcp_config.json
  4. Add the following configuration:
{
  "mcpServers": {
    "mentraos-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.mentraglass.com/mcp"]
    }
  }
}
  1. Click Refresh in the Manage Plugins panel
  • macOS: ~/.codeium/windsurf/mcp_config.json
  • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

​
Claude Code (CLI)

Run this in your terminal: 
claude mcp add mentraos-docs --transport http https://docs.mentraglass.com/mcp
Run claude mcp list to see your connected servers. You should see mentraos-docs in the list.

​
Other MCP-Compatible Tools

For any tool that supports MCP, use mcp-remote to connect to our HTTP endpoint: 
npx -y mcp-remote https://docs.mentraglass.com/mcp
Or if your tool supports HTTP MCP servers directly, use the URL: 
https://docs.mentraglass.com/mcp

​
Test It Out

After setup, try asking your AI assistant:
  • “How do I display text on smart glasses with MentraOS?”
  • “Show me how to use the camera API”
  • “What managers are available on a MentraSession?”
  • “How do I subscribe to transcription in a specific language?”
Your AI should now give you accurate, up-to-date answers using our docs.

​
Troubleshooting

Make sure you have Node.js 18+ installed. The mcp-remote package requires it.
node --version  # Should be v18.0.0 or higher
Install Node.js from nodejs.org which includes npm and npx.
Try running the npx command with sudo on macOS/Linux, or run your terminal as Administrator on Windows.
Cursor often spawns MCP with a minimal PATH, so bun may not be found. Point command at cloud/packages/console-mcp/scripts/run-mcp.sh (not bare bun). Install Bun if needed. Restart the server in Cursor Settings → MCP.Verify from a terminal:
cd cloud/packages/console-mcp
bun test
export MENTRA_AGENT_API_KEY=your-key
bun run smoke

​
What’s Next?

Quickstart

Build your first smart glasses app in 15 minutes

Example Apps

Clone a working example and start hacking