🚀 代理团队设置指南

使用 Jira、GitHub 和 Claude 设置多代理系统的完整指南。

______________________________________________________________________

📋 目录

条件
API密钥和代币beschaffen
设置环境文件
安装和启动
故障排除

______________________________________________________________________

🔧 条件

软件

Node.js v18+和npm
Git （Github集成）
结束 Jira工作区 （云版本）
结束 GitHub存储库
结束 无烟煤API密钥 （Claude）

账户

Jira Cloud 帐户（推荐使用管理员权限）
GitHub 帐户与存储库访问
API-Zugang的人类账户

______________________________________________________________________

🔑 API密钥和代币beschaffen

1.无烟煤API密钥（Claude）

是： Claude AI Model 的 API 访问

沃： Anthropic 控制台

步骤：

葛和祖https://console.anthropic.com/
登录 / 创建帐户
导航： Settings → API Keys
点击 Create Key
复制密钥（看起来像 sk-ant-api03-...)

费用：

现收现付：每百万代币约3-15美元（克劳德·索内特4）
可用于新账户的积分

重要： ⚠️ Git提交中的关键NIEMALS！

______________________________________________________________________

2.Jira API代币

是： Jira REST API 认证

沃： Atlassian帐户设置

步骤：

葛和祖https://id.atlassian.com/manage-profile/security/api-tokens
点击 Create API token
输入名称（例如“代理团队”）
复制生成的令牌（仅显示一次！）

格式： Base64编码 email:token

重要：

令牌是个人的（如果可能，请使用服务帐户）
代币不会过期，但可以随时撤销

______________________________________________________________________

3.GitHub个人访问令牌（PAT）

是： GitHub API 身份验证

沃：

步骤：

葛和祖https://github.com/settings/tokens
点击 Generate new token → Generate new token (classic)
重要： 选择以下范围：

- ✅ repo （完全控制私有存储库） - repo:status - repo_deployment - public_repo - repo:invite - ✅ workflow （更新GitHub Action工作流） - ✅ write:packages （将包上传到GitHub包注册表） - ✅ read:org （阅读组织和团队成员）

设置到期日期（推荐：90天，生产：无到期）
克里克 Generate token
复制令牌（从 ghp_... 或 github_pat_...)

重要：

令牌只显示一次 - 立即备份！
使用机器人帐户进行生产

______________________________________________________________________

4.Jira工作区详细信息

您需要：

工作区URL （z.B。 https://yourcompany.atlassian.net)
项目密钥 （z.B。 AT, PROJ等等）

在哪里找到：

前往您的 Jira Board
工作空间 URL 在浏览器地址中
您可以在每张票中找到项目密钥（例如： AT-123 → 密钥列表 AT)

______________________________________________________________________

5.GitHub存储库详细信息

您需要：

存储库所有者 （GitHub 用户名或组织）
仓库名称

例如：

网址： https://github.com/microsoft/vscode
业主： microsoft
代表： vscode

______________________________________________________________________

📁 设置环境文件

结构

该项目需要 4单独 .env 文件:

AITest/
├── agents/
│   ├── coder/.env          # Coder Agent
│   ├── reviewer/.env       # Review Agent
│   └── tpo/.env           # TPO Agent
├── mcp-servers/
│   ├── github/.env        # GitHub MCP Server
│   └── jira/.env          # Jira MCP Server
└── event-hub/.env         # Event Hub

______________________________________________________________________

1.活动中心(`.env`)

路径： AITest/event-hub/.env

# Server Configuration
PORT=3000
NODE_ENV=development

# CORS (falls Frontend auf anderem Port läuft)
ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000

解释：

PORT事件中心运行的端口（默认：3000）
ALLOWED_ORIGINS逗号分隔的允许前端 URL 列表

______________________________________________________________________

2.Jira MCP服务器(`.env`)

路径： AITest/mcp-servers/jira/.env

# Jira Configuration
JIRA_DOMAIN=yourcompany.atlassian.net
JIRA_EMAIL=your-email@company.com
JIRA_API_TOKEN=your_jira_api_token_here

# MCP Server Configuration
PORT=3001
NODE_ENV=development

# Optional: Default Project
DEFAULT_PROJECT_KEY=AT

我从哪里得到价值：

变量	在哪里找到	例子
`JIRA_DOMAIN` Jira 的浏览器 URL `yourcompany.atlassian.net`
`JIRA_EMAIL`	您的 Jira 电子邮件地址	`patrick@company.com`
`JIRA_API_TOKEN`	查看 Jira API代币	`ATATT3xFf...`
`DEFAULT_PROJECT_KEY`	门票前缀在 Jira	`AT` （AT-123号）

测试它是否工作：

cd mcp-servers/jira
npm start
# Öffne http://localhost:3001/health

______________________________________________________________________

3.GitHub MCP服务器(`.env`)

路径： AITest/mcp-servers/github/.env

# GitHub Configuration
GITHUB_TOKEN=your_github_personal_access_token
GITHUB_OWNER=your-github-username
GITHUB_REPO=your-repository-name

# MCP Server Configuration
PORT=3002
NODE_ENV=development

# Optional: Default Branch
DEFAULT_BRANCH=main

我从哪里得到价值：

变量	在哪里找到	例子
`GITHUB_TOKEN`	查看	`ghp_abc123...`
`GITHUB_OWNER`	GitHub用户名/组织	`patrickschlueer`
`GITHUB_REPO`	存储库名称	`agent-test`
`DEFAULT_BRANCH`	Haupt分行名称	`main` 或 `master`

测试它是否工作：

cd mcp-servers/github
npm start
# Öffne http://localhost:3002/health

______________________________________________________________________

4.TPO代理(`.env`)

路径： AITest/agents/tpo/.env

# Anthropic API
ANTHROPIC_API_KEY=sk-ant-api03-your-key-here

# Agent Identity
AGENT_NAME=TPO Agent
AGENT_EMOJI=🎯

# Service URLs
JIRA_MCP_SERVER_URL=http://localhost:3001
EVENT_HUB_URL=http://localhost:3000

# Jira Project
JIRA_PROJECT_KEY=AT

解释：

ANTHROPIC_API_KEY：查看无烟煤API密钥
AGENT_NAME代理的显示名称（可自定义）
AGENT_EMOJI用户界面表情符号（可选自定义）
JIRA_MCP_SERVER_URL：Jira MCP服务器的URL（标准：本地主机：3001）
EVENT_HUB_URL：事件中心URL（标准：本地主机：3000）
JIRA_PROJECT_KEY：Dein Jira项目密钥

______________________________________________________________________

5.编码代理(`.env`)

路径： AITest/agents/coder/.env

# Anthropic API
ANTHROPIC_API_KEY=sk-ant-api03-your-key-here

# Agent Identity
AGENT_NAME=Coder Agent
AGENT_EMOJI=👨‍💻

# Service URLs
JIRA_MCP_SERVER_URL=http://localhost:3001
GITHUB_MCP_SERVER_URL=http://localhost:3002
EVENT_HUB_URL=http://localhost:3000

# Jira Project
JIRA_PROJECT_KEY=AT

与TPO代理相同的键，加上：

GITHUB_MCP_SERVER_URLGitHub MCP 服务器的 URL

______________________________________________________________________

6.审查代理(`.env`)

路径： AITest/agents/reviewer/.env

# Anthropic API
ANTHROPIC_API_KEY=sk-ant-api03-your-key-here

# Agent Identity
AGENT_NAME=Review Agent
AGENT_EMOJI=🔍

# Service URLs
JIRA_MCP_SERVER_URL=http://localhost:3001
GITHUB_MCP_SERVER_URL=http://localhost:3002
EVENT_HUB_URL=http://localhost:3000

# Jira Project (optional, falls benötigt)
JIRA_PROJECT_KEY=AT

______________________________________________________________________

📦 安装和启动

1、安装依赖关系

# Root-Level
cd AITest
npm install

# Event Hub
cd event-hub
npm install

# MCP Servers
cd ../mcp-servers/jira
npm install

cd ../github
npm install

# Agents
cd ../../agents/tpo
npm install

cd ../coder
npm install

cd ../reviewer
npm install

2.环境文件有效

检查表：

\[\]共6个 .env 已创建文件
注册所有API密钥
\[ \] URL中没有输入错误
\[ \] 端口是免费的（3000， 3001， 3002）

快速测试脚本：

# Erstelle test-env.js im Root
node test-env.js

📄 test-env.js Code

// test-env.js
import dotenv from 'dotenv';
import { existsSync } from 'fs';
import { resolve } from 'path';

const envFiles = [
  'event-hub/.env',
  'mcp-servers/jira/.env',
  'mcp-servers/github/.env',
  'agents/tpo/.env',
  'agents/coder/.env',
  'agents/reviewer/.env'
];

console.log('🔍 Checking .env files...\n');

let allGood = true;

for (const file of envFiles) {
  const path = resolve(file);
  const exists = existsSync(path);
  
  console.log(`${exists ? '✅' : '❌'} ${file}`);
  
  if (exists) {
    dotenv.config({ path });
    // Check for critical keys
    if (file.includes('agent')) {
      if (!process.env.ANTHROPIC_API_KEY) {
        console.log(`   ⚠️  Missing ANTHROPIC_API_KEY`);
        allGood = false;
      }
    }
  } else {
    allGood = false;
  }
}

console.log(`\n${allGood ? '✅ All good!' : '❌ Some files missing or incomplete'}`);

3.服务开始

选项A:Manuell在单独的码头

# Terminal 1 - Event Hub
cd event-hub
npm start

# Terminal 2 - Jira MCP Server
cd mcp-servers/jira
npm start

# Terminal 3 - GitHub MCP Server
cd mcp-servers/github
npm start

# Terminal 4 - TPO Agent
cd agents/tpo
npm start

# Terminal 5 - Coder Agent
cd agents/coder
npm start

# Terminal 6 - Review Agent
cd agents/reviewer
npm start

选项 B：使用过程管理器（推荐）

# Installiere PM2
npm install -g pm2

# Starte alle Services
pm2 start ecosystem.config.cjs

# Status prüfen
pm2 status

# Logs anschauen
pm2 logs

# Stoppen
pm2 stop all

📄 ecosystem.config.cjs

module.exports = {
  apps: [
    {
      name: 'event-hub',
      cwd: './event-hub',
      script: 'server.js',
      watch: false
    },
    {
      name: 'jira-mcp',
      cwd: './mcp-servers/jira',
      script: 'server.js',
      watch: false
    },
    {
      name: 'github-mcp',
      cwd: './mcp-servers/github',
      script: 'server.js',
      watch: false
    },
    {
      name: 'tpo-agent',
      cwd: './agents/tpo',
      script: 'agent.js',
      watch: false
    },
    {
      name: 'coder-agent',
      cwd: './agents/coder',
      script: 'agent.js',
      watch: false
    },
    {
      name: 'review-agent',
      cwd: './agents/reviewer',
      script: 'agent.js',
      watch: false
    }
  ]
};

4.健康检查

检查所有服务是否正在运行：

# Event Hub
curl http://localhost:3000/health

# Jira MCP
curl http://localhost:3001/health

# GitHub MCP
curl http://localhost:3002/health

预期响应：

{
  "status": "ok",
  "service": "..."
}

______________________________________________________________________

🔥 故障排除

问题：“未设置ANTHROPIC_API_KEY”

解决方案：

PRüFe ob .env 文件已存在
检查拼写： ANTHROPIC_API_KEY （不 ANTHROPIC_KEY)
钥匙必须戴上 sk-ant-api03- 开始
关键周围没有引号

# Richtig:
ANTHROPIC_API_KEY=sk-ant-api03-abc123...

# Falsch:
ANTHROPIC_API_KEY="sk-ant-api03-abc123..."

______________________________________________________________________

问题：“无法连接到Jira”

可能的原因：

错误的域名： 曼联足球学校 yourcompany.atlassian.net （无） https://)
电子邮件错误： 必须是登录Jira的电子邮件
API令牌过期/错误： 创建新令牌

测试：

# Test Jira Connection
curl -u your-email@company.com:your_api_token \
  https://yourcompany.atlassian.net/rest/api/3/myself

______________________________________________________________________

问题：“超过了GitHub API速率限制”

乌尔萨奇： GitHub 每小时只允许 60 个请求

解决方案：

PRüFe ob GITHUB_TOKEN 已设置
令牌的作用域 repo 有
使用机器人帐户获得更高的限额

______________________________________________________________________

问题：“端口3000已在使用中”

解决方案：

# Finde Prozess auf Port 3000
# Windows:
netstat -ano | findstr :3000
taskkill /PID 
 /F

# Mac/Linux:
lsof -ti:3000 | xargs kill -9

或者更改端口 .env:

PORT=3010

______________________________________________________________________

问题：“找不到模块”

解决方案：

# Dependencies neu installieren
rm -rf node_modules package-lock.json
npm install

______________________________________________________________________

问题：代理正在运行，但什么也不做

检查表：

门票状态正确吗？（TPO：“开放”，编码器：“要做”）
代理人有正确的 Jira 项目密钥吗？
Event Hub + MCP 服务器是否可用？
检查代理日志错误

启用调试模式：

# In Agent .env
NODE_ENV=development
DEBUG=true

______________________________________________________________________

🔒 安全最佳实践

API 密钥保护

从不提交：

# .gitignore überprüfen
cat .gitignore

# Sollte enthalten:
.env
.env.*
*.env

使用 Production: Secrets Manager

- AWS Secrets Manager - Azure密钥库 - GitHub 秘密（GitHub Actions）

定期旋转键

- 人类：每90天 - GitHub PAT: 每90天 - Jira：涉嫌妥协

最小特权原理

- GitHub Token：只有必要的范围 - Jira：具有最低权限的服务帐户

______________________________________________________________________

📚 更多资源

______________________________________________________________________

🆘 支持

遇到问题：

检查模具日志： pm2 logs 或终端输出
Prüfe健康终点
有效期 .env 文件
在 GitHub 上创建问题

______________________________________________________________________

代理团队合作愉快！ 🤖🤝

AI MCP test

快速接入

详细介绍

🚀 代理团队设置指南

📋 目录

🔧 条件

软件

账户

🔑 API密钥和代币beschaffen

1.无烟煤API密钥（Claude）

2.Jira API代币

3.GitHub个人访问令牌（PAT）

4.Jira工作区详细信息

5.GitHub存储库详细信息

📁 设置环境文件

结构

1.活动中心(.env)

2.Jira MCP服务器(.env)

3.GitHub MCP服务器(.env)

4.TPO代理(.env)

5.编码代理(.env)

6.审查代理(.env)

📦 安装和启动

1、安装依赖关系

2.环境文件有效

3.服务开始

4.健康检查

🔥 故障排除

问题：“未设置ANTHROPIC_API_KEY”

问题：“无法连接到Jira”

问题：“超过了GitHub API速率限制”

问题：“端口3000已在使用中”

问题：“找不到模块”

问题：代理正在运行，但什么也不做

🔒 安全最佳实践

API 密钥保护

📚 更多资源

🆘 支持

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

1.活动中心(`.env`)

2.Jira MCP服务器(`.env`)

3.GitHub MCP服务器(`.env`)

4.TPO代理(`.env`)

5.编码代理(`.env`)

6.审查代理(`.env`)