Configure Claude Code

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

The setup script generated from the MCP Registry installs the JFrog CLI, the MCP Gateway plugin, and configures your IDE in a single command.

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 Claude 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=claude; bash <(curl -fL https://releases.jfrog.io/artifactory/jfrog-cli-plugins/mcp-gateway/latest/scripts/mcp-gateway.sh)

      For parameter details, 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 Claude Code to use the Gateway.

  2. Configure IDE with Magic Link:
    1. The installation script prints a Magic Link at the end. Click the Magic Link (in your terminal).
    2. Click Install when prompted to complete MCP server setup.

Configure Claude Code Manually

If auto-configuration did not run, add the MCP Gateway to Claude Code's MCP configuration manually.

Claude Code uses .mcp.json at your project root (project scope, shared with the team) or ~/.claude.json (user scope, for you only).

The format uses mcpServers with command, args, and env (no type field).

To add the MCP Gateway manually:

Add the following to your .json configuration file:

{
  "mcpServers": {
    "JFrogMCPGateway": {
      "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.