Fulcra Context

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

fulcra-context-mcp: Ein MCP-Server für den Zugriff auf deine Fulcra Context-Daten

Dies ist ein MCP-Server, der Tools und Ressourcen bereitstellt, um die Fulcra API mit fulcra-api aufzurufen.

Eine öffentliche Instanz dieses Servers läuft unter https://mcp.fulcradynamics.com/mcp. Das OpenAI-Plugin verbindet sich mit https://mcp.fulcradynamics.com/openai/mcp, das dieselben Tools bereitstellt, mit Ausnahme von get_location, get_sleep, get_workouts und get_time_series. Claudes Connector und Plugin verbinden sich mit https://mcp.fulcradynamics.com/claude/mcp: den /mcp-Tools ohne diese vier, wobei die Kontakt-Panels immer angeboten werden. Siehe https://docs.fulcradynamics.com/, um schnell loszulegen. Dieses Repository richtet sich in erster Linie an Nutzer, die den Server lokal ausführen, einen Blick unter die Haube werfen oder bei der Entwicklung mithelfen möchten.

Wird der Server eigenständig ausgeführt (oder ist FULCRA_ENVIRONMENT auf stdio gesetzt), fungiert er als lokaler MCP-Server mit dem stdio-Transport. Andernfalls fungiert er als Remote-Server mit dem Streamable-HTTP-Transport. Er verarbeitet den OAuth2-Callback, gibt die ausgetauschten Tokens jedoch nicht an MCP-Clients weiter. Stattdessen verwaltet er eine Zuordnungstabelle und betreibt einen eigenen OAuth2-Dienst zwischen den MCP-Clients.

Setze OPENAI_APPS_CHALLENGE auf das Domain-Verifizierungstoken des OpenAI-Plugin-Portals, um den Server unter /.well-known/openai-apps-challenge bereitzustellen; ist die Variable nicht gesetzt, gibt dieser Pfad 404 zurück.

Remote-Verbindung über Proxy

Eine öffentliche Instanz dieses Servers läuft unter https://mcp.fulcradynamics.com/. Richte deine OAuth2-fähigen MCP-Clients darauf aus.

Lokale Verbindung

Beispielkonfiguration für Claude Desktop mit uvx:

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

Modellseitige Tools

Die MCP-Erkennung stellt die aktuellen Tool-Schemas und Beschreibungen bereit. Zu den Kontakt- und Metadaten-Tools gehören:

• open_agent_contacts: Öffnet „Agents I Know“, optional mit einer bestimmten Peer-Benutzer-ID oder einer ermittelten ID eines Mehrparteien-Threads. Das Öffnen ist schreibgeschützt; zum Rendern ist ein Host mit MCP-Apps-Unterstützung erforderlich.
• update_data_type: Aktualisiert mit Autorisierung des Nutzers und unabhängigem Auslesen zur Überprüfung den Namen oder die Beschreibung eines eigenen, aktiven Event-/Metric-Typs der Version 1. Schemas, Datensätze und Freigaben werden nicht geändert; bei unsicheren Schreibvorgängen ist ein Abgleich erforderlich.
• accept_agent_invitation auf /mcp: Erstellt oder verwendet mit Autorisierung des Nutzers einen leeren Antwortkanal erneut, gibt ihn gezielt für den exakten Einladenden frei und veröffentlicht die angegebene erste Vorstellung. Prüfe unsichere Ergebnisse ausschließlich lesend; gespeicherte Versuche senden oder teilen niemals automatisch erneut.
• match_agent_invitations auf /mcp: Schließt vom Nutzer vorbereitete Einladungen mithilfe von Codes für die erste Nachricht und den tatsächlichen Eigentümern eingehender Freigaben ab, nicht anhand von Behauptungen in Nachrichten.
• create_agent_invitation: Erstellt einen eigenen Kanal für eine einzelne Person und einen sicher gespeicherten Einladungscode; optional wird nur dieser Postausgang für eine angegebene, exakte Empfänger-ID freigegeben. Es wird keine Nachricht gesendet. Auf /mcp enthält das Ergebnis außerdem das vollständige invitation_text und einen expliziten nächsten Schritt für die Zustellung; Skills sind optional. Gleiche Fehler ab, bevor du einen weiteren Aufruf tätigst; weiche nicht auf die generische Erstellung aus. Siehe den Einladungsablauf und die Grenzen der Host-Funktionen. /openai/mcp behält seinen bestehenden Plugin-Vertrag und seine Einladungsoberfläche bei.

Implementierungstools, die nur für die App bestimmt sind, gehören nicht zur öffentlichen Referenz für modellseitige Tools.

Debugging- / Entwicklertools

• Agents I Know MCP App: Führe diesen Checkout über einen privaten Entwicklungstunnel aus und teste die ChatGPT-Seitenleistenoberfläche. Das HTML wird mit diesem Server ausgeliefert, nicht mit einem separaten Plugin-Server.

• Sowohl MCP Inspector als auch mcp-remote können beim Debugging hilfreich sein.

Tools anzeigen

Jeder MCP-Client ist anders, aber viele kürzen Tool- und Parameterbeschreibungen für Zusammenfassungen. Um Verwirrung bei Client-Modellen zu vermeiden, sollten die anfänglichen Beschreibungen kurz sein (vollständige Beschreibung in einer Zeile, etwa 80 Zeichen).

Während der lokalen Entwicklung simuliert das Skript scripts/simulate_tools.py, wie dies für einen MCP-Client aussehen könnte:

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

Fehler / Funktionswünsche

Du kannst dich gerne über das GitHub-Repository dieses Projekts oder unserem Discord beitreten, um direkt Kontakt aufzunehmen. E-Mail geht auch (support@fulcradynamics.com).