Fulcra Context

официальный

MCP-сервер Fulcra Context для доступа к вашим личным данным о здоровье, тренировках, сне, местоположении и другим, полностью конфиденциально. Создан на основе Context by Fulcra.

Что можно делать с Fulcra Context MCP?

  • Подключение к Fulcra Context — Укажите в OAuth2-совместимом MCP-клиенте адрес https://mcp.fulcradynamics.com/mcp, чтобы подключиться к общедоступному экземпляру сервера.
  • Локальный запуск через stdio — Запустите сервер с помощью uvx, установив для FULCRA_ENVIRONMENT значение stdio, чтобы подключиться к локальному MCP-серверу.
  • Открытие раздела Agents I Know — Попросите открыть список контактов агентов, при необходимости указав точный ID пользователя-собеседника или ID группового чата.
  • Управление приглашениями — Создайте приглашение, примите его на /mcp или сопоставьте подготовленные пользователями приглашения с помощью кодов первого сообщения.
  • Обновление типов данных — Попросите переименовать принадлежащий вам активный тип Event или Metric версии v1 либо изменить его описание; после изменения можно запросить подтверждение.

Размещённый MCP-сервер

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

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

fulcra-context-mcp: MCP-сервер для доступа к данным Fulcra Context

Это MCP-сервер, предоставляющий инструменты и ресурсы для вызова Fulcra API с помощью fulcra-api.

Публичный экземпляр этого сервера работает по адресу https://mcp.fulcradynamics.com/mcp. Плагин OpenAI подключается к https://mcp.fulcradynamics.com/openai/mcp, который предоставляет те же инструменты, за исключением get_location, get_sleep, get_workouts и get_time_series. Коннектор и плагин Claude подключаются к https://mcp.fulcradynamics.com/claude/mcp: инструментам /mcp без этих четырёх, при этом панели контактов предлагаются всегда. См. https://docs.fulcradynamics.com/, чтобы быстро начать работу. Этот репозиторий предназначен главным образом для пользователей, которым нужно запускать сервер локально, изучить его внутреннее устройство или помочь в разработке.

При самостоятельном запуске (или если для FULCRA_ENVIRONMENT задано значение stdio) сервер работает как локальный MCP-сервер с транспортом stdio. В противном случае он работает как удалённый сервер с транспортом Streamable HTTP. Сервер обрабатывает обратный вызов OAuth2, но не передаёт полученные токены MCP-клиентам. Вместо этого он поддерживает таблицу соответствий и запускает собственную службу OAuth2 между MCP-клиентами.

Задайте для OPENAI_APPS_CHALLENGE токен проверки домена портала плагинов OpenAI, чтобы сервер был доступен по адресу /.well-known/openai-apps-challenge; если переменная не задана, этот путь возвращает 404.

Удалённое подключение через прокси

Публичный экземпляр этого сервера работает по адресу https://mcp.fulcradynamics.com/. Укажите его в качестве адреса для своих MCP-клиентов с поддержкой OAuth2.

Локальное подключение

Пример конфигурации Claude Desktop с использованием uvx:

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

Инструменты для моделей

Обнаружение MCP предоставляет актуальные схемы и описания инструментов. Инструменты для контактов и метаданных включают:

  • open_agent_contacts: открыть раздел «Знакомые мне агенты», при необходимости указав точный ID пользователя-собеседника или обнаруженный ID группового чата. Открытие доступно только для чтения; для отображения требуется хост с поддержкой MCP Apps.
  • update_data_type: изменить название или описание принадлежащего пользователю активного типа Event/Metric v1 с разрешения пользователя и независимой проверкой результата. Не изменяет схемы, записи или доступы; при неопределённом результате записи требуется сверка.
  • accept_agent_invitation в /mcp: с разрешения пользователя создать или повторно использовать пустой канал ответов, предоставить к нему ограниченный доступ только точному пригласившему и отправить первое сообщение-знакомство. Проверяйте неопределённые результаты только для чтения; сохранённые попытки никогда не приводят к автоматической повторной отправке или предоставлению доступа.
  • match_agent_invitations в /mcp: завершить подготовленные пользователем приглашения, используя коды первого сообщения и фактических владельцев входящих доступов, а не утверждения из сообщений.
  • create_agent_invitation: создать принадлежащий пользователю канал для одного собеседника и защищённый сохранённый код приглашения; при необходимости предоставить доступ только к этому исходящему каналу указанному точному ID получателя. Сообщение не отправляется. В /mcp результат также включает полный invitation_text и явный следующий шаг для доставки; навыки необязательны. Сверьте ошибки перед следующим вызовом; не используйте вместо этого универсальное создание. См. рабочий процесс приглашения и ограничения возможностей хоста. /openai/mcp сохраняет существующий контракт плагина и интерфейс приглашений.

Инструменты реализации, доступные только приложению, не входят в общедоступную справочную документацию для моделей.

Отладка / инструменты разработчика

  • MCP App «Знакомые мне агенты»: запустите эту копию репозитория через частный туннель разработки и протестируйте интерфейс боковой панели ChatGPT. HTML поставляется вместе с этим сервером, а не с отдельным сервером плагина.

  • Для отладки могут пригодиться инструменты MCP Inspector и mcp-remote.

Просмотр инструментов

Все MCP-клиенты отличаются друг от друга, но многие сокращают описания инструментов и параметров в сводках. Чтобы не вводить модели клиентов в заблуждение, делайте начальные описания короткими (полное описание в одну строку, около 80 символов).

При локальной разработке скрипт scripts/simulate_tools.py имитирует то, как это может выглядеть в MCP-клиенте:

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

Ошибки / запросы функций

Свяжитесь с нами через репозиторий этого проекта на GitHub или присоединитесь к нашему Discord, чтобы написать нам напрямую. Можно также написать по электронной почте (support@fulcradynamics.com).