CircleCI

Ön koşullar:

• CircleCI Kişisel API token'ı (daha fazla bilgi)
• NPX: Node.js >= v18 ve pnpm
• Docker: Docker

Yerel MCP Sunucusunda NPX Kullanımı

Cursor MCP yapılandırmanıza aşağıdakini ekleyin:

{ "mcpServers": { "circleci-mcp-server": { "command": "npx", "args": ["-y", "@circleci/mcp-server-circleci@latest"], "env": { "CIRCLECI_TOKEN": "your-circleci-token", "CIRCLECI_BASE_URL": "https://circleci.com", "MAX_MCP_OUTPUT_LENGTH": "50000" } } }
}

CIRCLECI_BASE_URL isteğe bağlıdır — yalnızca şirket içi (on-prem) müşteriler için gereklidir.
MAX_MCP_OUTPUT_LENGTH isteğe bağlıdır — MCP yanıtları için maksimum çıktı uzunluğu (varsayılan: 50000).

Yerel MCP Sunucusunda Docker Kullanımı

Cursor MCP yapılandırmanıza aşağıdakini ekleyin:

{ "mcpServers": { "circleci-mcp-server": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "CIRCLECI_TOKEN", "-e", "CIRCLECI_BASE_URL", "-e", "MAX_MCP_OUTPUT_LENGTH", "circleci/mcp-server-circleci" ], "env": { "CIRCLECI_TOKEN": "your-circleci-token", "CIRCLECI_BASE_URL": "https://circleci.com", "MAX_MCP_OUTPUT_LENGTH": "50000" } } }
}

Kendi Kendine Yönetilen Uzak MCP Sunucusu Kullanımı

Bkz. Kendi Kendine Yönetilen Uzak MCP Sunucusu. Kullanıcı başına istemci yapılandırmasını kullanın ve Cursor MCP yapılandırmanıza ekleyin (Cursor Settings → MCP).

Ön koşullar:

• CircleCI Kişisel API token'ı (daha fazla bilgi)
• NPX: Node.js >= v18 ve pnpm
• Docker: Docker

Yerel MCP Sunucusunda NPX Kullanımı

Projenizdeki .vscode/mcp.json dosyasına aşağıdakini ekleyin:

{ "inputs": [ { "type": "promptString", "id": "circleci-token", "description": "CircleCI API Token", "password": true }, { "type": "promptString", "id": "circleci-base-url", "description": "CircleCI Base URL", "default": "https://circleci.com" } ], "servers": { "circleci-mcp-server": { "type": "stdio", "command": "npx", "args": ["-y", "@circleci/mcp-server-circleci@latest"], "env": { "CIRCLECI_TOKEN": "${input:circleci-token}", "CIRCLECI_BASE_URL": "${input:circleci-base-url}" } } }
}

💡 Girdiler ilk sunucu başlatılışında sorulur, ardından VS Code tarafından güvenli şekilde saklanır.

Yerel MCP Sunucusunda Docker Kullanımı

Projenizdeki .vscode/mcp.json dosyasına aşağıdakini ekleyin:

{ "inputs": [ { "type": "promptString", "id": "circleci-token", "description": "CircleCI API Token", "password": true }, { "type": "promptString", "id": "circleci-base-url", "description": "CircleCI Base URL", "default": "https://circleci.com" } ], "servers": { "circleci-mcp-server": { "type": "stdio", "command": "docker", "args": [ "run", "--rm", "-i", "-e", "CIRCLECI_TOKEN", "-e", "CIRCLECI_BASE_URL", "circleci/mcp-server-circleci" ], "env": { "CIRCLECI_TOKEN": "${input:circleci-token}", "CIRCLECI_BASE_URL": "${input:circleci-base-url}" } } }
}

Kendi Kendine Yönetilen Uzak MCP Sunucusu Kullanımı

Bkz. Kendi Kendine Yönetilen Uzak MCP Sunucusu. .vscode/mcp.json içindeki kullanıcı başına istemci yapılandırmasını kullanın.

Ön koşullar:

• CircleCI Kişisel API token'ı (daha fazla bilgi)
• NPX: Node.js >= v18 ve pnpm
• Docker: Docker

Yerel MCP Sunucusunda NPX Kullanımı

claude_desktop_config.json dosyanıza aşağıdakini ekleyin:

{ "mcpServers": { "circleci-mcp-server": { "command": "npx", "args": ["-y", "@circleci/mcp-server-circleci@latest"], "env": { "CIRCLECI_TOKEN": "your-circleci-token", "CIRCLECI_BASE_URL": "https://circleci.com", "MAX_MCP_OUTPUT_LENGTH": "50000" } } }
}

Yerel MCP Sunucusunda Docker Kullanımı

claude_desktop_config.json dosyanıza aşağıdakini ekleyin:

{ "mcpServers": { "circleci-mcp-server": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "CIRCLECI_TOKEN", "-e", "CIRCLECI_BASE_URL", "-e", "MAX_MCP_OUTPUT_LENGTH", "circleci/mcp-server-circleci" ], "env": { "CIRCLECI_TOKEN": "your-circleci-token", "CIRCLECI_BASE_URL": "https://circleci.com", "MAX_MCP_OUTPUT_LENGTH": "50000" } } }
}

Kendi Kendine Yönetilen Uzak MCP Sunucusu Kullanımı

Bkz. Kendi Kendine Yönetilen Uzak MCP Sunucusu. Claude Desktop ve CLI istemcileri bölümünde gösterildiği gibi bir sarmalayıcı betik oluşturun ve ardından claude_desktop_config.json dosyanızı buna yönlendirin.

Yapılandırma dosyanızı bulmak veya oluşturmak için Claude Desktop ayarlarını açın, sol kenar çubuğunda Developer seçeneğine tıklayın ve ardından Edit Config seçeneğine tıklayın. Yapılandırma dosyası şu konumdadır:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%Claudeclaude_desktop_config.json

Daha fazla bilgi için: https://modelcontextprotocol.io/quickstart/user

Ön koşullar:

• CircleCI Kişisel API token'ı (daha fazla bilgi)
• NPX: Node.js >= v18 ve pnpm
• Docker: Docker

Yerel MCP Sunucusunda NPX Kullanımı

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci@latest

Yerel MCP Sunucusunda Docker Kullanımı

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com -- docker run --rm -i -e CIRCLECI_TOKEN -e CIRCLECI_BASE_URL circleci/mcp-server-circleci

Kendi Kendine Yönetilen Uzak MCP Sunucusu Kullanımı

Bkz. Kendi Kendine Yönetilen Uzak MCP Sunucusu ve oradaki Claude Code istemci kurulumu.

Ön koşullar:

• CircleCI Kişisel API token'ı (daha fazla bilgi)
• NPX: Node.js >= v18 ve pnpm
• Docker: Docker

Yerel MCP Sunucusunda NPX Kullanımı

Windsurf mcp_config.json dosyanıza aşağıdakini ekleyin:

{ "mcpServers": { "circleci-mcp-server": { "command": "npx", "args": ["-y", "@circleci/mcp-server-circleci@latest"], "env": { "CIRCLECI_TOKEN": "your-circleci-token", "CIRCLECI_BASE_URL": "https://circleci.com", "MAX_MCP_OUTPUT_LENGTH": "50000" } } }
}

Yerel MCP Sunucusunda Docker Kullanımı

Windsurf mcp_config.json dosyanıza aşağıdakini ekleyin:

{ "mcpServers": { "circleci-mcp-server": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "CIRCLECI_TOKEN", "-e", "CIRCLECI_BASE_URL", "-e", "MAX_MCP_OUTPUT_LENGTH", "circleci/mcp-server-circleci" ], "env": { "CIRCLECI_TOKEN": "your-circleci-token", "CIRCLECI_BASE_URL": "https://circleci.com", "MAX_MCP_OUTPUT_LENGTH": "50000" } } }
}

Kendi Kendine Yönetilen Uzak MCP Sunucusu Kullanımı

Bkz. Kendi Kendine Yönetilen Uzak MCP Sunucusu. Windsurf mcp_config.json dosyanızda kullanıcı başına istemci yapılandırmasını kullanın.

Daha fazla bilgi için: https://docs.windsurf.com/windsurf/mcp

Ön koşullar:

• CircleCI Kişisel API token'ı (daha fazla bilgi)
• NPX: Node.js >= v18 ve pnpm

Amazon Q Developer'daki MCP istemci yapılandırması, mcp.json adlı bir dosyada JSON biçiminde saklanır. İki düzey yapılandırma desteklenir:

• Genel (Global): ~/.aws/amazonq/mcp.json — tüm çalışma alanları için geçerlidir
• Çalışma alanı (Workspace): .amazonq/mcp.json — yalnızca geçerli çalışma alanına özgüdür

Her iki dosya da mevcutsa içerikleri birleştirilir. Çakışma durumunda çalışma alanı yapılandırması önceliklidir.

Yerel MCP Sunucusunda NPX Kullanımı

~/.aws/amazonq/mcp.json dosyasını düzenleyin veya aşağıdaki içerikle .amazonq/mcp.json dosyasını oluşturun:

{ "mcpServers": { "circleci-local": { "command": "npx", "args": [ "-y", "@circleci/mcp-server-circleci@latest" ], "env": { "CIRCLECI_TOKEN": "YOUR_CIRCLECI_TOKEN", "CIRCLECI_BASE_URL": "https://circleci.com", "MAX_MCP_OUTPUT_LENGTH": "50000" }, "timeout": 60000 } }
}

Kendi Kendine Yönetilen Uzak MCP Sunucusu Kullanımı

Bkz. Kendi Kendine Yönetilen Uzak MCP Sunucusu. Claude Desktop ve CLI istemcileri bölümünde gösterildiği gibi bir sarmalayıcı betik kullanın ve ardından q mcp add ile kaydedin.

Ön koşullar:

• CircleCI Kişisel API token'ı (daha fazla bilgi)
• NPX: Node.js >= v18 ve pnpm

Yerel MCP Sunucusunda NPX Kullanımı

~/.aws/amazonq/mcp.json dosyasını düzenleyin veya aşağıdaki içerikle .amazonq/mcp.json dosyasını oluşturun:

{ "mcpServers": { "circleci-local": { "command": "npx", "args": [ "-y", "@circleci/mcp-server-circleci@latest" ], "env": { "CIRCLECI_TOKEN": "YOUR_CIRCLECI_TOKEN", "CIRCLECI_BASE_URL": "https://circleci.com", "MAX_MCP_OUTPUT_LENGTH": "50000" }, "timeout": 60000 } }
}

Kendi Kendine Yönetilen Uzak MCP Sunucusu Kullanımı

Bkz. Kendi Kendine Yönetilen Uzak MCP Sunucusu. Claude Desktop ve CLI istemcileri bölümünde gösterildiği gibi bir sarmalayıcı betik kullanın ve ardından MCP yapılandırma arayüzü üzerinden ekleyin:

1. MCP yapılandırma arayüzüne erişin
2. + sembolünü seçin
3. Kapsamı seçin: global veya local
4. Bir ad girin (örn. circleci-remote-mcp)
5. Taşıma protokolünü seçin: stdio
6. Betiğinizin komut yolunu girin
7. Save düğmesine tıklayın

CircleCI MCP Sunucusunu Smithery aracılığıyla Claude Desktop için otomatik olarak kurmak için:

npx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude

Örnek: "Dalımdaki en son başarısız işlem hattını bul ve günlükleri al"
— daha fazla örnek için wiki sayfasına bakın.

https://github.com/user-attachments/assets/3c765985-8827-442a-a8dc-5069e01edb74

CircleCI yapılandırma görevlerinde rehberlik ve doğrulama sağlayarak yardımcı olur.

• .circleci/config.yml dosyanızı sözdizimi ve anlamsal hatalar için doğrular
• Ayrıntılı doğrulama sonuçları ve yapılandırma önerileri sağlar
• Örnek: "CircleCI yapılandırmamı doğrula"

Belirli bir kuruluş için CircleCI Kullanım API'sinden kullanım verilerini indirir. Esnek tarih girişini kabul eder (örn. "Mart 2025" veya "geçen ay"). Yalnızca bulut özelliği.

Seçenek 1: Aşağıdakileri sağlayarak yeni bir dışa aktarma işi başlatın:

• orgId, startDate, endDate (en fazla 32 gün), outputDir

Seçenek 2: Aşağıdakileri sağlayarak mevcut bir dışa aktarma işini kontrol edin/indirin:

• orgId, jobId, outputDir

Belirtilen zaman aralığı için CircleCI kullanım verilerini içeren bir CSV dosyası döndürür.

[!NOTE]
Kullanım verileri, maliyet optimizasyonu analizi için find_underused_resource_classes aracına beslenebilir.

Test yürütme geçmişini analiz ederek CircleCI projenizdeki kararsız testleri belirler. CircleCI'daki kararsız test algılama özelliğini kullanır.

Bu araç üç şekilde kullanılabilir:

1. Proje Slug'ı Kullanma (Önerilen):

   • Önce projelerinizi almak için list_followed_projects kullanın, ardından:
   • Örnek: "projem için kararsız testleri al"

2. CircleCI Proje URL'sini Kullanma:

   • Örnek: "https://app.circleci.com/pipelines/github/org/repo içindeki kararsız testleri bul"

3. Yerel Proje Bağlamını Kullanma:

   • Çalışma alanı kökü ve git uzak URL'si sağlayarak yerel çalışma alanınızdan çalışır
   • Örnek: "Geçerli projemdeki kararsız testleri bul"

Çıktı modları:

• Metin (varsayılan): Kararsız test ayrıntılarını metin biçiminde döndürür
• Dosya (FILE_OUTPUT_DIRECTORY ortam değişkeni gerektirir): Kararsız test ayrıntılarıyla bir dizin oluşturur

Ortalama veya maksimum CPU/RAM kullanımı belirli bir eşiğin (varsayılan: %40) altında olan işleri bulmak için bir CircleCI kullanım verisi CSV dosyasını analiz eder.

download_usage_api_data dosyasından alınan bir CSV dosyası sağlayın.

Proje ve iş akışına göre düzenlenmiş, yetersiz kullanılan işlerin markdown listesini döndürür — maliyet optimizasyonu fırsatlarını belirlemek için kullanışlıdır.

CircleCI derlemelerinden ayrıntılı hata günlüklerini alır. Bu araç üç şekilde kullanılabilir:

1. Proje Slug'ı ve Dal Kullanma (Önerilen):

   • Önce projelerinizi almak için list_followed_projects kullanın, ardından:
   • Örnek: "ana daldaki projem için derleme hatalarını al"

2. CircleCI URL'lerini Kullanma:

   • Doğrudan başarısız bir iş URL'si veya işlem hattı URL'si sağlayın
   • Örnek: "https://app.circleci.com/pipelines/github/org/repo/123 adresinden günlükleri al"

3. Yerel Proje Bağlamını Kullanma:

   • Çalışma alanı kökü, git uzak URL'si ve dal adı sağlayarak yerel çalışma alanınızdan çalışır
   • Örnek: "Geçerli dalımdaki en son başarısız işlem hattını bul"

Araç, aşağıdakileri içeren biçimlendirilmiş günlükleri döndürür:

• İş adları
• Adım adım yürütme ayrıntıları
• Hata mesajları ve bağlam

CircleCI işleri için test meta verilerini alır ve IDE'nizden ayrılmadan test sonuçlarını analiz etmenize olanak tanır. Bu araç üç şekilde kullanılabilir:

1. Proje Slug'ı ve Dal Kullanma (Önerilen):

   • Örnek: "ana daldaki projem için test sonuçlarını al"

2. CircleCI URL'sini Kullanma:

   • İş URL'si: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def/jobs/789
   • İş akışı URL'si: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def
   • İşlem hattı URL'si: https://app.circleci.com/pipelines/github/org/repo/123

3. Yerel Proje Bağlamını Kullanma:

   • Çalışma alanı kökü, git uzak URL'si ve dal adı sağlayarak yerel çalışma alanınızdan çalışır

Araç şunları döndürür:

• Tüm testlerin özeti (toplam, başarılı, başarısız)
• Başarısız testlerle ilgili ayrıntılı bilgi: ad, sınıf, dosya, hata mesajı, süre
• Zamanlamalı başarılı testlerin listesi
• Test sonucuna göre filtreleme

[!NOTE]
Test meta verileri CircleCI yapılandırmanızda yapılandırılmalıdır. Kurulum talimatları için Test Verilerini Topla bölümüne bakın.

Belirli bir dal için en son pipeline'ın durumunu alır. Bu araç üç şekilde kullanılabilir:

1. Proje Slug'ı ve Dal Kullanma (Önerilen):

   • Örnek: "main dalındaki my-project için en son pipeline'ın durumunu al"

2. CircleCI Proje URL'si Kullanma:

   • Örnek: "https://app.circleci.com/pipelines/github/org/repo için en son pipeline'ın durumunu al"

3. Yerel Proje Bağlamını Kullanma:

   • Çalışma alanı kökü, git remote URL'si ve dal adı sağlayarak yerel çalışma alanınızdan çalışır

Örnek çıktı:

---
Workflow: build
Status: success
Duration: 5 minutes
Created: 4/20/2025, 10:15:30 AM
Stopped: 4/20/2025, 10:20:45 AM
---
Workflow: test
Status: running
Duration: unknown
Created: 4/20/2025, 10:21:00 AM
Stopped: in progress

Bir CircleCI işi tarafından üretilen yapıtların listesini alır. Bu araç üç şekilde kullanılabilir:

1. Proje Slug'ı ve Dal Kullanma (Önerilen):

   • Önce projelerinizi almak için list_followed_projects kullanın, ardından:
   • Örnek: "main dalındaki my-project için yapıtları listele"

2. CircleCI URL'si Kullanma:

   • İş URL'si: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/789
   • İş akışı URL'si: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def
   • Pipeline URL'si: https://app.circleci.com/pipelines/gh/organization/project/123

3. Yerel Proje Bağlamını Kullanma:

   • Çalışma alanı kökü, git remote URL'si ve dal adı sağlayarak yerel çalışma alanınızdan çalışır

Şunlar için yararlıdır:

• Derleme yapıtları için indirme URL'lerini bulma (ikili dosyalar, raporlar, günlükler)
• Bir pipeline çalıştırması tarafından hangi yapıtların üretildiğini kontrol etme

Bir ortamdaki belirli bir CircleCI bileşeni için tüm sürümleri listeler. Dağıtım durumunu, commit bilgilerini ve zaman damgalarını içerir.

Araç, sağlanmazsa bileşeni ve ortamı seçmenizi ister.

Şunlar için yararlıdır:

• Hangi sürümün şu anda canlı olduğunu belirleme
• Geri alma işlemleri için hedef sürümleri seçme
• Dağıtım ayrıntılarını alma (pipeline, iş akışı, iş)

Kullanıcının CircleCI'da takip ettiği tüm projeleri listeler.

• Erişiminiz olan tüm projeleri projectSlug ile gösterir
• Örnek: "CircleCI projelerimi listele"

Örnek çıktı:

Projects followed:
1. my-project (projectSlug: gh/organization/my-project)
2. another-project (projectSlug: gh/organization/another-project)

[!NOTE]
projectSlug (proje adı değil) diğer birçok CircleCI aracı için gereklidir.

Bir iş akışını başlangıcından veya başarısız işten yeniden çalıştırır.

Yeni oluşturulan iş akışının kimliğini ve onu izlemek için bir bağlantı döndürür.

Bir pipeline'ın çalışmasını tetikler. Bu araç üç şekilde kullanılabilir:

1. Proje Slug'ı ve Dal Kullanma (Önerilen):

   • Örnek: "main dalındaki my-project için pipeline'ı çalıştır"

2. CircleCI URL'si Kullanma:

   • Pipeline URL'si, İş Akışı URL'si, İş URL'si veya dal içeren Proje URL'si
   • Örnek: "https://app.circleci.com/pipelines/github/org/repo/123 için pipeline'ı çalıştır"

3. Yerel Proje Bağlamını Kullanma:

   • Çalışma alanı kökü, git remote URL'si ve dal adı sağlayarak yerel çalışma alanınızdan çalışır

Araç, pipeline yürütmesini izlemek için bir bağlantı döndürür.

Bir CircleCI projesi için geri alma tetikler. Araç sizi etkileşimli olarak şu adımlarda yönlendirir:

1. Proje Seçimi — seçim yapmanız için takip edilen projeleri listeler
2. Ortam Seçimi — mevcut ortamları listeler (yalnızca bir tane varsa otomatik seçer)
3. Bileşen Seçimi — mevcut bileşenleri listeler (yalnızca bir tane varsa otomatik seçer)
4. Sürüm Seçimi — mevcut sürümleri görüntüler; geri alma için hedefi siz seçersiniz
5. Geri Alma Modu Algılama — bir geri alma pipeline'ının yapılandırılıp yapılandırılmadığını kontrol eder
6. Geri Almayı Yürüt — iki seçenek:
   • Pipeline Geri Alma: geri alma pipeline'ını tetikler
   • İş Akışını Yeniden Çalıştır: önceki bir iş akışını iş akışı kimliğini kullanarak yeniden çalıştırır
7. Onay — yürütmeden önce özetler ve onaylar

En yaygın sorunlar:

1. Paket önbelleklerini temizleyin:

   npx clear-npx-cache
   npm cache clean --force
   

2. En son sürümü zorlayın: Yapılandırmanıza @latest ekleyin:

   "args": ["-y", "@circleci/mcp-server-circleci@latest"]
   

3. IDE'nizi tamamen yeniden başlatın (yalnızca pencereyi yeniden yüklemeyin)

• Geçersiz token hataları: Kişisel API Token'ları içindeki CIRCLECI_TOKEN doğrulayın
• İzin hataları: Token'ın projelerinize okuma erişimi olduğundan emin olun
• Ortam değişkenleri yüklenmiyor: echo $CIRCLECI_TOKEN (Mac/Linux) veya echo %CIRCLECI_TOKEN% (Windows) ile test edin

• Temel URL: CIRCLECI_BASE_URL değerinin https://circleci.com olduğunu doğrulayın
• Kurumsal ağlar: Güvenlik duvarı arkasındaysanız npm proxy ayarlarını yapılandırın
• Güvenlik duvarı engellemesi: Güvenlik yazılımının paket indirmelerini engelleyip engellemediğini kontrol edin

• Node.js sürümü: node --version ile >= 18.0.0 olduğundan emin olun
• Node.js'i güncelleyin: Uyumluluk sorunları yaşıyorsanız en son LTS sürümünü düşünün
• Paket yöneticisi: npm/pnpm'in çalıştığını doğrulayın: npm --version

• Yapılandırma dosyası konumu: İşletim sisteminiz için yolu tekrar kontrol edin
• Sözdizimi hataları: Yapılandırma dosyanızdaki JSON sözdizimini doğrulayın
• Konsol günlükleri: Belirli hatalar için IDE geliştirici konsolunu kontrol edin
• Farklı bir IDE deneyin: Sorunu yalıtmak için desteklenen başka bir düzenleyicide test edin

Takılan süreçler — mevcut MCP süreçlerini sonlandırın:

# Mac/Linux:
pkill -f "mcp-server-circleci" # Windows:
taskkill /f /im node.exe

Bağlantı noktası çakışmaları: Bağlantı engellenmiş görünüyorsa IDE'nizi yeniden başlatın.

• Paketi doğrudan test edin: npx @circleci/mcp-server-circleci@latest --help
• Ayrıntılı günlük kaydı: DEBUG=* npx @circleci/mcp-server-circleci@latest
• Docker yedeği: npx sürekli başarısız olursa Docker kurulumunu deneyin

Hâlâ yardıma mı ihtiyacınız var?

1. Benzer sorunlar için GitHub Sorunları kontrol edin
2. Sorun bildirirken işletim sisteminizi, Node sürümünüzü ve IDE'nizi ekleyin
3. IDE konsolundan ilgili hata mesajlarını paylaşın