Extend agent capabilities

Add an MCP server

1. Press Ctrl+Alt+S and select AI | Air | MCP Servers.

   

2. Click Edit MCPs. Air in IDEs opens mcp.json in the editor.

3. Add the server to the mcpServers object and save the file. A local server takes a command with its args, and a remote server takes a url:

   { "mcpServers": { "youtrack": { "url": "https://youtrack.example.com/mcp", "headers": { "Authorization": "Bearer token-goes-here" } }, "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder"] } } }

4. On the settings page, click to reload the Your servers list.

5. Select the checkbox next to the server to turn it on, and click OK.

Manage MCP servers

On the AI | Air | MCP Servers page:

• To change a server, click Edit MCPs, edit the entry of the server in mcp.json, and save the file. Then click to reload the list.

• To remove a server, click Edit MCPs, delete the entry of the server from mcp.json, and save the file. Then click to reload the list.

• To copy the configuration of a server, for example to use it in another tool, click next to the server and select Copy Configuration.

• To turn a server off without removing it, clear the checkbox next to it and click OK. The server stays in the list, and you can select the checkbox again later to turn it back on.

Install a skill

1. Press Ctrl+Alt+S and select AI | Skills.

2. In the Available list, select a skill. The right pane shows its description and available installation options.

   

3. Do one of the following:

   • To install the skill for all projects in the IDE, click Install, or hover over the skill in the list and click .

   • To install the skill to a different location, click next to Install, select Install for, and choose a target.

     

   You can install the same skill to several targets. Installed skills show a tag for each target they are installed to.

   

Import skills from agents outside the IDE

If you already use Claude Agent or OpenAI Codex outside the IDE and have skills in their global directories, such as ~/.claude/skills or ~/.codex/skills, the Skills page shows a banner that suggests importing them.

• In the banner, click Import to <IDE name>.

Add skill directories

The Skills page lists skills from the local directories that the IDE scans. By default, these include the IDE skill storage and the global and project directories of Claude Agent and OpenAI Codex. To list skills from another directory on your machine, add it:

1. On the Skills page, click Skills Settings and select Manage Skill Directories.

2. Click in the Global section to use the directory in all projects, or in the Project section to use it only in the current project.

   

3. Specify a Name and the Path to the directory, and click OK.

To stop scanning a directory without removing it, clear its checkbox in the Enabled column.

Add external skill registries

A registry is a GitHub repository or directory with published skills. Skills from enabled registries appear in the Available list, and you install the ones you need. The default registry, https://github.com/JetBrains/skills, is safety-checked by JetBrains.

1. On the Skills page, click Skills Settings and select Manage External Registries.

2. Click , specify the URL of a GitHub repository or directory that contains skills, and click OK.

   

To keep a registry configured but stop loading its skills, clear the checkbox next to it.

Manage installed skills

On the Skills page, in the Installed list:

• To disable a skill, clear the checkbox next to it, or select the skill and click Disable. A disabled skill stays installed, but agents do not receive it until you enable it again.

• To uninstall a skill, select it, click next to Disable, and select Uninstall. If the skill is installed to several targets, select Uninstall From and choose the target.

• To inspect the SKILL.md file and other files of a skill, select it and click Open.