MCP servers

MCP servers extend agents with additional tools. They are commonly used in agentic workflows to fetch data and perform actions in external systems. For example, you can paste a YouTrack issue link into a task and let the agent fetch the issue details through a YouTrack MCP server.

MCP servers are configured with an msp.json file.

Add an MCP server

Open Settings and go to AI | MCP Servers.
Make sure Enable MCP support is turned on.
Click Add Global MCP Server to add a server available in all your projects. Use the drop-down menu to choose Add Local MCP Server or Add Workspace MCP Server.
- Global – available in all projects on your machine. Use it for personal integrations you use everywhere.
- Local – available only in the current project and stored along with other JetBrains Air settings in project/.air/mcp.json. Use it for project-specific configuration.
- Workspace – uses the standard .mcp.json file in the project root. Use it when your repository already contains MCP configuration, and you want JetBrains Air to reuse it.
  If you want JetBrains Air to use .mcp.json from the repository, make sure Launch workspace MCP servers is enabled.
Paste the JSON configuration and save it.

24 April 2026