Fulcra Context

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

fulcra-context-mcp: Un servidor MCP para acceder a tus datos de Fulcra Context

Este es un servidor MCP que proporciona herramientas y recursos para llamar a la API de Fulcra mediante fulcra-api.

Hay una instancia pública de este servidor en funcionamiento en https://mcp.fulcradynamics.com/mcp. El complemento de OpenAI se conecta a https://mcp.fulcradynamics.com/openai/mcp, que ofrece las mismas herramientas, excepto get_location, get_sleep, get_workouts y get_time_series. El conector y el complemento de Claude se conectan a https://mcp.fulcradynamics.com/claude/mcp: las herramientas /mcp sin esas cuatro, con los paneles de contacto siempre disponibles. Consulta https://docs.fulcradynamics.com/ para empezar rápidamente. Este repositorio está dirigido principalmente a quienes necesitan ejecutar el servidor localmente, quieren conocer su funcionamiento interno o desean contribuir.

Cuando se ejecuta por sí solo (o cuando FULCRA_ENVIRONMENT se establece en stdio), funciona como un servidor MCP local mediante el transporte stdio. De lo contrario, funciona como un servidor remoto mediante el transporte Streamable HTTP. Gestiona la devolución de llamada de OAuth2, pero no filtra los tokens intercambiados a los clientes MCP. En su lugar, mantiene una tabla de correspondencias y ejecuta su propio servicio OAuth2 entre los clientes MCP.

Establece OPENAI_APPS_CHALLENGE en el token de verificación de dominio del portal de complementos de OpenAI para ofrecerlo en /.well-known/openai-apps-challenge; si no se establece, esa ruta devuelve 404.

Conexión remota mediante proxy

Hay una instancia pública de este servidor en funcionamiento en https://mcp.fulcradynamics.com/. Configura tus clientes MCP compatibles con OAuth2 para que se conecten a ella.

Conexión local

Ejemplo de configuración de Claude Desktop con uvx:

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

Herramientas disponibles para el modelo

La detección de MCP proporciona los esquemas y las descripciones actuales de las herramientas. Las herramientas de contacto y metadatos incluyen:

• open_agent_contacts: abre Agents I Know, opcionalmente dirigido a un ID de usuario par exacto o a un ID de hilo multiparte detectado. La apertura es de solo lectura; para mostrarlo se necesita un host compatible con MCP Apps.
• update_data_type: actualiza el nombre o la descripción de un tipo Event/Metric v1 activo y propio, con autorización del usuario y verificación de lectura independiente. No modifica esquemas, registros ni recursos compartidos; las escrituras con resultados inciertos requieren conciliación.
• accept_agent_invitation en /mcp: con la autorización del usuario, crea o reutiliza un canal de respuesta vacío, lo comparte de forma restringida con la persona invitante exacta y publica la introducción inicial proporcionada. Inspecciona los resultados inciertos en modo de solo lectura; los intentos guardados nunca vuelven a enviar ni compartir automáticamente.
• match_agent_invitations en /mcp: completa invitaciones preparadas por el usuario mediante códigos del primer mensaje y los propietarios reales de los recursos compartidos entrantes, no mediante afirmaciones de los mensajes.
• create_agent_invitation: crea un canal propio para una sola persona y un código de invitación persistente y seguro, con la opción de compartir únicamente ese buzón de salida con un ID de destinatario exacto proporcionado. No se envía ningún mensaje. En /mcp, el resultado también incluye el invitation_text completo y un siguiente paso explícito para la entrega; las habilidades son opcionales. Concilia los errores antes de volver a llamar; no recurras a la creación genérica. Consulta el flujo de invitación y los límites de las capacidades del host. /openai/mcp conserva su contrato de complemento y su interfaz de invitación actuales.

Las herramientas de implementación exclusivas de la aplicación no forman parte de la referencia pública de herramientas disponibles para el modelo.

Depuración / Herramientas para desarrolladores

• Aplicación MCP Agents I Know: ejecuta esta copia de trabajo mediante un túnel de desarrollo privado y prueba la interfaz de la barra lateral de ChatGPT. El HTML se distribuye con este servidor, no con un servidor de complementos independiente.

• Tanto la herramienta MCP Inspector como mcp-remote pueden resultar útiles para la depuración.

Visualización de herramientas

Cada cliente MCP es diferente, pero muchos abrevian las descripciones de las herramientas y los parámetros en los resúmenes. Para evitar confundir a los modelos de los clientes, mantén breves las descripciones iniciales (descripción completa en una línea, de unos 80 caracteres).

Durante el desarrollo local, el script scripts/simulate_tools.py simula cómo podría verse esto para un cliente MCP:

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

Errores / Solicitudes de funciones

No dudes en ponerte en contacto mediante el repositorio de GitHub de este proyecto o unirte a nuestro Discord para escribirnos directamente. También puedes enviar un correo electrónico (support@fulcradynamics.com).