Configure VS Code

Configure VS Code to connect to the MCP Gateway so that your agent uses only governed MCP servers and tools approved for your project.

This script automates the setup of the local environment and ensures that your VS Code is instantly governed by organizational policies.

Prerequisites

  • Access to the JFrog Platform with the AI Catalog enabled.
  • A project with at least one allowed MCP server.
  • Your JFrog host domain and authentication token.

To configure VS Code:

  1. Run the Setup Script:
    1. In the JFrog Platform, navigate to AI/ML > Registry > [Your Project] > MCP Servers.

    2. Select a specific MCP server from the available servers in your project.

    3. Click Configure MCP (or Install MCP) and run the generated command in your terminal:

      export HOST_DOMAIN=<yourhost.jfrog.io> AUTH=<user>:<token> PROJECT_KEY=<project> CLIENT_ID=vscode; bash <(curl -fL https://releases.jfrog.io/artifactory/jfrog-cli-plugins/mcp-gateway/latest/scripts/mcp-gateway.sh)

      For more information, see Install the MCP Gateway.

      This command installs or updates the JFrog CLI, the mcp-gateway plugin, authenticates your machine, sets the active project context, and configures VS Code to use the MCP Gateway.

  2. Configure VS Code with Magic Link:
    1. The installation script prints a Magic Link at the end. The Magic Link is a URL that automatically configures VS Code. Click the Magic Link in your terminal.
    2. Click Install when prompted to complete MCP server setup. VS Code is now connected to the MCP Gateway.

Configure VS Code Manually

If automatic configuration did not run, add the MCP Gateway in VS Code's MCP configuration manually. This enables

To add the MCP Gateway manually:

  1. Open the configuration file. You can apply this setting globally or per project:

    • For your user profile: Open the command palette and search for MCP: Open User Configuration.
    • For your workspace (to share with the team): Create or open the .vscode/mcp.json file in your project root.
  2. Add the following to your configuration file. VS Code requires the type field set to "stdio" for MCP server definitions.

    {
      "servers": {
        "JFrogMCPGateway": {
          "type": "stdio",
          "command": "jf",
          "args": ["mcp-gateway", "run"],
        }
      }
    }

Manage MCP Servers via Agents

The JFrog MCP Gateway various capabilities through MCP tools to your coding agent. You can interact with the JFrog MCP Registry directly through your Agent's chat interface.

For details, see Manage MCPs via Agents.