Fulcra Context

공식

Fulcra Context MCP 서버로, 개인 건강, 운동, 수면, 위치 등에 접근할 수 있으며 모든 데이터는 비공개로 유지됩니다. Context by Fulcra를 기반으로 구축되었습니다.

GitHub
10

Fulcra Context MCP(으)로 무엇을 할 수 있나요?

  • Fulcra Context에 연결 — OAuth2를 지원하는 MCP 클라이언트에서 https://mcp.fulcradynamics.com/mcp를 지정해 공개 서버 인스턴스에 연결합니다.
  • stdio로 로컬 실행 — uvx로 서버를 실행하고 FULCRA_ENVIRONMENT를 stdio로 설정해 로컬 MCP 연결을 구성합니다.
  • 내가 아는 에이전트 열기 — 에이전트 연락처를 열어 달라고 요청하고, 선택적으로 특정 피어 사용자 ID 또는 다자간 스레드 ID를 지정합니다.
  • 초대 관리 — 초대를 만들거나 /mcp에서 초대를 수락하거나, 첫 메시지 코드를 사용해 사용자가 준비한 초대를 매칭합니다.
  • 데이터 유형 업데이트 — 소유한 활성 v1 Event 또는 Metric 유형의 이름이나 설명을 변경해 달라고 요청하고, 변경 후 결과를 확인합니다.

호스팅형 MCP 서버

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

Claude Code, Codex, Cursor 등에 설치됩니다

문서

fulcra-context-mcp: Fulcra Context 데이터에 액세스하는 MCP 서버

이 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으로 설정하면 stdio 전송을 사용하는 로컬 MCP 서버로 동작합니다. 그렇지 않으면 Streamable HTTP 전송을 사용하는 원격 서버로 동작합니다. OAuth2 콜백을 처리하지만, 교환된 토큰을 MCP 클라이언트에 노출하지 않습니다. 대신 매핑 테이블을 유지하고 MCP 클라이언트 사이에서 자체 OAuth2 서비스를 실행합니다.

OpenAI 플러그인 포털의 도메인 확인 토큰을 OPENAI_APPS_CHALLENGE에 설정하면 /.well-known/openai-apps-challenge에서 서비스를 제공합니다. 설정하지 않으면 해당 경로는 404를 반환합니다.

프록시를 통한 원격 연결

이 서버의 공개 인스턴스가 https://mcp.fulcradynamics.com/에서 실행 중입니다. OAuth2를 지원하는 MCP 클라이언트가 해당 주소를 가리키도록 설정하세요.

로컬 연결

uvx을 사용하는 Claude Desktop 설정 예시:

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

모델용 도구

MCP 검색을 통해 현재 도구 스키마와 설명을 확인할 수 있습니다. 연락처 및 메타데이터 도구는 다음과 같습니다.

  • open_agent_contacts: Agents I Know를 엽니다. 선택적으로 정확한 피어 사용자 ID 또는 검색된 다자간 스레드 ID를 지정할 수 있습니다. 열기는 읽기 전용이며, 렌더링하려면 MCP Apps를 지원하는 호스트가 필요합니다.
  • update_data_type: 사용자 권한을 받아 소유한 활성 v1 Event/Metric 유형의 이름이나 설명을 업데이트하고, 별도로 다시 읽어 확인합니다. 스키마, 레코드 또는 공유 항목은 변경하지 않습니다. 쓰기 결과가 불확실하면 조정이 필요합니다.
  • accept_agent_invitation on /mcp: 사용자의 권한을 받아 비어 있는 응답 채널을 만들거나 재사용하고, 정확히 지정된 초대자에게만 제한적으로 공유한 뒤 제공된 첫 소개 메시지를 게시합니다. 결과가 불확실하면 읽기 전용으로 확인하세요. 저장된 시도는 자동으로 다시 보내거나 공유하지 않습니다.
  • match_agent_invitations on /mcp: 메시지의 주장이 아니라 첫 메시지 코드와 실제 수신 공유의 소유자를 사용해 사용자가 준비한 초대를 완료합니다.
  • create_agent_invitation: 소유한 1인 채널과 안전하게 저장된 초대 코드를 만들며, 선택적으로 해당 발신함만 정확히 지정된 수신자 ID와 공유합니다. 메시지는 전송하지 않습니다. /mcp에서는 결과에 전체 invitation_text과 명시적인 전달 후속 단계도 포함됩니다. 스킬은 선택 사항입니다. 다시 호출하기 전에 오류를 조정하고, 일반 생성 방식으로 대체하지 마세요. 초대 워크플로와 호스트 기능 경계를 참조하세요. /openai/mcp는 기존 플러그인 계약과 초대 UI를 그대로 유지합니다.

앱 전용 구현 도구는 공개 모델용 참조에 포함되지 않습니다.

디버깅 / 개발자 도구

  • Agents I Know MCP App: 이 체크아웃을 비공개 개발 터널을 통해 실행하고 ChatGPT 사이드바 UI를 테스트합니다. 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).