Sentry MCP

npx add-mcp 'https://mcp.sentry.dev/mcp'

Sentry Araç Seti

Bu depo, Sentry CLI, Sentry MCP sunucusu ve paylaşılan paketleri içerir. CLI için CLI rehberine ve https://cli.sentry.dev/ adresindeki yayınlanmış dokümantasyona bakın. Dokümantasyon dizini hem ürünleri hem de paylaşılan katkıda bulunan rehberini kapsar.

Sentry MCP

Sentry'nin MCP hizmeti öncelikli olarak insan-odaklı kodlama ajanları 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 senaryoları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 yönelik bir ara katman olarak çalışır. Cloudflare'ın uzak MCP'ler üzerindeki çalışmasına dayanmaktadır.

Başlarken

İhtiyacınız olan her şeyi, üretimde dağıtılan hizmeti ziyaret ederek bulabilirsiniz:

https://mcp.sentry.dev

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

Claude Code Eklentisi

Otomatik alt ajan delegasyonu için Claude Code eklentisi olarak kurun:

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

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

Geleceğe yönelik araç varyantları ve özellikler için:

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

Stdio ve Uzak Arası

Bu depo bir MCP hizmeti olarak çalışmaya odaklanmış olsa da, bir stdio taşımasını da destekliyoruz. Bu hâlâ geliştirme aşamasındadır, ancak MCP'yi kendi kendine barındırılan bir Sentry kurulumuna karşı çalıştırmanın en kolay yoludur.

Not: Yapay zeka destekli arama araçları (search_errors, search_traces, search_logs, 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 taşımasını kullanmak için Sentry'de gerekli kapsamlarla bir Kullanıcı Kimlik Doğrulama Belirteci oluşturmanız gerekir. Yazıldığı sırada bu:

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

Taşımayı başlatın:

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

Kendi kendine barındırılan 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 izole iç dağıtımlar için ayrıca --insecure-http ekleyin.

Seer, kendi kendine barındırılan Sentry'nin bir parçası değildir, bu nedenle --host sentry.io olmayan bir ana bilgisayarı işaret ettiğinde seer becerisi varsayılan beceri setinden çıkarılır. Kendi kendine barındırılan dağıtımınız Seer'ı çalıştırıyorsa, açıkça geri ekleyin:

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

Desteklenmeyen araçların açığa çıkmasını önlemek için başka herhangi bir beceriyi de devre dışı bırakabilirsiniz:

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

TLS'siz kendi kendine barındırılan ö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, yukarı akış Sentry API belirtecini doğrudan Cloudflare taşımasına iletebilir:

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

Sentry-Bearer kasıtlı olarak Bearer'dan 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 oturumlarda kullanılan aynı Sentry API çağrıları aracılığıyla iletir ve belirteç ömrü ile yenileme sorumluluğu istemci veya yukarı akış sağlayıcısında kalır.

Doğrudan uzak kimlik doğrulama, varsayılan olarak tüm aktif MCP becerilerini kapsar. Açığa çıkan 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.6-luna'
OPENROUTER_REASONING_EFFORT= # Optional OpenRouter reasoning effort, defaults to 'high'

# Optional overrides
SENTRY_HOST=                 # For self-hosted deployments (drops 'seer' from the default skills)
MCP_SKILLS=                  # Grant specific skills (comma-separated, e.g. 'inspect,seer')
MCP_DISABLE_SKILLS=          # Disable specific skills (comma-separated, e.g. 'project-management')

Önemli: LLM sağlayıcınızı açıkça belirtmek için her zaman EMBEDDED_AGENT_PROVIDER değerini 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 adresine 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 ayarlamazsanız, CLI otomatik olarak Sentry SaaS hizmetini hedefler. Yalnızca kendi kendine barındırılan Sentry çalıştırdığınızda geçersiz kılmayı ayarlayın.

SENTRY_HOST değerini kendi kendine barındırılan bir ana bilgisayara ayarlamak, Seer kendi kendine barındırılan Sentry'de bulunmadığından seer becerisini varsayılan setten de düşürür. Seer'ı çalıştıran kendi kendine barındırılan bir dağıtım için MCP_SKILLS ile ekleyin:

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

MCP Denetçisi

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

pnpm inspector

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

Not: 127.0.0.1 üzerindeki denetçiye 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 ajan becerilerini ayarlayın:

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

   Bu ayrıca getsentry/skills adresinden paylaşılan becerileri .agents/skills/ içine kurmak için npx @sentry/dotagents install çalıştırır (.claude/skills ve .cursor/skills içine sembolik olarak bağlanır). Daha sonra becerileri 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 yerel olarak çalıştırın ve http://localhost:5173 adresinde kullanılabilir hale getirin

pnpm dev

Yerel sunucuyu test etmek için Denetçi'ye http://localhost:5173/mcp girin ve bağlan'a bası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 şekilde çalıştırılabilir:

pnpm test

Değerlendirmeler, proje kökünde bazı yapılandırmalarla 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 tamamlandığında, bunları şu şekilde ç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 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 değerini kullanır. --mcp-host ile geçersiz kılın veya MCP_URL ortam değişkenini ayarlayın.

Kapsamlı test çalışma kitapları:

• Stdio testi: Stdio uygulamasını (IDE'ler, MCP Denetçisi) oluşturma, çalıştırma ve test etme konusunda eksiksiz rehber için docs/testing/stdio.md adresine bakın
• Uzak test: Uzak sunucuyu (OAuth, web arayüzü, CLI istemcisi) test etme konusunda eksiksiz rehber için docs/testing/remote.md adresine bakın

Geliştirme Notları

Otomatik Kod İncelemesi

Bu depo, çekme isteklerindeki potansiyel 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 bu kontrollerin zorunlu yapılmasını önermiyoruz çünkü doğruluk hâlâ gelişmektedir ve yanlış pozitifler üretebilir.

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

• ✅ Yararlı öneriler kod incelemesi sırasında dikkate alınmalı
• ✅ Tartışma ve iyileştirme için başlangıç noktaları
• ❌ Birleştirme için engelleyici gereksinimler değil
• ❌ İnsan kod incelemesinin yerine geçmez

Otomatik geri bildirimi ele alırken, her öneriyi harfiyen takip etmek yerine altta yatan endişelere odaklanın.

Katkıda Bulunan Dokümantasyonu

Katkıda bulunmak mı istiyorsunuz? CLI, MCP ve paylaşılan rehberler için Araç Seti dokümantasyon dizininden başlayın. Depo kuralları için AGENTS.md ve CLI'ya özel kurallar için packages/cli/AGENTS.md adresine bakın.