app consolidate

Consolidates MCP servers from desktop applications into 1MCP.

This command extracts MCP server configurations from an application's config file, imports them into your 1MCP configuration, and replaces the app's config with a single connection to your 1MCP server.

For a complete overview of the consolidation workflow, supported applications, and best practices, see the App Consolidation Guide.

Synopsis

npx -y @1mcp/agent app consolidate <app-name...> [options]

Arguments

• <app-name...>
  • One or more desktop applications to consolidate.
  • Required: Yes
  • To see a list of supported applications, use npx -y @1mcp/agent app list or refer to the App Consolidation Guide.

Options

Connection Options

• --url, -u <url> - Override the auto-detected 1MCP server URL.

Operation Options

• --dry-run - Preview all changes without modifying any files.
• --yes, -y - Skip all confirmation prompts.
• --force, -f - Skip non-critical validation warnings.

Mode Options

• --manual-only - Show manual setup instructions instead of performing automatic consolidation.
• --backup-only - Create a backup of the existing configuration without importing servers or modifying the config file.

Configuration Options

• --config, -c <path> - Path to your 1MCP configuration file.

Examples

Basic Usage

# Consolidate Claude Desktop
npx -y @1mcp/agent app consolidate claude-desktop

# Consolidate multiple apps at once
npx -y @1mcp/agent app consolidate claude-desktop cursor vscode

# Preview the changes for an app without applying them
npx -y @1mcp/agent app consolidate cursor --dry-run

Advanced Usage

# Use a custom 1MCP server URL
npx -y @1mcp/agent app consolidate claude-desktop --url=http://localhost:3052/mcp

# Skip confirmation prompts for scripting
npx -y @1mcp/agent app consolidate vscode --yes

# Get manual setup instructions for an app
npx -y @1mcp/agent app consolidate cherry-studio --manual-only

See Also

• App Consolidation Guide
• app restore - Restore an application to its original state.
• app status - Check the consolidation status of applications.