Fulcra Context

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

fulcra-context-mcp : un serveur MCP pour accéder à vos données Fulcra Context

Il s’agit d’un serveur MCP qui fournit des outils et des ressources pour appeler l’API Fulcra à l’aide de fulcra-api.

Une instance publique de ce serveur est disponible à l’adresse https://mcp.fulcradynamics.com/mcp. Le plugin OpenAI se connecte à https://mcp.fulcradynamics.com/openai/mcp, qui fournit les mêmes outils, à l’exception de get_location, get_sleep, get_workouts et get_time_series. Le connecteur et le plugin de Claude se connectent à https://mcp.fulcradynamics.com/claude/mcp : les outils /mcp, sans ces quatre outils, avec les panneaux de contact toujours proposés. Consultez https://docs.fulcradynamics.com/ pour démarrer rapidement. Ce dépôt s’adresse principalement aux utilisateurs qui doivent exécuter le serveur localement, souhaitent découvrir son fonctionnement interne ou veulent contribuer au projet.

Lorsqu’il est exécuté seul (ou lorsque FULCRA_ENVIRONMENT est défini sur stdio), il fonctionne comme un serveur MCP local utilisant le transport stdio. Sinon, il fonctionne comme un serveur distant utilisant le transport HTTP Streamable. Il gère le rappel OAuth2, mais ne divulgue pas aux clients MCP les jetons échangés. À la place, il conserve une table de correspondance et exécute son propre service OAuth2 entre les clients MCP.

Définissez OPENAI_APPS_CHALLENGE sur le jeton de vérification de domaine du portail des plugins OpenAI pour le rendre accessible à l’adresse /.well-known/openai-apps-challenge ; si cette variable n’est pas définie, ce chemin renvoie une erreur 404.

Connexion distante via un proxy

Une instance publique de ce serveur est disponible à l’adresse https://mcp.fulcradynamics.com/. Configurez vos clients MCP compatibles avec OAuth2 pour qu’ils s’y connectent.

Connexion locale

Exemple de configuration Claude Desktop utilisant uvx :

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

Outils destinés aux modèles

La découverte MCP fournit les schémas et descriptions actuels des outils. Les outils de contact et de métadonnées comprennent :

• open_agent_contacts : ouvrir Agents I Know, en ciblant éventuellement un ID utilisateur pair exact ou un ID de fil de discussion multipartite découvert. L’ouverture est en lecture seule ; l’affichage nécessite un hôte prenant en charge MCP Apps.
• update_data_type : mettre à jour le nom ou la description d’un type Event/Metric v1 actif dont l’utilisateur est propriétaire, avec son autorisation et une vérification indépendante après écriture. Cela ne modifie ni les schémas, ni les enregistrements, ni les partages ; les écritures dont le résultat est incertain nécessitent une réconciliation.
• accept_agent_invitation sur /mcp : avec l’autorisation de l’utilisateur, créer ou réutiliser un canal de réponse vide, le partager uniquement avec l’invitant exact et publier le premier message de présentation fourni. Examiner les résultats incertains en lecture seule ; les tentatives enregistrées ne déclenchent jamais automatiquement un nouvel envoi ou partage.
• match_agent_invitations sur /mcp : finaliser les invitations préparées par l’utilisateur à l’aide de codes de premier message et des propriétaires réels des partages entrants, et non des affirmations contenues dans les messages.
• create_agent_invitation : créer un canal appartenant à l’utilisateur et destiné à une seule personne, ainsi qu’un code d’invitation persistant sécurisé, avec la possibilité de partager uniquement cette boîte d’envoi avec un ID de destinataire exact fourni. Aucun message n’est envoyé. Sur /mcp, le résultat comprend également le invitation_text complet et une prochaine étape explicite pour la livraison ; les compétences sont facultatives. Réconciliez les erreurs avant tout nouvel appel ; ne recourez pas à la création générique. Consultez le processus d’invitation et les limites des capacités de l’hôte. /openai/mcp conserve son contrat de plugin et son interface d’invitation existants.

Les outils d’implémentation réservés à l’application ne font pas partie de la référence publique destinée aux modèles.

Débogage / outils de développement

• Application MCP Agents I Know : exécutez cette copie du dépôt via un tunnel de développement privé et testez l’interface de la barre latérale ChatGPT. Le HTML est fourni avec ce serveur, et non par un serveur de plugin distinct.

• Les outils MCP Inspector et mcp-remote peuvent tous deux être utiles pour le débogage.

Affichage des outils

Chaque client MCP est différent, mais beaucoup abrègent les descriptions des outils et des paramètres dans les résumés. Pour éviter de dérouter les modèles des clients, gardez les descriptions initiales courtes (description complète sur une ligne, environ 80 caractères).

Lors du développement local, le script scripts/simulate_tools.py simule ce que pourrait voir un client MCP :

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

Bugs / demandes de fonctionnalités

N’hésitez pas à nous contacter via le dépôt GitHub de ce projet ou à rejoindre notre Discord pour nous joindre directement. Vous pouvez également nous écrire par e-mail (support@fulcradynamics.com).