MetricFire MCP Server

Kapsamlı dokümantasyon dizini için bkz. llms.txt. Dokümantasyon sayfalarının Markdown sürümleri, sayfa URL'lerine .md eklenerek elde edilebilir; bu sayfa Markdown olarak mevcuttur.

MF MCP Server

AI asistanlarını, doğal dil komutları kullanarak Hosted Graphite API'si ile etkileşime girecek şekilde bağlayın.

İçindekiler

• MCP Token'ı Oluşturun
• MCP İstemcisi Bağlayın
  • GitHub Copilot (VS Code)
  • Cursor, Claude Code, Cline, Windsurf
  • Claude
• Mevcut Araçlar
  • Metrikler
  • Graphite Render
  • Uyarılar
  • Panolar
  • Bildirim Kanalları
  • Zamanlanmış Sessize Alma
• Nasıl Çalışır

{% embed url="https://www.youtube.com/watch?t=15s&v=7dIbd2rxARs" %}

MetricFire MCP Server, desteklenen AI istemcilerinin, Model Context Protocol (MCP) kullanarak Hosted Graphite hesabınızla doğrudan etkileşime girmesini sağlar.

Bağlandıktan sonra GitHub Copilot, Cursor, Claude/Claude Code gibi istemciler; metrik keşfi, Graphite render, uyarı yönetimi, bildirim kanalları, zamanlanmış sessize alma ve diğer izleme iş akışları için Hosted Graphite API'lerini kullanabilir.

MCP sunucusu, Hosted Graphite hesabınızdaki veriler ve kaynaklar üzerinde çalışır. Metriklerin aranabilmesi, render edilebilmesi veya uyarı oluşturmak için kullanılabilmesi için öncelikle Hosted Graphite'a iletilmiş ve depolanmış olması gerekir.

MCP Token'ı Oluşturun

Hosted Graphite hesabınızda Eklentiler ⇒ MetricFire MCP Server bölümüne gidin.

Bir token oluşturun ve MCP istemcinizin gerektirdiği izinleri seçin:

• Okuma – metrikler, render'lar, uyarılar, bildirim kanalları, zamanlanmış sessize alma ve diğer desteklenen kaynaklara erişim.
• Yazma – desteklenen kaynakları oluşturma veya değiştirme.
• Silme – desteklenen kaynakları silme.

İş akışınız için gereken minimum izinleri kullanmanızı öneririz.

Tam MCP token'ı yalnızca oluşturulduğunda bir kez görüntülenir. Sayfadan ayrılmadan önce güvenli bir şekilde saklayın.

MCP İstemcisi Bağlayın

Hosted Graphite MCP uç noktası:

https://mcp.hostedgraphite.com/

Yapılandırma, MCP istemcisine göre biraz değişiklik gösterir.

GitHub Copilot (VS Code)

VS Code Komut Paleti'ni açın ve şunu seçin: MCP: Kullanıcı Yapılandırmasını Aç

MetricFire MCP Server nesnesini ekleyin:

{
  "servers": {
    "mf-mcp-server": {
      "url": "https://mcp.hostedgraphite.com/",
      "headers": {
        "X-HostedGraphite-MCP-Token": "YOUR-MCP-TOKEN"
      }
    }
  }
}

Yapılandırmayı kaydedin, MCP sunucusunu VS Code içinden başlatın ve Copilot Chat'i kullanarak ajanla etkileşime geçin.

Cursor, Claude Code, Cline, Windsurf

Bu istemciler özel HTTP başlıklarını destekler. Uç noktayı yapılandırın:

https://mcp.hostedgraphite.com/

ve token'ınızı iletin:

X-HostedGraphite-MCP-Token: <MF-MCP-TOKEN>

Sunucu yapılandırmasının konumu ve biçimi için istemcinizin MCP dokümantasyonuna bakın.

Claude

Claude'un tarayıcı/arayüz yapılandırması, sunucu URL'sindeki MCP token'ını kullanarak bağlanabilir:

https://<MF-MCP-TOKEN>@mcp.hostedgraphite.com

NOT: URL tabanlı kimlik doğrulama kullanırken, yazma veya silme erişimi özel olarak gerekmedikçe salt okunur bir token kullanmanızı şiddetle öneririz.

Mevcut Araçlar

Bağlandıktan sonra MCP istemciniz, Hosted Graphite tarafından sunulan araçları keşfedebilir.

Metrikler

Aşağıdakiler için araçlar mevcuttur:

• Standart metrik araması (desenle*)
• Etiketli metrik araması
• Yoğun metrikler
• Geçersiz metrikler
• Metrik silme

Graphite Render

Graphite Render API'si MCP üzerinden sorgulanabilir ve şu formatlar desteklenir:

• JSON
• CSV
• Ham veri
• PNG
• SVG

Bu, MCP istemcilerinin metrikleri bulmasına ve belirli bir zaman aralığında verilerini almasına veya görselleştirmesine olanak tanır.

Uyarılar

AI asistanları, Hosted Graphite metriklerinizle çalışarak VE/VEYA mantığı kullanan anlamlı bileşik uyarılar oluşturabilir; bu sayede tek tek metrik eşikleri yerine hizmet düzeyi sorunları hakkında uyarı vermek kolaylaşır.

Örneğin: "Üretim sunucularım için ilgili CPU, bellek, disk ve ağ metriklerini bulun ve birden fazla sinyal hizmet düzeyi sorununa işaret ettiğinde bana e-posta gönderen bir bileşik uyarı oluşturun."

Uyarı araçları şunları destekler:

• Uyarı oluşturma ve güncelleme
• Uyarı arama ve alma
• Uyarı silme
• Uyarıları sessize alma ve sessizden çıkarma
• Uyarı durumu ve geçmişi
• VE/VEYA mantığı kullanan bileşik uyarı kriterleri

Panolar

AI istemcileri, Hosted Graphite hesabınızda depolanan metrikleri referans alabilir ve bunları doğal dil komutları kullanarak Grafana panoları oluşturmak, güncellemek ve yönetmek için kullanabilir. Metrikleri manuel olarak aramak, paneller oluşturmak ve görselleştirmeleri tek tek yapılandırmak yerine, izlemek istediğiniz bir hizmet, sunucu, uygulama veya altyapı bileşeni etrafında bir pano oluşturması için AI asistanınıza sorabilirsiniz.

Örneğin: "Üretim sunucularım için ilgili CPU, bellek, disk ve ağ metriklerini bulun ve kapsamlı bir altyapı genel bakış panosu oluşturun."

Pano araçları şunları destekler:

• Grafana panoları oluşturma
• Mevcut panoları güncelleme
• Pano arama ve alma
• Pano silme
• Pano panelleri oluşturma ve yapılandırma
• Doğal dil komutlarından pano oluşturmak için Hosted Graphite metriklerini kullanma

{% embed url="https://www.youtube.com/watch?v=jzkK_87fi0Q" %}

Bildirim Kanalları

MCP istemcileri, Hosted Graphite bildirim kanallarıyla (E-posta, Slack, PagerDuty, MS Teams, webhook'lar vb.) çalışabilir; kanalları alma ve bunları uyarılarla ilişkilendirme dahil. Token izinlerine bağlı olarak desteklenen kanallar oluşturulabilir, güncellenebilir veya silinebilir.

Zamanlanmış Sessize Alma

Zamanlanmış sessize alma araçları, MCP istemcilerinin tekrarlayan sessizlik pencereleri (ör. hafta sonları) oluşturmasına ve yönetmesine olanak tanır. Zamanlanmış sessize alma işlemleri, Uyarı API'si aracılığıyla uyarılarla ilişkilendirilebilen ayrı kaynaklardır.

Nasıl Çalışır

MetricFire MCP Server, desteklenen Hosted Graphite API'lerine bir MCP arayüzü sağlar. Bağlı AI istemcisi, isteğe göre uygun MCP aracını seçer ve MCP token'ınızla ilişkili izinleri kullanarak bunu çalıştırır.

MCP entegrasyonu, mevcut metrik toplama işleminizin yerini almaz. Verileri mevcut ajanlarınız, entegrasyonlarınız veya desteklenen protokolleriniz aracılığıyla Hosted Graphite'a göndermeye devam edin.

Temel API'ler hakkında daha fazla ayrıntı için Hosted Graphite API dokümantasyonuna bakın ve bir MCP istemcisi bağlama konusunda yardıma ihtiyacınız olursa bize şu adresten ulaşın: support@metricfire.com

MCP şu anda Heroku Marketplace'ten Hosted Graphite Eklentisi'ni etkinleştirmiş kullanıcılar için kullanılamamaktadır. Heroku HG hesabınızı/hesaplarınızı özel bir HG hesabına nasıl taşıyacağınızı ve MCP ile Logging gibi tüm mevcut özelliklerden nasıl yararlanacağınızı öğrenmek için bizimle iletişime geçin.

---

Ajan Talimatları

Bu dokümantasyon GitBook ile yayınlanmaktadır. GitBook, hem insanların hem de AI ajanlarının teknik içerik üzerinde etkili bir şekilde okuması, gezinmesi ve akıl yürütmesi için tasarlanmış dokümantasyon platformudur. Daha fazla bilgi için gitbook.com adresini ziyaret edin.

Bu Dokümantasyonu Sorgulama

Bu sayfada doğrudan bulunmayan ek bilgilere ihtiyacınız varsa, bir soru sorarak dokümantasyonu sorgulayabilirsiniz.

Aşağıdaki URL üzerinde ask ve goal sorgu parametreleriyle bir HTTP GET isteği gerçekleştirin:

GET https://docs.hostedgraphite.com/add-ons-and-integrations-guide/mf-mcp-server.md?ask=<question>&goal=<user_goal>

ask anlık sorudur: spesifik, kendi kendine yeten ve doğal dilde yazılmış olmalıdır. goal kullanıcının nihai olarak ulaşmaya çalıştığı şeydir, cevaba ihtiyaç duyma nedenidir. Bir hedefi paylaşmak, GitBook'un size daha iyi ve daha alakalı bir cevap vermesine yardımcı olur. Bir hedef, soruyu yeniden ifade etmek yerine kullanıcının istediği sonucu tanımladığında en faydalıdır. Örneğin, ask=how do I create an API token ile automate deployments from our CI pipeline gibi bir hedef, GitBook'un cevabı bu kullanım durumuna göre uyarlamasını sağlar.

Yanıt, soruya doğrudan bir cevap ve dokümantasyondan ilgili alıntılar ile kaynaklar içerecektir.

Cevap mevcut sayfada açıkça bulunmadığında, açıklama veya ek bağlam gerektiğinde veya ilgili dokümantasyon bölümlerini almak istediğinizde bu mekanizmayı kullanın.