Fulcra Context

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

fulcra-context-mcp: Máy chủ MCP để truy cập dữ liệu Fulcra Context của bạn

Đây là máy chủ MCP cung cấp các công cụ và tài nguyên để gọi Fulcra API bằng fulcra-api.

Máy chủ này có một phiên bản công khai đang chạy tại https://mcp.fulcradynamics.com/mcp. Plugin OpenAI kết nối với https://mcp.fulcradynamics.com/openai/mcp, cung cấp cùng các công cụ, ngoại trừ get_location, get_sleep, get_workouts và get_time_series. Bộ kết nối và plugin của Claude kết nối với https://mcp.fulcradynamics.com/claude/mcp: các công cụ /mcp nhưng không có bốn công cụ đó, đồng thời luôn cung cấp các bảng liên hệ. Xem https://docs.fulcradynamics.com/ để bắt đầu nhanh. Repo này chủ yếu dành cho người dùng cần chạy máy chủ cục bộ, muốn tìm hiểu cách hoạt động bên trong hoặc muốn đóng góp.

Khi chạy độc lập (hoặc khi FULCRA_ENVIRONMENT được đặt thành stdio), máy chủ hoạt động cục bộ bằng giao thức truyền tải stdio. Nếu không, máy chủ hoạt động từ xa bằng giao thức truyền tải Streamable HTTP. Máy chủ xử lý lệnh gọi lại OAuth2 nhưng không để lộ các token đã trao đổi cho ứng dụng khách MCP. Thay vào đó, máy chủ duy trì một bảng ánh xạ và chạy dịch vụ OAuth2 riêng giữa các ứng dụng khách MCP.

Đặt OPENAI_APPS_CHALLENGE thành token xác minh miền của cổng plugin OpenAI để cung cấp máy chủ tại /.well-known/openai-apps-challenge; nếu không đặt, đường dẫn đó sẽ trả về 404.

Kết nối từ xa bằng Proxy

Máy chủ này có một phiên bản công khai đang chạy tại https://mcp.fulcradynamics.com/. Hãy trỏ các ứng dụng khách MCP hỗ trợ OAuth2 của bạn đến đó.

Kết nối cục bộ

Ví dụ cấu hình Claude Desktop sử dụng uvx:

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

Công cụ dành cho mô hình

MCP discovery cung cấp các lược đồ và mô tả công cụ hiện tại. Các công cụ liên hệ và siêu dữ liệu bao gồm:

• open_agent_contacts: mở Agents I Know, có thể chỉ định chính xác ID người dùng ngang hàng hoặc ID luồng nhiều bên đã được phát hiện. Việc mở chỉ đọc; để hiển thị cần máy chủ hỗ trợ MCP Apps.
• update_data_type: cập nhật tên hoặc mô tả của một loại Event/Metric v1 đang hoạt động do người dùng sở hữu, với sự cho phép của người dùng và xác minh độc lập bằng cách đọc lại. Không thay đổi lược đồ, bản ghi hoặc lượt chia sẻ; các lần ghi có kết quả không chắc chắn cần được đối soát.
• accept_agent_invitation trên /mcp: với sự cho phép của người dùng, tạo hoặc dùng lại một kênh phản hồi trống, chỉ chia sẻ kênh đó với đúng người mời và đăng lời giới thiệu đầu tiên được cung cấp. Kiểm tra các kết quả không chắc chắn bằng thao tác chỉ đọc; các lần thử đã lưu sẽ không tự động gửi/chia sẻ lại.
• match_agent_invitations trên /mcp: hoàn tất lời mời do người dùng chuẩn bị bằng mã tin nhắn đầu tiên và chủ sở hữu thực tế của lượt chia sẻ đến, không dựa vào nội dung tin nhắn.
• create_agent_invitation: tạo một kênh riêng cho một người do người dùng sở hữu và mã lời mời được lưu trữ an toàn; có thể chỉ chia sẻ hộp thư đi đó với ID người nhận chính xác được cung cấp. Không gửi tin nhắn. Trên /mcp, kết quả cũng bao gồm đầy đủ invitation_text và bước tiếp theo rõ ràng để gửi lời mời; kỹ năng là tùy chọn. Đối soát lỗi trước khi gọi lại; không chuyển sang cách tạo chung. Xem quy trình lời mời và giới hạn năng lực của máy chủ. /openai/mcp giữ nguyên hợp đồng plugin và giao diện lời mời hiện có.

Các công cụ triển khai chỉ dành cho ứng dụng không thuộc tài liệu tham khảo công khai dành cho mô hình.

Công cụ gỡ lỗi / dành cho nhà phát triển

• Ứng dụng MCP Agents I Know: chạy bản checkout này qua một đường hầm phát triển riêng tư và kiểm thử giao diện thanh bên ChatGPT. HTML được đóng gói cùng máy chủ này, không phải một máy chủ plugin riêng.

• Cả công cụ MCP Inspector và mcp-remote đều có thể hữu ích khi gỡ lỗi.

Xem công cụ

Mỗi ứng dụng khách MCP đều khác nhau, nhưng nhiều ứng dụng rút gọn mô tả công cụ và tham số để tạo bản tóm tắt. Để tránh gây nhầm lẫn cho các mô hình phía ứng dụng khách, hãy giữ phần mô tả ban đầu ngắn gọn (toàn bộ mô tả trên một dòng, khoảng 80 ký tự).

Khi phát triển cục bộ, tập lệnh scripts/simulate_tools.py mô phỏng giao diện mà ứng dụng khách MCP có thể thấy:

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

Lỗi / Yêu cầu tính năng

Bạn có thể liên hệ qua repo GitHub của dự án này hoặc tham gia Discord của chúng tôi để liên hệ trực tiếp. Bạn cũng có thể gửi email (support@fulcradynamics.com).