Installation
Get Prism Context Engine set up in your development environment.
Fastest Path: Use the Web Dashboard — no installation required for basic usage.
Choose Your Setup
Prism offers two ways to use context rules:
| Method | Best For | Setup Time |
|---|---|---|
| Web Dashboard Only | Quick exports, manual workflow | 2 minutes |
| MCP Server | Real-time sync, automated workflow | 10 minutes |
Option A: Web Dashboard (Recommended)
The simplest way to use Prism. No local installation required.
Step 1: Create an Account
- Visit prism.syntaxure.dev/sign-up
- Sign up with your email or GitHub
- Verify your email address
Step 2: Create Your First Project
- Click “New Project” in the dashboard
- Enter your project name (e.g., “My SaaS App”)
- Select your tech stack (Next.js, React, etc.)
Step 3: Export Rules
- Create or generate rules (see Creating Rules)
- Click “Export” → Choose your IDE format
- Download the
.cursorrulesor.windsurfrulesfile - Place it in your project root
⚠️ Manual Workflow: With this method, you’ll need to re-export rules whenever they change.
Option B: MCP Server (Advanced)
For real-time synchronization between the dashboard and your IDE.
Prerequisites
- Node.js 18+ installed
- npm or pnpm package manager
- Prism account with API key (Pro plan or above)
Installation
npm:
npm install -g prism-mcp-serverpnpm:
pnpm add -g prism-mcp-serveryarn:
yarn global add prism-mcp-serverGet Your API Key
Step 1: Open Dashboard Settings
Navigate to prism.syntaxure.dev/settings
Step 2: Generate API Key
- Scroll to the “API Access” section
- Click “Generate Key”
- Give it a name (e.g., “MacBook Pro”)
- Copy the key immediately — it won’t be shown again
Step 3: Store Securely
Save your API key somewhere safe. You’ll need it for IDE configuration.
Verify Installation
prism-mcp --version
# Output: prism-mcp v1.0.3IDE Configuration
After installing the MCP server, configure your editor:
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"prism": {
"command": "prism-mcp",
"env": {
"PRISM_API_KEY": "prism_live_your_api_key_here",
"MONGODB_URI": "your_cosmos_connection_string"
}
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"prism": {
"command": "prism-mcp",
"env": {
"PRISM_API_KEY": "prism_live_your_api_key_here",
"MONGODB_URI": "your_cosmos_connection_string"
}
}
}
}VS Code
- Install the MCP Extension from marketplace
- Open Command Palette → “MCP: Configure Servers”
- Add Prism server configuration with environment variables
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"prism": {
"command": "prism-mcp",
"env": {
"PRISM_API_KEY": "prism_live_your_api_key_here",
"MONGODB_URI": "your_cosmos_connection_string"
}
}
}
}Full Claude Desktop Setup Guide →
Environment Variables
The MCP server uses these environment variables:
| Variable | Required | Description |
|---|---|---|
PRISM_API_KEY | Yes (Pro+) | Your API key from the dashboard |
MONGODB_URI | Yes | Azure Cosmos DB connection string |
COSMOS_DATABASE_NAME | No | Database name (default: prism) |
PRISM_API_URL | No | Dashboard URL (default: https://prism.syntaxure.dev) |
Verify Connection
After configuration, verify your MCP connection:
- Open your IDE
- Start a new chat with AI
- Ask: “What Prism rules are available?”
If configured correctly, the AI will list your project’s context rules.
Troubleshooting
Connection Failed? See MCP Setup Troubleshooting
Common Issues
| Issue | Solution |
|---|---|
command not found: prism-mcp | Reinstall with -g flag or check PATH |
Invalid API key | Regenerate key in dashboard |
Connection timeout | Check internet connection |
No rules found | Create rules in dashboard first |
API key validation failed | Ensure you have a Pro plan or above |
Next Steps
- Quick Start — Create your first rule
- IDE Setup Guides — Detailed configuration
- Video Processing — Extract rules from recordings