使用说明

🔐 Jira OAuth令牌生成器

目的： 为生成OAuth凭据 Jira MCP服务器简单的方法-只需单击并复制/粘贴！

🎯 这个工具是做什么的？

您只需：

运行此服务器
点击“连接到Jira”
准备好使用Jira MCP服务器的凭据

两个项目之间的关系：

🏢 用例：企业设置

企业为什么要使用它？

问题： 公司希望他们的开发/项目管理团队使用人工智能（Claude、Cursor）与Jira进行交互，但为每个人设置OAuth既复杂又耗时。

解决方案： 部署集中式OAuth令牌生成器：

┌─────────────────────────────────────────────────────────────┐
│                      Company Workflow                       │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. IT Admin setup OAuth Generator (one-time only)          │
│     ├─ Create Atlassian OAuth App for company               │
│     ├─ Deploy internal server (or localhost)                │
│     └─ Set ALLOWED_WORKSPACE = "company-jira"               │
│                                                             │
│  2. Employees self-serve credentials (few clicks)           │
│     ├─ Open internal URL or localhost                       │
│     ├─ Click "Connect to Jira"                              │
│     ├─ Copy config JSON                                     │
│     └─ Paste into Claude/Cursor                             │
│                                                             │
│  3. Result                                                  │
│     ├─ ✅ Entire team can use AI + Jira integration         │
│     ├─ ✅ Workspace validation ensures only company staff   │
│     ├─ ✅ Tokens auto-refresh, no re-setup needed           │
│     └─ ✅ IT setup once, devs self-serve                    │
│                                                             │
└─────────────────────────────────────────────────────────────┘

🔄 OAuth流

⚡ 快速开始

1.️⃣ 安装

git clone https://github.com/dongitran/Jira-Oauth-Token-Generator.git
cd Jira-Oauth-Token-Generator
npm install

2.️⃣ 创建Atlassian OAuth应用程序

首选 Atlassian开发人员控制台
创建OAuth 2.0集成
回调URL： http://localhost:3001/auth/callback
首选权限 tab → 配置每个API：
- Jira API: read:jira-user, read:jira-work, manage:jira-project, write:jira-work, read:board-scope:jira-software, read:sprint:jira-software, write:sprint:jira-software
- 用户标识API: read:me
- Jira API（离线）: offline_access
复制 客户端ID 和 客户端密钥

3.️⃣ 配置

创建 .env 文件：

JIRA_ATLASSIAN_CLIENT_ID=your_client_id
JIRA_ATLASSIAN_CLIENT_SECRET=your_client_secret
JIRA_REDIRECT_URI=http://localhost:3001/auth/callback
PORT=3001

4.️⃣ 跑

npm start
# or: npm run dev (auto-reload)
# or: pm2 start ecosystem.config.js

📖 如何使用

第一步：身份验证

打开 http://localhost:3001
点击 “连接到Jira”
登录Atlassian并授予访问权限

步骤2：复制配置

服务器将显示JSON配置如下：

{
  "jira": {
    "command": "jira-mcp-server",
    "args": [
      "--access_token", "eyJhbGc...",
      "--refresh_token", "eyJhbGc...",
      "--client_id", "...",
      "--client_secret", "...",
      "--cloud_id", "..."
    ],
    "env": {}
  }
}

点击 “复制配置” 复制。

步骤3：在MCP客户端中使用

选项A：直接命令（推荐）

按原样使用步骤2中的配置。

选项B：全局安装（如果选项A不起作用）

有时 jira-mcp-server 可能找不到命令。在这种情况下，请全局安装该软件包：

npm install -g @urcard/jira-mcp-server

然后改用此配置格式：

{
  "jira": {
    "command": "node",
    "args": [
      "/Users/YOUR_USERNAME/.nvm/versions/node/v20.x.x/lib/node_modules/@urcard/jira-mcp-server/server.js",
      "--access_token", "eyJhbGc...",
      "--refresh_token", "eyJhbGc...",
      "--client_id", "...",
      "--client_secret", "...",
      "--cloud_id", "..."
    ],
    "env": {}
  }
}

注：替换 YOUR_USERNAME 和 v20.x.x 使用您的实际Node版本（>=20）。通过以下方式找到你的路：

which jira-mcp-server
# or
npm root -g

按客户端配置

克劳德桌面：

# open config file
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# paste into "mcpServers" section
# restart Claude Desktop

光标：

创建 .cursor/mcp.json → 粘贴配置→ 重新启动

VS代码：

# open config file
open ~/Library/Application\ Support/Code/User/mcp.json

# paste into "mcpServers" section
# restart VS Code

✅ 完成！ 令牌将自动缓存和刷新。

🔒 安全特性

CSRF保护：UUID状态令牌可防止攻击
工作区验证：只有公司员工可以进行身份验证
令牌缓存：本地存储的令牌（~/.jira mcp/），不通过网络发送
会话过期：10分钟后自动删除认证会话
无数据库：无状态设计，无敏感数据存储

📚 相关链接

Jira MCP服务器 -使用这些凭据的MCP服务器
模型上下文协议 -了解MCP

👨‍💻 作者

东川 ✨

📄 许可证

麻省理工学院

由...制作❤️ 让你的工作生活更轻松！