DevCyle MCP Getting Started
The DevCycle Model Context Protocol (MCP) Server is based on the DevCycle CLI, it enables AI-powered code editors like Cursor and Windsurf, or general-purpose tools like Claude Desktop, to interact directly with your DevCycle projects and make changes on your behalf.
Quick Setup
The DevCycle MCP is hosted so there is no need to set up a local server. We'll walk you through installation and authentication with your preferred AI tools.
Direct Connection: For clients that natively support the MCP specification with OAuth authentication, you can connect directly to our hosted server:
https://mcp.devcycle.com/mcp
Protocol Support: Our MCP server supports both SSE and HTTP Streaming protocols, automatically negotiating the best option based on your client's capabilities.
Alternative Endpoint: If your client has issues with protocol negotiation, use the SSE-only endpoint:
https://mcp.devcycle.com/sse
These instructions use the remote DevCycle MCP server. For installation of the local MCP server, see the reference docs.
Configure Your AI Client
- Cursor
- VS Code
- Claude Desktop
- Claude Code
- Windsurf
To open Cursor and automatically add the DevCycle MCP, click the install button above. Alternatively, add the following to your ~/.cursor/mcp_settings.json
file. To learn more, see the Cursor documentation.
{
"mcpServers": {
"DevCycle": {
"url": "https://mcp.devcycle.com/mcp"
}
}
}
Authentication in Cursor:
- After configuration, you'll see DevCycle MCP listed as "Needs login" with a yellow indicator
- Click on the DevCycle MCP server to initiate the authorization process
- This opens a browser authorization page at
mcp.devcycle.com
- Review and click "Allow Access" to grant permissions
- If you have multiple organizations, select your desired organization at
auth.devcycle.com
- You'll be redirected back to Cursor with the server now active
To open VS Code and automatically add the DevCycle MCP, click the install button above. Alternatively, add the following to your .continue/config.json
file. To learn more, see the Continue documentation.
{
"mcpServers": {
"DevCycle": {
"url": "https://mcp.devcycle.com/mcp"
}
}
}
Authentication in VS Code:
- After configuration, open the MCP settings panel in VS Code
- Find the DevCycle MCP server and click "Start Server"
- VS Code will show a dialog: "The MCP Server Definition 'DevCycle' wants to authenticate to mcp.devcycle.com"
- Click "Allow" to proceed with authentication
- This opens a browser authorization page at
mcp.devcycle.com
- Review and click "Allow Access" to grant permissions
- If you have multiple organizations, select your desired organization at
auth.devcycle.com
- You'll be redirected back to VS Code with the server now active
Step 1: Access MCP Configuration
Option 1: Through Claude Desktop Settings (Recommended)
- Open Claude Desktop and go to Settings
- Navigate to Developer → Local MCP servers
- Click "Edit Config" to open the configuration file directly
Option 2: Manual Configuration File Alternatively, locate and edit your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Step 2: Add DevCycle Configuration Add or merge the following configuration:
{
"mcpServers": {
"devcycle": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.devcycle.com/mcp"]
}
}
}
Step 3: Restart Claude Desktop Close and reopen Claude Desktop for the changes to take effect.
Step 4: Authentication
- When you first use DevCycle MCP tools, Claude Desktop will prompt for authentication
- This will open a browser page at
mcp.devcycle.com
for authorization - Review and click "Allow Access" to grant permissions
- If you have multiple organizations, select your desired organization at
auth.devcycle.com
- Return to Claude Desktop where the MCP tools will be active
Step 1: Open Terminal Open your terminal to access the Claude CLI.
Step 2: Add DevCycle MCP Server
claude mcp add --transport http devcycle https://mcp.devcycle.com/mcp
Step 3: Manage MCP Connection In the Claude CLI, enter the MCP management interface:
/mcp
Step 4: Authentication You'll see the DevCycle server listed as "disconnected • Enter to login":
- Select the DevCycle server and press Enter to login
- Follow the CLI prompts to initiate the Authentication process
- This will open a browser page at
mcp.devcycle.com
for authorization - Review and click "Allow Access" to grant permissions
- If you have multiple organizations, select your desired organization at
auth.devcycle.com
- Return to Claude Code where the server will show as connected
For more details, see the Claude Code MCP documentation.
Step 1: Access MCP Configuration
- Open Windsurf and go to Settings > Winsurf Settings
- Scroll to the Cascade section
- Click "Manage MCPs"
Step 2: Edit Raw Configuration
- In the "Manage MCP servers" interface, click "View raw config"
- Add the following configuration to the JSON file:
{
"mcpServers": {
"DevCycle": {
"serverUrl": "https://mcp.devcycle.com/mcp"
}
}
}
Step 3: Refresh and Authenticate
- Save the configuration file
- Click "Refresh" in the "Manage MCP servers" interface
- The DevCycle server will appear and prompt for authentication
- Follow the authentication flow:
- Browser opens at
mcp.devcycle.com
for authorization - Click "Allow Access" to grant permissions
- If you have multiple organizations, select your desired organization at
auth.devcycle.com
- Return to Windsurf where DevCycle will show as "Enabled" with all tools available which can be configured independently
- Browser opens at
Available Tools
The DevCycle MCP Server provides comprehensive feature flag management tools organized into 6 categories:
Category | Tools | Description |
---|---|---|
Feature Management | list_features , create_feature , update_feature , update_feature_status , delete_feature , fetch_feature_variations , create_feature_variation , update_feature_variation , set_feature_targeting , list_feature_targeting , update_feature_targeting , get_feature_audit_log_history | Create and manage feature flags, variations, and targeting |
Variable Management | list_variables , create_variable , update_variable , delete_variable | Manage feature variables |
Environment Management | list_environments , get_sdk_keys | Environment configuration |
Project Management | list_projects , get_current_project | Project management |
Self-Targeting & Overrides | get_self_targeting_identity , update_self_targeting_identity , list_self_targeting_overrides , set_self_targeting_override , clear_feature_self_targeting_overrides | Testing and overrides |
Results & Analytics | get_feature_total_evaluations , get_project_total_evaluations | Usage analytics |
Try It Out
Once configured, try asking your AI assistant:
- "Create a new feature flag called 'new-checkout-flow'"
- "List all features in my project"
- "Enable targeting for the header-redesign feature in production"
- "Show me evaluation analytics for the last 7 days"
Next Steps
- MCP Reference - Complete tool documentation with all parameters
- CLI Reference - Learn about the underlying CLI commands
Getting Help
- GitHub Issues: GitHub Issues
- General Documentation: DevCycle Docs
- DevCycle Community: Discord
- Support: Contact Support