如何在 IntelliJ IDEs 中使用 MCP (2026)

如何在 2026 年针对 JetBrains IDE 使用 MCP

Model Context Protocol (MCP) 已迅速成为 AI 助手连接外部工具和数据源的标准方式。虽然大多数 MCP 指南都集中在 VS Code 和 Claude Desktop，但 JetBrains IDE（包括 IntelliJ IDEA、WebStorm、PyCharm、GoLand、Rider 等）现在也提供了完善的 MCP 支持。本指南将带你了解如何在 JetBrains IDE 中配置 MCP 服务器，以便你的 AI 助手可以直接在编辑器中与数据库、API、项目管理工具等进行交互。

什么是 MCP？

Model Context Protocol 是由 Anthropic 开发的开放标准，它为 AI 模型和外部工具之间提供了通用接口。MCP 无需为每对“工具-AI”构建自定义集成，而是定义了一个通用协议，任何 AI 客户端都可以使用该协议与任何 MCP 服务器通信。

一个 MCP 服务器可以暴露 tools（AI 可以执行的操作）、resources（AI 可以读取的数据）和 prompts（预构建的模板）。例如：

GitHub MCP server 让 AI 可以读取 issue、创建 PR 并评审代码
database MCP server 让 AI 可以查询数据库并解释表结构（schemas）
Jira MCP server 让 AI 可以读取工单并更新状态

前提条件

在 JetBrains IDE 中设置 MCP 之前，请确保你拥有：

JetBrains IDE（2025.1 或更高版本）及有效许可
已安装 Node.js 18+（大多数 MCP 服务器基于 Node）
已启用 AI Assistant plugin（JetBrains IDE 已内置）
JetBrains AI 订阅 或兼容的 AI 插件

检查你的 IDE 版本：

Help > About (Windows/Linux)
IntelliJ IDEA > About IntelliJ IDEA (macOS)

第 1 步：启用 AI Assistant

JetBrains AI Assistant 是 JetBrains IDE 中的主要 MCP 客户端。

打开 Settings（macOS 为 Cmd+,，Windows/Linux 为 Ctrl+Alt+S）
导航至 Plugins
搜索 "AI Assistant"
确保其已安装并启用
如果有提示，请重启 IDE

重启后，你应该在右侧边栏中看到 AI Assistant 工具窗口。

第 2 步：配置 MCP 服务器

JetBrains IDE 支持通过项目内或全局的 JSON 文件进行 MCP 服务器配置。

项目级配置

在你的项目根目录下创建一个 .jb-mcp.json 文件：

{
  "servers": [
    {
      "name": "filesystem",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/directory"]
    },
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  ]
}

全局配置

如果你希望 MCP 服务器在所有项目中都可用，请在 JetBrains 配置目录中创建配置文件：

# macOS
~/Library/Application Support/JetBrains/IntelliJIdea2025.2/mcp.json

# Linux
~/.config/JetBrains/IntelliJIdea2025.2/mcp.json

# Windows
%APPDATA%\JetBrains\IntelliJIdea2025.2\mcp.json

格式与项目级配置相同。

通过 UI 进行配置

你也可以通过 IDE 设置配置 MCP 服务器：

打开 Settings (Cmd+, / Ctrl+Alt+S)
导航至 Tools > AI Assistant > MCP Servers
点击 + 按钮添加新服务器
填写服务器详细信息：
- Name: 描述性名称
- Command: 启动服务器的命令（例如 npx）
- Arguments: 命令参数
- Environment Variables: 任何必要的环境变量

第 3 步：常见的 MCP 服务器设置

GitHub MCP Server

将 IDE 的 AI 连接到你的 GitHub 仓库：

{
  "servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

在 github.com/settings/tokens 生成一个具有 repo 权限的 GitHub token。

启用功能示例：

“为我当前的更改创建一个 PR”
“分配给我的未解决 issue 有哪些？”
“评审此仓库中最新的 PR”

Database MCP Server (PostgreSQL)

让 AI 查询并理解你的数据库架构：

{
  "servers": [
    {
      "name": "postgres",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-postgres", "postgresql://user:password@localhost:5432/mydb"]
    }
  ]
}

启用功能示例：

“显示 users 表的 schema”
“编写一个查询，寻找过去 30 天内注册的用户”
“解释 orders 表和 products 表之间的关系”

Filesystem MCP Server

赋予 AI 对特定目录的读取权限：

{
  "servers": [
    {
      "name": "docs",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "./docs", "./README.md"]
    }
  ]
}

Slack MCP Server

连接 Slack 以获取团队对话中的上下文：

{
  "servers": [
    {
      "name": "slack",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  ]
}

第 4 步：在 AI Chat 中使用 MCP 工具

一旦你的 MCP 服务器配置完成并运行，JetBrains IDE 中的 AI Assistant 就可以使用它们暴露的工具。

开始对话

打开 AI Assistant 面板（右侧边栏）
开始新对话
AI 将自动发现可用的 MCP 工具

交互示例

用户：我们 GitHub 仓库有哪些未解决的 issue？

AI: [使用 github MCP 工具: list_issues]
我发现了 12 个未解决的 issue。以下是最近的：
- #145: 修复身份验证超时 (分配给 @alice)
- #143: 更新仪表盘布局 (未分配)
- #140: 预发布环境数据库迁移失败 (分配给 @bob)
...

用户：显示 payments 表的 schema，并针对慢查询建议一个索引。

AI: [使用 postgres MCP 工具: query]
payments 表的架构如下：
- id (uuid, 主键)
- user_id (uuid, users 表的外键)
- amount (decimal)
- status (varchar)
- created_at (timestamp)

根据常见的查询模式，我建议为 (user_id, created_at DESC) 添加索引，
以便优化按用户查找近期支付记录的查询：

CREATE INDEX idx_payments_user_created ON payments (user_id, created_at DESC);

第 5 步：故障排除

MCP 服务器未启动

检查服务器命令是否可以在 IDE 外部工作：

# 直接测试命令
npx -y @anthropic/mcp-server-github

# 检查 Node.js 是否可访问
node --version
npx --version

服务器已启动但未显示工具

打开 Settings > Tools > AI Assistant > MCP Servers
检查服务器是否显示绿色状态指示灯
点击 Refresh 重新发现工具
检查 IDE 日志以查找错误：Help > Show Log in Finder/Explorer

环境变量问题

JetBrains IDE 可能不会继承你的 shell 环境变量。在 MCP 配置中显式指定它们：

{
  "servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  ]
}

使用 nvm 或 fnm

如果你使用 nvm 或 fnm 管理 Node.js 版本，IDE 可能找不到 npx。请使用全路径：

{
  "servers": [
    {
      "name": "github",
      "command": "/Users/yourname/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

通过以下命令查找你的 npx 路径：

which npx

第 6 步：安全最佳实践

不要硬编码机密信息

不要直接将 token 放在配置文件中，而是使用环境变量引用或机密管理工具：

# 在你的 shell 配置文件中设置环境变量
export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxx"
export SLACK_BOT_TOKEN="xoxb-your-token"

限制 MCP 服务器权限

仅授予 filesystem MCP 服务器访问其所需目录的权限
为 database MCP 服务器使用只读数据库凭证
创建权限最小化的限定范围 API token

将配置文件添加到 .gitignore

# .gitignore
.jb-mcp.json

支持的 JetBrains IDE

所有包含 AI Assistant 插件的 JetBrains IDE 均支持 MCP：

IDE	专注语言	MCP 支持
IntelliJ IDEA	Java, Kotlin	是
WebStorm	JavaScript, TypeScript	是
PyCharm	Python	是
GoLand	Go	是
Rider	C#, .NET	是
RubyMine	Ruby	是
PhpStorm	PHP	是
CLion	C, C++	是
DataGrip	SQL, Databases	是
RustRover	Rust	是

使用 AI API 进行开发

MCP 将你的开发环境连接到外部工具，但如果你正在构建需要 AI 媒体生成能力（图像、视频、音频、数字人）的应用，Hypereal AI 提供的统一 API 可以补充你的 MCP 增强型工作流。当你的 AI 助手既理解你的代码又理解你所使用的 API 时，你可以更快地进行原型开发。

总结

在 JetBrains IDE 中设置 MCP 涉及三个步骤：启用 AI Assistant 插件、创建包含服务器定义的 .jb-mcp.json 配置文件，然后开始对话。日常开发中最有用的 MCP 服务器是 GitHub（PR 和 issue）、数据库（schema 和查询）以及文件系统（文档）。切记将机密信息排除在配置文件之外，限制权限，并在服务器无法连接时参考上述故障排除步骤。

如何在 2026 年针对 JetBrains IDE 使用 MCP

什么是 MCP？

一个 MCP 服务器可以暴露 tools（AI 可以执行的操作）、resources（AI 可以读取的数据）和 prompts（预构建的模板）。例如：

GitHub MCP server 让 AI 可以读取 issue、创建 PR 并评审代码
database MCP server 让 AI 可以查询数据库并解释表结构（schemas）
Jira MCP server 让 AI 可以读取工单并更新状态

前提条件

在 JetBrains IDE 中设置 MCP 之前，请确保你拥有：

JetBrains IDE（2025.1 或更高版本）及有效许可
已安装 Node.js 18+（大多数 MCP 服务器基于 Node）
已启用 AI Assistant plugin（JetBrains IDE 已内置）
JetBrains AI 订阅 或兼容的 AI 插件

检查你的 IDE 版本：

Help > About (Windows/Linux)
IntelliJ IDEA > About IntelliJ IDEA (macOS)

第 1 步：启用 AI Assistant

JetBrains AI Assistant 是 JetBrains IDE 中的主要 MCP 客户端。

打开 Settings（macOS 为 Cmd+,，Windows/Linux 为 Ctrl+Alt+S）
导航至 Plugins
搜索 "AI Assistant"
确保其已安装并启用
如果有提示，请重启 IDE

重启后，你应该在右侧边栏中看到 AI Assistant 工具窗口。

第 2 步：配置 MCP 服务器

JetBrains IDE 支持通过项目内或全局的 JSON 文件进行 MCP 服务器配置。

项目级配置

在你的项目根目录下创建一个 .jb-mcp.json 文件：

{
  "servers": [
    {
      "name": "filesystem",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/directory"]
    },
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  ]
}

全局配置

如果你希望 MCP 服务器在所有项目中都可用，请在 JetBrains 配置目录中创建配置文件：

# macOS
~/Library/Application Support/JetBrains/IntelliJIdea2025.2/mcp.json

# Linux
~/.config/JetBrains/IntelliJIdea2025.2/mcp.json

# Windows
%APPDATA%\JetBrains\IntelliJIdea2025.2\mcp.json

格式与项目级配置相同。

通过 UI 进行配置

你也可以通过 IDE 设置配置 MCP 服务器：

打开 Settings (Cmd+, / Ctrl+Alt+S)
导航至 Tools > AI Assistant > MCP Servers
点击 + 按钮添加新服务器
填写服务器详细信息：
- Name: 描述性名称
- Command: 启动服务器的命令（例如 npx）
- Arguments: 命令参数
- Environment Variables: 任何必要的环境变量

第 3 步：常见的 MCP 服务器设置

GitHub MCP Server

将 IDE 的 AI 连接到你的 GitHub 仓库：

{
  "servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

在 github.com/settings/tokens 生成一个具有 repo 权限的 GitHub token。

启用功能示例：

“为我当前的更改创建一个 PR”
“分配给我的未解决 issue 有哪些？”
“评审此仓库中最新的 PR”

Database MCP Server (PostgreSQL)

让 AI 查询并理解你的数据库架构：

{
  "servers": [
    {
      "name": "postgres",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-postgres", "postgresql://user:password@localhost:5432/mydb"]
    }
  ]
}

启用功能示例：

“显示 users 表的 schema”
“编写一个查询，寻找过去 30 天内注册的用户”
“解释 orders 表和 products 表之间的关系”

Filesystem MCP Server

赋予 AI 对特定目录的读取权限：

{
  "servers": [
    {
      "name": "docs",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "./docs", "./README.md"]
    }
  ]
}

Slack MCP Server

连接 Slack 以获取团队对话中的上下文：

{
  "servers": [
    {
      "name": "slack",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  ]
}

第 4 步：在 AI Chat 中使用 MCP 工具

一旦你的 MCP 服务器配置完成并运行，JetBrains IDE 中的 AI Assistant 就可以使用它们暴露的工具。

开始对话

打开 AI Assistant 面板（右侧边栏）
开始新对话
AI 将自动发现可用的 MCP 工具

交互示例

用户：我们 GitHub 仓库有哪些未解决的 issue？

AI: [使用 github MCP 工具: list_issues]
我发现了 12 个未解决的 issue。以下是最近的：
- #145: 修复身份验证超时 (分配给 @alice)
- #143: 更新仪表盘布局 (未分配)
- #140: 预发布环境数据库迁移失败 (分配给 @bob)
...

用户：显示 payments 表的 schema，并针对慢查询建议一个索引。

AI: [使用 postgres MCP 工具: query]
payments 表的架构如下：
- id (uuid, 主键)
- user_id (uuid, users 表的外键)
- amount (decimal)
- status (varchar)
- created_at (timestamp)

根据常见的查询模式，我建议为 (user_id, created_at DESC) 添加索引，
以便优化按用户查找近期支付记录的查询：

CREATE INDEX idx_payments_user_created ON payments (user_id, created_at DESC);

第 5 步：故障排除

MCP 服务器未启动

检查服务器命令是否可以在 IDE 外部工作：

# 直接测试命令
npx -y @anthropic/mcp-server-github

# 检查 Node.js 是否可访问
node --version
npx --version

服务器已启动但未显示工具

打开 Settings > Tools > AI Assistant > MCP Servers
检查服务器是否显示绿色状态指示灯
点击 Refresh 重新发现工具
检查 IDE 日志以查找错误：Help > Show Log in Finder/Explorer

环境变量问题

JetBrains IDE 可能不会继承你的 shell 环境变量。在 MCP 配置中显式指定它们：

{
  "servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  ]
}

使用 nvm 或 fnm

如果你使用 nvm 或 fnm 管理 Node.js 版本，IDE 可能找不到 npx。请使用全路径：

{
  "servers": [
    {
      "name": "github",
      "command": "/Users/yourname/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

通过以下命令查找你的 npx 路径：

which npx

第 6 步：安全最佳实践

不要硬编码机密信息

不要直接将 token 放在配置文件中，而是使用环境变量引用或机密管理工具：

# 在你的 shell 配置文件中设置环境变量
export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxx"
export SLACK_BOT_TOKEN="xoxb-your-token"

限制 MCP 服务器权限

仅授予 filesystem MCP 服务器访问其所需目录的权限
为 database MCP 服务器使用只读数据库凭证
创建权限最小化的限定范围 API token

将配置文件添加到 .gitignore

# .gitignore
.jb-mcp.json

支持的 JetBrains IDE

所有包含 AI Assistant 插件的 JetBrains IDE 均支持 MCP：

IDE	专注语言	MCP 支持
IntelliJ IDEA	Java, Kotlin	是
WebStorm	JavaScript, TypeScript	是
PyCharm	Python	是
GoLand	Go	是
Rider	C#, .NET	是
RubyMine	Ruby	是
PhpStorm	PHP	是
CLion	C, C++	是
DataGrip	SQL, Databases	是
RustRover	Rust	是

开始使用 Hypereal 构建

如何在 2026 年针对 JetBrains IDE 使用 MCP

什么是 MCP？

前提条件

第 1 步：启用 AI Assistant

第 2 步：配置 MCP 服务器

项目级配置

全局配置

通过 UI 进行配置

第 3 步：常见的 MCP 服务器设置

GitHub MCP Server

Database MCP Server (PostgreSQL)

Filesystem MCP Server

Slack MCP Server

第 4 步：在 AI Chat 中使用 MCP 工具

开始对话

交互示例

第 5 步：故障排除

MCP 服务器未启动

服务器已启动但未显示工具

环境变量问题

使用 nvm 或 fnm

第 6 步：安全最佳实践

不要硬编码机密信息

限制 MCP 服务器权限

将配置文件添加到 .gitignore

支持的 JetBrains IDE

使用 AI API 进行开发

总结

相关文章

如何从零开始构建 MCP Server (2026)

如何设置 Context7 MCP Server (2026)

FastMCP：在几分钟内构建 MCP 服务器 (2026)

立即开始构建

开始使用 Hypereal 构建

如何在 2026 年针对 JetBrains IDE 使用 MCP

什么是 MCP？

前提条件

第 1 步：启用 AI Assistant

第 2 步：配置 MCP 服务器

项目级配置

全局配置

通过 UI 进行配置

第 3 步：常见的 MCP 服务器设置

GitHub MCP Server

Database MCP Server (PostgreSQL)

Filesystem MCP Server

Slack MCP Server

第 4 步：在 AI Chat 中使用 MCP 工具

开始对话

交互示例

第 5 步：故障排除

MCP 服务器未启动

服务器已启动但未显示工具

环境变量问题

使用 nvm 或 fnm

第 6 步：安全最佳实践

不要硬编码机密信息

限制 MCP 服务器权限

将配置文件添加到 .gitignore

支持的 JetBrains IDE

使用 AI API 进行开发

总结

相关文章

如何从零开始构建 MCP Server (2026)

如何设置 Context7 MCP Server (2026)

FastMCP：在几分钟内构建 MCP 服务器 (2026)

立即开始构建