MCP configuration

You can connect Junie CLI to external tools via Model Context Protocol (MCP). Junie CLI uses the same MCP JSON configuration as Junie in JetBrain IDEs.

The /mcp slash command shows the list of configured MCP servers and the MCP Installation Assistant to guide you through adding, editing, or troubleshooting configs for MCP servers.

Add an MCP server with Installation Assistant

Junie's MCP Installation Assistant is an AI helper that streamlines and simplifies the process of adding new MCP servers.

It can search the official MCP registry for the proper server configuration, prompt you to provide secrets or API tokens if required, add the server configuration to the mcp.json file, and verify the server startup.

To add a new MCP server using the MCP Installation Assistant:

Type /mcp and then select → Add New MCP action.
Search and select from the registry of pre-configured MCP servers, or select → Setup manually to configure an MCP server from scratch.
Select the server installation scope:
- Project — MCP server configs are stored in the .junie/mcp/mcp.json file at the root of your project. This file can be checked into version control and shared across all team members.
  For project-scope installations, avoid sharing secrets or sensitive environment variables if the .junie/mcp/mcp.json file is committed to version control.
- User — user-scope MCP configs are stored in ~/.junie/mcp/mcp.json and available across all projects on your machine while remaining private to your user account.
Select the server connection type:
- Remote — Connect to a hosted server via HTTP/HTTPS.
  Junie CLI connects to an MCP server hosted on a remote machine or service.
- Local — Run on your machine (Docker, npx, or binary).
  Junie CLI starts an MCP server instance locally, e.g. using the npx command or via Docker.

List configured MCP servers

To list all configured MCP servers, as well as disable/enable, modify, or delete existing configurations, use the /mcp command. The list shows:

MCP server name.
Installation scope (project or user).
Server status (starting/active/inactive/disabled/failed).

Configuration for MCP servers is stored in the mcp.json file either at the project root in the .junie/mcp/ folder (project scope) or on your machine in ~/.junie/mcp/ (user scope).

Enable or disable an MCP server

The MCP servers connected via MCP Installation Assistant or imported from the mcp.json file are enabled by default.

To disable a server, list all the configured servers with the /mcp command, select the necessary server, and then select the → Disable action. To enable a previously disabled server, use → Enable.

27 January 2026