Junie Help

Model Context Protocol (MCP)

You can connect Junie to Model Context Protocol (MCP) servers. This will provide Junie with executable functionality for working with data sources and tools, such as file systems, productivity tools, or databases.

How it works

When running a prompt, Junie analyzes what commands registered with the configured MCP servers as available tools are relevant, and executes them through the respective MCP server.

Run MCP command

User approval

By default, Junie asks for user approval before executing the relevant tool. You can authorize Junie to run MCP commands without approval on the Action Allowlist settings page or from Junie's tool window by clicking More actions next to the command as Junie executes it.

Add MCP tools to Action Allowlist

Add an MCP server

To connect Junie to an MCP server, use the mcp.json file in Junie's settings.

  1. In the IDE settings (Ctrl+Alt+S), go to Tools | Junie | MCP Settings.

  2. Click Add button on the toolbar. In the mcp.json file that opens, add one or multiple server configurations in the "mcpServers" key.

    Add an MCP server

    For the JSON schema, refer to the documentation of the MCP server you are adding. For example, a configuration that sets up a GitHub MCP server looks as follows:

    { "mcpServers": { "github": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT" } } } }

Global configuration

The MCP servers added via the MCP Settings page are saved to the ~/.junie/mcp.json file in the home directory. Such servers are available globally for all projects that are opened in the IDE.

Project-level configuration

To configure an MCP server at the project level, add an mcp.json file manually to the .junie/mcpfolder in the project root.

View configured MCP servers

The MCP servers configured at both global and project levels are displayed on the MCP Servers list in Settings (Ctrl+Alt+S) | Tools | Junie | MCP Settings.

To edit a configuration, select it on the list and click Edit on the toolbar.

List of MCP configurations

    View available tools

    Actions that Junie can perform through configured MCP servers are listed as available tools.

    To view what tools are available for a specific MCP server, navigate to Settings (Ctrl+Alt+S) | Tools | Junie | MCP Settings, locate the server on the list, and expand the Status drop-down list.

    Available tools
    03 September 2025