Sentry MCP

sentry-mcp

Sentry'nin MCP hizmeti, öncelikle döngüde insan bulunan kodlama aracıları için tasarlanmıştır. Araç seçimimiz ve önceliklerimiz, tüm Sentry işlevselliği için genel amaçlı bir MCP sunucusu sağlamaktan ziyade, geliştirici iş akışlarına ve hata ayıklama kullanım durumlarına odaklanmıştır.

Bu uzak MCP sunucusu, Cursor, Claude Code ve benzeri geliştirme araçları gibi kodlama asistanları için optimize edilmiş, yukarı akış Sentry API'sine bir ara yazılım görevi görür. Cloudflare'ın uzak MCP'lere yönelik çalışmasına dayanmaktadır.

Başlarken

Üretimde dağıtılan hizmeti ziyaret ederek bilmeniz gereken her şeyi bulacaksınız:

https://mcp.sentry.dev

Katkıda bulunmak, nasıl çalıştığını öğrenmek veya bunu kendi barındırdığınız Sentry için çalıştırmak istiyorsanız, aşağıdan devam edin.

Claude Code Eklentisi

Otomatik alt aracı delegasyonu için bir Claude Code eklentisi olarak yükleyin:

claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp

Bu, Sentry hataları, sorunları, izleri veya performansı hakkında soru sorduğunuzda Claude'un otomatik olarak devrettiği bir sentry-mcp alt aracısı sağlar.

İleriye dönük araç varyantları ve özellikler için:

claude plugin install sentry-mcp@sentry-mcp-experimental

Stdio ve Uzak

Bu depo bir MCP hizmeti olarak hareket etmeye odaklanmış olsa da, bir stdio aktarımını da destekliyoruz. Bu hala üzerinde çalışılan bir konudur, ancak MCP'yi kendi barındırdığınız bir Sentry kurulumuna karşı çalıştırmanın en kolay yoludur.

Not: Yapay zeka destekli arama araçları (search_events, search_issues, vb.) bir LLM sağlayıcısı (OpenAI, Azure OpenAI, Anthropic veya OpenRouter) gerektirir. Bu araçlar, sorguları Sentry'nin sorgu sözdizimine çevirmek için doğal dil işleme kullanır. Yapılandırılmış bir sağlayıcı olmadan, bu belirli araçlar kullanılamaz, ancak diğer tüm araçlar normal şekilde çalışır.

stdio aktarımını kullanmak için, Sentry'de gerekli kapsamlara sahip bir Kullanıcı Kimlik Doğrulama Belirteci oluşturmanız gerekir. Bu yazının yazıldığı sırada bu:

org:read
project:read
project:write
team:read
team:write
event:write

Aktarımı başlatın:

npx @sentry/mcp-server@latest --access-token=sentry-user-token

Kendi barındırdığınız bir dağıtıma bağlanmanız mı gerekiyor? Komutu çalıştırırken --host (yalnızca ana bilgisayar adı, örn. --host=sentry.example.com) ekleyin. Yalnızca düz HTTP sunan yalıtılmış dahili dağıtımlar için ayrıca --insecure-http ekleyin.

Bazı özellikler (Seer gibi) kendi barındırdığınız örneklerde kullanılamayabilir. Desteklenmeyen araçların sunulmasını önlemek için belirli becerileri devre dışı bırakabilirsiniz:

npx @sentry/mcp-server@latest --access-token=TOKEN --host=sentry.example.com --disable-skills=seer

TLS'siz kendi barındırdığınız örnekler için:

npx @sentry/mcp-server@latest --access-token=TOKEN --host=sentry.internal:9000 --insecure-http

Açık Sentry Belirteci ile Uzak

Özel HTTP başlıklarını destekleyen uzak istemciler, doğrudan Cloudflare aktarımına bir yukarı akış Sentry API belirteci iletebilir:

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
      }
    }
  }
}

Sentry-Bearer, Bearer'dan kasıtlı olarak ayrıdır: Bearer, MCP OAuth erişim belirteçleri için ayrılmıştır. Sentry-Bearer ile, çalışan yukarı akış belirtecini saklamaz, doğrulamaz, değiştirmez veya yenilemez. Belirteci, OAuth destekli oturumlar tarafından kullanılan aynı Sentry API çağrıları aracılığıyla iletir ve istemci veya yukarı akış sağlayıcısı, belirteç ömrü ve yenilemeden sorumlu kalır.

Doğrudan uzak kimlik doğrulama, varsayılan olarak tüm etkin MCP becerilerini kullanır. Sunulan araçları ?skills=inspect,triage veya ?disable-skills=seer ile daraltabilirsiniz.

Ortam Değişkenleri

SENTRY_ACCESS_TOKEN=         # Required: Your Sentry auth token

# LLM Provider Configuration (required for AI-powered search tools)
EMBEDDED_AGENT_PROVIDER=     # Required when multiple provider keys are set: 'openai', 'azure-openai', 'anthropic', or 'openrouter'
OPENAI_API_KEY=              # Required if using OpenAI
ANTHROPIC_API_KEY=           # Required if using Anthropic
OPENROUTER_API_KEY=          # Required if using OpenRouter
OPENROUTER_MODEL=            # Optional OpenRouter model, defaults to 'openai/gpt-5'

# Optional overrides
SENTRY_HOST=                 # For self-hosted deployments
MCP_DISABLE_SKILLS=          # Disable specific skills (comma-separated, e.g. 'seer')

Önemli: LLM sağlayıcınızı açıkça belirtmek için her zaman EMBEDDED_AGENT_PROVIDER ayarlayın. Yalnızca API anahtarlarına dayalı otomatik algılama kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır. Ayrıntılı yapılandırma seçenekleri için docs/operations/embedded-agents.md belgesine bakın.

Örnek MCP Yapılandırması

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["@sentry/mcp-server"],
      "env": {
        "SENTRY_ACCESS_TOKEN": "your-token",
        "EMBEDDED_AGENT_PROVIDER": "openai",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Ana bilgisayar değişkenini ayarlanmamış bırakırsanız, CLI otomatik olarak Sentry SaaS hizmetini hedefler. Yalnızca kendi barındırdığınız Sentry'yi çalıştırdığınızda geçersiz kılmayı ayarlayın.

Seer'ı desteklemeyen kendi barındırdığınız örnekler için:

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["@sentry/mcp-server"],
      "env": {
        "SENTRY_ACCESS_TOKEN": "your-token",
        "SENTRY_HOST": "sentry.example.com",
        "MCP_DISABLE_SKILLS": "seer"
      }
    }
  }
}

MCP Inspector

MCP, hizmeti kolayca test etmek için bir Inspector içerir:

pnpm inspector

MCP sunucu URL'sini (http://localhost:5173) girin ve bağlan'a tıklayın. Bu, sizin için kimlik doğrulama akışını tetiklemelidir.

Not: 127.0.0.1 üzerinde inspector'a erişirken OAuth akışınızla ilgili sorun yaşıyorsanız, http://localhost:6274 adresini ziyaret ederek bunun yerine localhost kullanmayı deneyin.

Yerel Geliştirme

Değişikliklere katkıda bulunmak için yerel ortamınızı kurmanız gerekir:

1. Ortamı ve aracı becerilerini ayarlayın:

   make setup-env  # Creates .env files and installs shared agent skills
   

   Bu ayrıca, getsentry/skills deposundan paylaşılan becerileri .agents/skills/ dizinine (.claude/skills ve .cursor/skills içine sembolik bağlantılı) yüklemek için npx @sentry/dotagents install çalıştırır. Becerileri daha sonra güncellemeniz gerekirse, doğrudan çalıştırın:

   npx @sentry/dotagents install
   

2. Sentry'de bir OAuth Uygulaması oluşturun (Ayarlar => API => Uygulamalar):

   • Ana Sayfa URL'si: http://localhost:5173
   • Yetkili Yönlendirme URI'leri: http://localhost:5173/oauth/callback
   • İstemci Kimliğinizi not edin ve bir İstemci sırrı oluşturun

3. Kimlik bilgilerinizi yapılandırın:

   • Kök dizindeki .env dosyasını düzenleyin ve OPENAI_API_KEY veya OPENROUTER_API_KEY ekleyin
   • packages/mcp-cloudflare/.env dosyasını düzenleyin ve şunları ekleyin:
     • SENTRY_CLIENT_ID=your_development_sentry_client_id
     • SENTRY_CLIENT_SECRET=your_development_sentry_client_secret
     • COOKIE_SECRET=my-super-secret-cookie

4. Geliştirme sunucusunu başlatın:

   pnpm dev
   

Doğrulama

Sunucuyu http://localhost:5173 adresinde kullanılabilir hale getirmek için yerel olarak çalıştırın

pnpm dev

Yerel sunucuyu test etmek için, Inspector'a http://localhost:5173/mcp girin ve bağlan'a tıklayın. İstemleri takip ettiğinizde, "Araçları Listele" yapabileceksiniz.

Testler

Dahil edilen üç test paketi vardır: birim testleri, değerlendirmeler ve manuel test.

Birim testleri şu komut kullanılarak çalıştırılabilir:

pnpm test

Değerlendirmeler, proje kökünde bazı yapılandırmalar içeren bir .env dosyası gerektirir:

# .env (in project root)
OPENAI_API_KEY=      # Use OpenAI-backed AI-powered tools
OPENROUTER_API_KEY=  # Or use OpenRouter-backed AI-powered tools

Not: Kök .env dosyası, tüm paketler için varsayılanları sağlar. Bireysel paketler, geliştirme sırasında bu varsayılanları geçersiz kılmak için kendi .env dosyalarına sahip olabilir.

Bu yapıldıktan sonra, bunları şu komutla çalıştırabilirsiniz:

pnpm eval

Manuel test (MCP değişikliklerini test etmek için tercih edilir):

# Test with local dev server (default: http://localhost:5173)
pnpm -w run cli "who am I?"

# Test agent mode (use_sentry tool only)
pnpm -w run cli --agent "who am I?"

# Test against production
pnpm -w run cli --mcp-host=https://mcp.sentry.dev "query"

# Test with local stdio mode (requires SENTRY_ACCESS_TOKEN)
pnpm -w run cli --access-token=TOKEN "query"

Not: CLI varsayılan olarak http://localhost:5173 kullanır. --mcp-host ile geçersiz kılın veya MCP_URL ortam değişkenini ayarlayın.

Kapsamlı test kılavuzları:

• Stdio testi: Stdio uygulamasını oluşturma, çalıştırma ve test etme (IDE'ler, MCP Inspector) hakkında eksiksiz kılavuz için docs/testing/stdio.md belgesine bakın
• Uzak test: Uzak sunucuyu test etme (OAuth, web kullanıcı arayüzü, CLI istemcisi) hakkında eksiksiz kılavuz için docs/testing/remote.md belgesine bakın

Geliştirme Notları

Otomatik Kod İncelemesi

Bu depo, çekme isteklerindeki olası sorunları belirlemeye yardımcı olmak için otomatik kod inceleme araçları (Cursor BugBot gibi) kullanır. Bu araçlar yararlı geri bildirim ve öneriler sağlar, ancak doğruluk hala gelişmekte olduğundan ve yanlış pozitifler üretebileceğinden bu kontrollerin zorunlu hale getirilmesini önermiyoruz.

Otomatik incelemeler şu şekilde ele alınmalıdır:

• ✅ Kod incelemesi sırasında dikkate alınacak Yararlı öneriler
• ✅ Tartışma ve iyileştirme için Başlangıç noktaları
• ❌ PR'leri birleştirmek için Engelleyici gereksinimler değil
• ❌ İnsan kod incelemesinin Yerine geçmez

Otomatik geri bildirimi ele alırken, her öneriyi katı bir şekilde takip etmekten ziyade temel endişelere odaklanın.

Katkıda Bulunan Belgeleri

Katkıda bulunmak veya tüm belge haritasını keşfetmek mi istiyorsunuz? Katkıda bulunan iş akışları ve eksiksiz belge dizini için CLAUDE.md (ayrıca AGENTS.md olarak da mevcuttur) belgesine bakın. docs/ klasörü, konu başına kılavuzları ve araçla entegre .md dosyalarını içerir.