Sentry MCP

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ğlamak yerine 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ı için optimize edilmiş, üst Sentry API'sine yönelik bir ara katman görevi görür. Cloudflare'ın uzak MCP'lere yönelik çalışmasına dayanır.

Başlarken

Üretimdeki dağıtılmış 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 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ı, izlemeleri veya performansı hakkında soru sorduğunuzda Claude'un otomatik olarak devrettiği bir sentry-mcp alt ajanı sağlar.

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

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

Stdio ve Uzak Karşılaştırması

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_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 taşıması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 şu şekildedir:

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.

Bazı özellikler (Seer gibi) kendi kendine barındırılan örneklerde kullanılamayabilir. Desteklenmeyen araçların açığa çıkması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 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, üst 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, üst belirteci 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 üst sağlayıcıda kalır.

Doğrudan uzak kimlik doğrulama, tüm etkin MCP becerilerini varsayılan olarak kullanır. 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
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 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 bölümüne 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 boş bırakırsanı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.

Seer'ı desteklemeyen kendi kendine barındırılan ö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 bası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 ajan becerilerini ayarlayın:

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

   Bu ayrıca getsentry/skills içindeki paylaşılan becerileri .agents/skills/ dizinine kurmak için npx @sentry/dotagents install komutunu ç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 gizli anahtarı 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 Inspector'a http://localhost:5173/mcp girin ve bağlan'a basın. İstemleri takip ettiğinizde "Araçları Listele" seçeneğini kullanabileceksiniz.

Testler

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

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ıktan sonra 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 playbook'ları:

• Stdio testi: Stdio uygulamasını (IDE'ler, MCP Inspector) oluşturma, çalıştırma ve test etme konusunda eksiksiz kılavuz için docs/testing/stdio.md bölümüne bakın
• Uzak test: Uzak sunucuyu (OAuth, web arayüzü, CLI istemcisi) test etme konusunda eksiksiz kılavuz için docs/testing/remote.md bölümüne 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 bu kontrollerin zorunlu yapılmasını önermiyoruz çünkü doğruluk hâlâ gelişmektedir ve yanlış pozitifler üretebilir.

Otomatik incelemeler şu şekilde değerlendirilmelidir:

• ✅ Yararlı öneriler kod incelemesi sırasında dikkate alınmalıdır
• ✅ Tartışma ve iyileştirme için başlangıç noktaları
• ❌ PR'ları birleştirmek için engelleyici gereksinimler değildir
• ❌ İ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 veya tam dokümantasyon haritasını keşfetmek mi istiyorsunuz? Katkıda bulunan iş akışları ve eksiksiz doküman dizini için CLAUDE.md (ayrıca AGENTS.md olarak da mevcuttur) bölümüne bakın. docs/ klasörü, konu bazlı kılavuzları ve araç entegreli .md dosyalarını içerir.