使用说明
JiraMcpServer 服务器
服务器 模型上下文协议（MCP） 将Jira作为MCP客户端的工具，例如Claude Desktop。它允许 Claude 通过自然语言直接在 Jira 中查看、创建和更新问题、项目和用户。
先决条件
- .NET 8.0 SDK
- 拥有 API 访问权限的 Jira （Cloud） 帐户
如何生成 Jira API Token
- 访问 id.atlassian.com/manage-profile/security/api-tokens
- Clique em 创建API令牌
- 给令牌命名（ 例如 ：
claude-mcp)e拉他们 创建 - 复制生成的令牌 — 不会再显示
凭据设置
服务器需要三个环境变量：
| 变量 | 描述 | 示例 |
|---|---|---|
JIRA_BASE_URL Jira 实例的基本 URL。 https://suaorg.atlassian.net |
||
JIRA_EMAIL |
E-mail da conta Jira | voce@exemplo.com |
JIRA_API_TOKEN |
在上一步中生成的 API Token | ATATxxxxxxxxxxxxxxxx |
终端（Linux/macOS）
export JIRA_BASE_URL="https://suaorg.atlassian.net"
export JIRA_EMAIL="voce@exemplo.com"
export JIRA_API_TOKEN="ATATxxxxxxxxxxxxxxxx"
终端窗口（cmd）
set JIRA_BASE_URL=https://suaorg.atlassian.net
set JIRA_EMAIL=voce@exemplo.com
set JIRA_API_TOKEN=ATATxxxxxxxxxxxxxxxx
终端窗口（PowerShell）
$env:JIRA_BASE_URL = "https://suaorg.atlassian.net"
$env:JIRA_EMAIL = "voce@exemplo.com"
$env:JIRA_API_TOKEN = "ATATxxxxxxxxxxxxxxxx"
克劳德桌面(claude_desktop_config.json)
在下面添加条目 mcpServers 在 Claude Desktop 配置文件中。文件位于 ：
- 窗户：
%APPDATA%\Claude\claude_desktop_config.json - macOS：
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"jira": {
"command": "dotnet",
"args": ["run", "--project", "C:\\Projects\\JiraMcpServer"],
"env": {
"JIRA_BASE_URL": "https://suaorg.atlassian.net",
"JIRA_EMAIL": "voce@exemplo.com",
"JIRA_API_TOKEN": "ATATxxxxxxxxxxxxxxxx"
}
}
}
}
智利 使用已发布的二进制代替
dotnet run替换"command"通过生成的可执行文件路径dotnet publish.
如何运行
dotnet build # Compilar o projeto
dotnet run # Iniciar o servidor MCP via stdio
可用工具
服务器将 12 个 MCP 工具分为三组：
问题
| 工具 | 描述 |
|---|---|
GetIssue 通过键返回问题的详细信息（例如： PROJ-123) |
|
CreateIssue 在项目中创建一个新问题 |
|
UpdateIssue |
更新现有问题的字段 |
SearchIssues |
Busca发布usando JQL（Jira查询语言） |
GetIssueTransitions |
列出一个问题可用的工作流过渡 |
TransitionIssue |
通过过渡 ID 将问题移动到新状态 |
AddComment 添加一个评论到一个问题 |
|
GetComments |
返回一个问题的所有评论 |
项目
| 工具 | 描述 |
|---|---|
ListProjects 列出所有可供用户访问的 Jira 项目 |
|
GetProject 按键返回项目的详细信息。 |
用户
| 工具 | 描述 |
|---|---|
GetCurrentUser |
返回已验证用户的配置文件 |
SearchUsers 按姓名或电子邮件搜索 Jira 用户 |
