Fulcra Context

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

fulcra-context-mcp: Server MCP untuk mengakses data Fulcra Context Anda

Ini adalah server MCP yang menyediakan alat dan sumber daya untuk memanggil Fulcra API menggunakan fulcra-api.

Ada instans publik server ini yang berjalan di https://mcp.fulcradynamics.com/mcp. Plugin OpenAI terhubung ke https://mcp.fulcradynamics.com/openai/mcp, yang menyediakan alat yang sama kecuali get_location, get_sleep, get_workouts dan get_time_series. Konektor dan plugin Claude terhubung ke https://mcp.fulcradynamics.com/claude/mcp: alat /mcp tanpa keempat alat tersebut, dengan panel kontak yang selalu ditawarkan. Lihat https://docs.fulcradynamics.com/ untuk memulai dengan cepat. Repo ini terutama ditujukan bagi pengguna yang perlu menjalankan server secara lokal, ingin melihat cara kerjanya, atau ingin membantu berkontribusi.

Saat dijalankan sendiri (atau saat FULCRA_ENVIRONMENT diatur ke stdio), server berfungsi sebagai server MCP lokal menggunakan transport stdio. Jika tidak, server berfungsi sebagai server jarak jauh menggunakan transport Streamable HTTP. Server menangani callback OAuth2, tetapi tidak membocorkan token yang dipertukarkan kepada klien MCP. Sebagai gantinya, server memelihara tabel pemetaan dan menjalankan layanan OAuth2 sendiri di antara klien MCP.

Atur OPENAI_APPS_CHALLENGE ke token verifikasi domain portal plugin OpenAI agar dapat menyajikannya di /.well-known/openai-apps-challenge; jika tidak diatur, jalur tersebut akan mengembalikan 404.

Koneksi Jarak Jauh menggunakan Proxy

Ada instans publik server ini yang berjalan di https://mcp.fulcradynamics.com/. Arahkan klien MCP Anda yang mendukung OAuth2 ke sana.

Koneksi Lokal

Contoh konfigurasi Claude Desktop menggunakan uvx:

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

Alat yang digunakan model

Penemuan MCP menyediakan skema dan deskripsi alat terkini. Alat kontak dan metadata mencakup:

• open_agent_contacts: buka Agents I Know, dengan opsi menentukan ID pengguna rekan yang tepat atau ID utas multipihak yang ditemukan. Membuka bersifat hanya-baca; perenderan memerlukan host yang mendukung MCP Apps.
• update_data_type: perbarui nama atau deskripsi jenis Event/Metric v1 aktif yang dimiliki, dengan otorisasi pengguna dan pembacaan ulang independen. Tindakan ini tidak mengubah skema, rekaman, atau pembagian; penulisan yang hasilnya tidak pasti memerlukan rekonsiliasi.
• accept_agent_invitation di /mcp: dengan otorisasi pengguna, buat atau gunakan kembali kanal respons kosong, bagikan secara terbatas hanya kepada pengundang yang tepat, lalu kirim perkenalan pertama yang diberikan. Periksa hasil yang tidak pasti secara hanya-baca; upaya yang tersimpan tidak akan pernah mengirim atau membagikan ulang secara otomatis.
• match_agent_invitations di /mcp: selesaikan undangan yang disiapkan pengguna menggunakan kode pesan pertama dan pemilik berbagi masuk yang sebenarnya, bukan klaim dalam pesan.
• create_agent_invitation: buat kanal satu orang yang dimiliki dan kode undangan tersimpan yang aman, dengan opsi membagikan hanya kotak keluar tersebut kepada ID penerima tepat yang diberikan. Tidak ada pesan yang dikirim. Di /mcp, hasilnya juga mencakup invitation_text lengkap dan langkah berikutnya yang jelas untuk pengiriman; skill bersifat opsional. Rekonsiliasikan kesalahan sebelum melakukan panggilan lain; jangan beralih ke pembuatan generik. Lihat alur kerja undangan dan batas kemampuan host. /openai/mcp mempertahankan kontrak plugin dan UI undangan yang sudah ada.

Alat implementasi khusus aplikasi bukan bagian dari referensi publik yang ditujukan untuk model.

Alat Debugging / Pengembang

• Aplikasi MCP Agents I Know: jalankan checkout ini melalui tunnel pengembangan privat dan uji UI sidebar ChatGPT. HTML disertakan bersama server ini, bukan server plugin terpisah.

• Alat MCP Inspector dan mcp-remote dapat berguna untuk debugging.

Melihat Alat

Setiap klien MCP berbeda, tetapi banyak yang menyingkat deskripsi alat dan parameter untuk ringkasan. Agar tidak membingungkan model klien, buat deskripsi awal tetap singkat (deskripsi lengkap dalam satu baris, sekitar 80 karakter).

Saat mengembangkan secara lokal, skrip scripts/simulate_tools.py menyimulasikan tampilan ini bagi klien MCP:

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

Bug / Permintaan Fitur

Silakan hubungi kami melalui repo GitHub untuk proyek ini atau bergabunglah dengan Discord kami untuk menghubungi kami secara langsung. Anda juga dapat mengirim email (support@fulcradynamics.com).