Fulcra Context

resmi

Fulcra Context MCP sunucusu, kişisel sağlık, egzersiz, uyku, konum ve daha fazlasına tamamen özel olarak erişmenizi sağlar. Context by Fulcra etrafında inşa edilmiştir.

Fulcra Context MCP ile neler yapabilirsiniz?

  • Fulcra Context'e bağlanın — Genel sunucu örneğine erişmek için OAuth2 destekli bir MCP istemcisini https://mcp.fulcradynamics.com/mcp adresine yönlendirin.
  • stdio üzerinden yerel olarak çalıştırın — Yerel bir MCP bağlantısı için sunucuyu uvx ile başlatın ve FULCRA_ENVIRONMENT değerini stdio olarak ayarlayın.
  • Tanıdığım Temsilcileri Açın — Temsilci kişilerinizi açmasını isteyin; isteğe bağlı olarak belirli bir eş kullanıcı kimliğini veya çok taraflı bir ileti dizisi kimliğini hedefleyin.
  • Davetleri yönetin — Bir davet oluşturun, /mcp üzerinde bir daveti kabul edin veya kullanıcıların hazırladığı davetleri ilk mesaj kodlarıyla eşleştirin.
  • Veri türlerini güncelleyin — Sahip olduğunuz etkin bir v1 Event veya Metric türünün adını ya da açıklamasını değiştirmesini isteyin; değişiklikten sonra güncellenen bilgileri tekrar okuyun.

Barındırılan MCP Sunucusu

npx add-mcp 'https://mcp.fulcradynamics.com/mcp'

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

fulcra-context-mcp: Fulcra Context verilerinize erişmek için bir MCP sunucusu

Bu MCP sunucusu, fulcra-api kullanarak Fulcra API'sini çağırmak için araçlar ve kaynaklar sağlar.

Bu sunucunun herkese açık bir örneği https://mcp.fulcradynamics.com/mcp adresinde çalışıyor. OpenAI eklentisi, aynı araçları sunan ancak get_location, get_sleep, get_workouts ve get_time_series hariç https://mcp.fulcradynamics.com/openai/mcp adresine bağlanır. Claude'un bağlayıcısı ve eklentisi https://mcp.fulcradynamics.com/claude/mcp adresine bağlanır: bu dört araç hariç /mcp araçları; iletişim panelleri ise her zaman sunulur. Hızlıca başlamak için https://docs.fulcradynamics.com/ sayfasına bakın. Bu depo öncelikle sunucuyu yerel olarak çalıştırması gereken, perde arkasında neler olduğunu görmek isteyen veya katkıda bulunmak isteyen kullanıcılar içindir.

Tek başına çalıştırıldığında (veya FULCRA_ENVIRONMENT değeri stdio olarak ayarlandığında), stdio aktarımını kullanan yerel bir MCP sunucusu olarak çalışır. Aksi takdirde Streamable HTTP aktarımını kullanan uzak bir sunucu olarak çalışır. OAuth2 geri çağrısını işler ancak değiş tokuş edilen belirteçleri MCP istemcilerine sızdırmaz. Bunun yerine bir eşleme tablosu tutar ve MCP istemcileri arasında kendi OAuth2 hizmetini çalıştırır.

Sunucuyu /.well-known/openai-apps-challenge adresinde sunmak için OPENAI_APPS_CHALLENGE değerini OpenAI eklenti portalının alan adı doğrulama belirtecine ayarlayın; ayarlanmadığında bu yol 404 döndürür.

Proxy Kullanarak Uzak Bağlantı

Bu sunucunun herkese açık bir örneği https://mcp.fulcradynamics.com/ adresinde çalışıyor. OAuth2 destekli MCP istemcilerinizi bu adrese yönlendirin.

Yerel Bağlantı

uvx kullanan örnek Claude Desktop yapılandırması:

{
    "mcpServers": {
        "fulcra_context": {
            "command": "uvx",
            "args": [
                "fulcra-context-mcp@latest"
            ]
        }
    }
}

Modele yönelik araçlar

MCP keşfi, güncel araç şemalarını ve açıklamalarını sağlar. İletişim ve meta veri araçları şunları içerir:

  • open_agent_contacts: İsteğe bağlı olarak tam bir eş kullanıcı kimliğini veya keşfedilmiş çok taraflı bir ileti dizisi kimliğini hedefleyerek Tanıdığım Ajanlar'ı açar. Açma işlemi salt okunurdur; görüntüleme için MCP Apps desteği olan bir ana makine gerekir.
  • update_data_type: Kullanıcı yetkilendirmesi ve bağımsız geri okuma ile sahip olunan etkin bir v1 Event/Metric türünün adını veya açıklamasını günceller. Şemaları, kayıtları veya paylaşımları değiştirmez; sonucu belirsiz yazma işlemleri uzlaştırma gerektirir.
  • accept_agent_invitation üzerinde /mcp: Kullanıcının yetkilendirmesiyle boş bir yanıt kanalını oluşturur veya yeniden kullanır, kanalı yalnızca tam davetçiyle paylaşır ve sağlanan ilk tanıtım mesajını gönderir. Sonucu belirsiz işlemleri salt okunur olarak inceleyin; kaydedilmiş denemeler hiçbir zaman otomatik olarak yeniden gönderim veya paylaşım yapmaz.
  • match_agent_invitations üzerinde /mcp: Kullanıcının hazırladığı davetleri, mesaj iddialarına değil ilk mesaj kodlarına ve gelen paylaşımların gerçek sahiplerine göre tamamlar.
  • create_agent_invitation: Sahip olunan, tek kişilik bir kanal ve kalıcı, güvenli bir davet kodu oluşturur; isteğe bağlı olarak yalnızca bu giden kutusunu sağlanan tam alıcı kimliğiyle paylaşır. Mesaj gönderilmez. /mcp üzerinde sonuç ayrıca tam invitation_text ve açık bir sonraki teslimat adımını içerir; beceriler isteğe bağlıdır. Başka bir çağrı yapmadan önce hataları uzlaştırın; genel oluşturma yöntemine geri dönmeyin. Davet iş akışı ve ana makine yetenek sınırı sayfasına bakın. /openai/mcp mevcut eklenti sözleşmesini ve davet arayüzünü korur.

Yalnızca uygulamaya yönelik uygulama araçları, herkese açık modele yönelik başvuruya dahil değildir.

Hata Ayıklama / Geliştirici Araçları

  • Tanıdığım Ajanlar MCP App: Bu çalışma kopyasını özel bir geliştirme tüneli üzerinden çalıştırın ve ChatGPT kenar çubuğu arayüzünü test edin. HTML, ayrı bir eklenti sunucusundan değil, bu sunucudan sunulur.

  • Hem MCP Inspector hem de mcp-remote araçları hata ayıklamada yararlı olabilir.

Araçları Görüntüleme

Her MCP istemcisi farklıdır ancak çoğu, özetler için araç ve parametre açıklamalarını kısaltır. İstemci modellerinin kafasını karıştırmamak için ilk açıklamaları kısa tutun (tam açıklama tek satırda, yaklaşık 80 karakter).

Yerel olarak geliştirirken scripts/simulate_tools.py betiği, bunun bir MCP istemcisinde nasıl görünebileceğini taklit eder:

FULCRA_ENVIRONMENT=stdio uv run python scripts/simulate_tools.py --command "uv run fulcra-context-mcp"

Hatalar / Özellik İstekleri

Doğrudan iletişime geçmek için bu projenin GitHub deposu üzerinden bize ulaşabilir veya Discord sunucumuza katılabilirsiniz. E-posta da olur (support@fulcradynamics.com).