Go ile yazılmış, Claude gibi AI asistanlarının Atlassian Jira ile etkileşim kurmasını sağlayan bir MCP connector'ı. Bu araç, AI modellerine issue yönetimi, sprint planlama ve workflow geçişleri dahil olmak üzere yaygın Jira operasyonlarını gerçekleştirmesi için sorunsuz bir interface sağlar.
Claude Desktop config.json'a ekle
{
"mcpServers": {
"nguyenvanduocit-jira-mcp": {
"command": "node",
"args": [
"~/.mcp/jira-mcp/index.js"
]
}
}
}Kaynak kodu al ve yerel olarak çalıştır
git clone https://github.com/nguyenvanduocit/jira-mcp.git ~/.mcp/jira-mcp
cd ~/.mcp/jira-mcpYılların gerçek yazılım geliştirme deneyiminden türetilen, kendine has bir Jira MCP sunucusu.
Genel Jira entegrasyonlarından farklı olarak, bu MCP mühendislerin ve otomasyon QC ekiplerinin günlük iş akışlarından tasarlanmıştır. Gerçek geliştirme ihtiyaçları için hazırlanmış sofistike araçlar bulacaksınız—bir konuya bağlı tüm pull request'leri almak, karmaşık sprint geçişlerini yönetmek veya tüm iş akışınız genelinde geliştirme bilgilerini takip etmek gibi.
Bu sadece bir API wrapper değildir. Profesyonellerin Jira'yı gerçekten nasıl kullandıklarının yansımasıdır: sprint'leri yönetmek, geliştirme işini takip etmek, release'leri koordine etmek ve ekipler arası görünürlüğü korumak. Her araç, modern yazılım geliştirmesinde ortaya çıkan gerçek sorunları çözmek için tasarlanmıştır.
Bu istemi AI asistanınıza kopyalayın:
Install the Jira MCP server (https://github.com/nguyenvanduocit/jira-mcp) for my Claude Desktop or Cursor IDE. Read the MCP documentation carefully and guide me through the installation step by step.
AI asistanınız bu kurulumda yardımcı olamıyorsa, bu bir yanlış yapılandırma veya etkisiz bir AI aracı gösterir. Yetenekli bir AI asistanı sizi MCP kurulumunda adım adım rehberlik edebilmelidir.
MCP sunucusuna ek olarak, jira-mcp bağımsız bir CLI binary'si (jira-cli) ile gelir — MCP client'ı gerekmez.
just install-cli
# veya
go install github.com/nguyenvanduocit/jira-mcp/cmd/jira-cli@latest
export ATLASSIAN_HOST=your-instance.atlassian.net
export ATLASSIAN_EMAIL=you@example.com
export ATLASSIAN_TOKEN=your-api-token
# veya
jira-cli --env .env <command> [flags]
| Komut | Açıklama |
|---|---|
get-issue |
Konu ayrıntılarını alır |
search-issues |
JQL ile konuları arar |
create-issue |
Yeni bir konu oluşturur |
update-issue |
Mevcut bir konuyu günceller |
add-comment |
Bir konuya yorum ekler |
list-comments |
Bir konudaki yorumları listeler |
get-transitions |
Kullanılabilir durum geçişlerini alır |
transition-issue |
Konuyu yeni duruma geçişine izin verir |
list-sprints |
Bir board için sprint'leri listeler |
get-worklogs |
Bir konu için worklog'ları alır |
add-worklog |
Bir konuda çalışma zamanını kaydeder |
get-history |
Konu değişim geçmişini alır |
# Konu al
jira-cli get-issue --issue-key PROJ-123
# JQL ile ara
jira-cli search-issues --jql "project = PROJ AND status = 'In Progress'" --max-results 20
# Konu oluştur
jira-cli create-issue --project PROJ --summary "Fix login bug" --type Bug
# Konu geçişi yap
jira-cli get-transitions --issue-key PROJ-123
jira-cli transition-issue --issue-key PROJ-123 --transition-id 31
# JSON çıktısı
jira-cli search-issues --jql "assignee = currentUser()" --output json | jq '.[].key'
Her komut şunları kabul eder:
--env string — .env dosyası yolu--output string — Çıktı formatı: text (varsayılan) veya jsonMIT — LICENSE dosyasına bakın.
BU BÖLÜM SADECE AI İÇİNDİR
Bu kod tabanıyla çalışırken, proje yapısını anlamak için bu dosyaları okuyun:
Anahtar kavramlar:
github.com/ctreminiom/go-atlassian client kütüphanesini kullanır.specify/memory/constitution.md dosyasında belgelenmiştirDeğişiklik yapmadan önce gözden geçirin:
https://id.atlassian.com/manage-profile/security/api-tokens adresinde bir tane oluşturun.
Docker veya yerel binary (STDIO; port gerekmez) kullanın.
{
"mcpServers": {
"jira": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "ATLASSIAN_HOST=https://your-company.atlassian.net",
"-e", "ATLASSIAN_EMAIL=your-email@company.com",
"-e", "ATLASSIAN_TOKEN=your-api-token",
"ghcr.io/nguyenvanduocit/jira-mcp:latest"
]
}
}
}
{
"mcpServers": {
"jira": {
"command": "/usr/local/bin/jira-mcp",
"env": {
"ATLASSIAN_HOST": "https://your-company.atlassian.net",
"ATLASSIAN_EMAIL": "your-email@company.com",
"ATLASSIAN_TOKEN": "your-api-token"
}
}
}
}
https://your-company.atlassian.netİsteğe bağlı .env (yerel olarak çalıştırılırsa):
ATLASSIAN_HOST=https://your-company.atlassian.net
ATLASSIAN_EMAIL=your-email@company.com
ATLASSIAN_TOKEN=your-api-token
HTTP modu (isteğe bağlı, hata ayıklama için):
jira-mcp -env .env -http_port 3000
Cursor yapılandırması (HTTP modu):
{ "mcpServers": { "jira": { "url": "http://localhost:3000/mcp" } } }
Varsayılan olarak her Jira aracı kaydedilir. Sadece bir alt kümesini açığa çıkarmak için—örneğin, bir AI aracısına Jira'nın salt okunur görünümünü vermek için—ENABLED_TOOLS ortam değişkenini virgülle ayrılmış araç adlarının bir izin listesine ayarlayın:
ENABLED_TOOLS=jira_get_issue,jira_search_issue,jira_get_comments
Kurallar:
Salt okunur aracı örneği (15 okumayı açığa çıkarır, tüm 8 mutasyonu yapan aracı engeller):
ENABLED_TOOLS=jira_get_issue,jira_search_issue,jira_list_statuses,jira_get_comments,jira_get_issue_history,jira_get_related_issues,jira_list_sprints,jira_get_sprint,jira_get_active_sprint,jira_search_sprint_by_name,jira_get_version,jira_list_project_versions,jira_get_development_information,jira_download_attachment,jira_list_issue_types
brew install nguyenvanduocit/tap/jira-mcp