Fulcra Context

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

fulcra-context-mcp: Um servidor MCP para acessar seus dados do Fulcra Context

Este é um servidor MCP que fornece ferramentas e recursos para chamar a API do Fulcra usando fulcra-api.

Há uma instância pública deste servidor em execução em https://mcp.fulcradynamics.com/mcp. O plugin do OpenAI se conecta a https://mcp.fulcradynamics.com/openai/mcp, que oferece as mesmas ferramentas, exceto get_location, get_sleep, get_workouts e get_time_series. O conector e o plugin do Claude se conectam a https://mcp.fulcradynamics.com/claude/mcp: as ferramentas /mcp, sem essas quatro, com os painéis de contato sempre disponíveis. Consulte https://docs.fulcradynamics.com/ para começar rapidamente. Este repositório destina-se principalmente a usuários que precisam executar o servidor localmente, querem conhecer seu funcionamento interno ou desejam contribuir.

Quando executado por conta própria (ou quando FULCRA_ENVIRONMENT está definido como stdio), ele funciona como um servidor MCP local usando o transporte stdio. Caso contrário, funciona como um servidor remoto usando o transporte Streamable HTTP. Ele processa o callback do OAuth2, mas não expõe os tokens trocados aos clientes MCP. Em vez disso, mantém uma tabela de mapeamento e executa seu próprio serviço OAuth2 entre os clientes MCP.

Defina OPENAI_APPS_CHALLENGE como o token de verificação de domínio do portal de plugins do OpenAI para disponibilizá-lo em /.well-known/openai-apps-challenge; se não estiver definido, esse caminho retorna 404.

Conexão remota usando proxy

Há uma instância pública deste servidor em execução em https://mcp.fulcradynamics.com/. Aponte seus clientes MCP compatíveis com OAuth2 para ela.

Conexão local

Exemplo de configuração do Claude Desktop usando uvx:

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

Ferramentas voltadas ao modelo

A descoberta MCP fornece os esquemas e as descrições atuais das ferramentas. As ferramentas de contato e metadados incluem:

• open_agent_contacts: abre Agents I Know, opcionalmente direcionado a um ID exato de usuário par ou a um ID de conversa multiparte descoberta. A abertura é somente para leitura; a renderização requer um host com suporte a MCP Apps.
• update_data_type: atualiza o nome ou a descrição de um tipo Event/Metric v1 ativo e de propriedade do usuário, com autorização do usuário e leitura de confirmação independente. Não altera esquemas, registros ou compartilhamentos; gravações incertas exigem reconciliação.
• accept_agent_invitation em /mcp: com a autorização do usuário, cria ou reutiliza um canal de resposta vazio, compartilha-o de forma restrita com o autor exato do convite e publica a introdução inicial fornecida. Inspecione resultados incertos somente para leitura; tentativas salvas nunca reenviam nem compartilham automaticamente.
• match_agent_invitations em /mcp: conclui convites preparados pelo usuário usando códigos da primeira mensagem e os proprietários reais dos compartilhamentos recebidos, não alegações contidas nas mensagens.
• create_agent_invitation: cria um canal próprio para uma única pessoa e um código de convite persistido e seguro, podendo compartilhar somente essa caixa de saída com um ID exato de destinatário fornecido. Nenhuma mensagem é enviada. Em /mcp, o resultado também inclui invitation_text completo e uma próxima etapa explícita de entrega; as skills são opcionais. Reconcilie os erros antes de fazer outra chamada; não recorra à criação genérica. Consulte o fluxo de convite e os limites dos recursos do host. /openai/mcp mantém seu contrato de plugin e sua interface de convite atuais.

As ferramentas de implementação exclusivas do app não fazem parte da referência pública voltada ao modelo.

Ferramentas de depuração / desenvolvimento

• App MCP Agents I Know: execute este checkout por meio de um túnel de desenvolvimento privado e teste a interface da barra lateral do ChatGPT. O HTML é fornecido com este servidor, não por um servidor de plugin separado.

• Tanto a ferramenta MCP Inspector quanto a mcp-remote podem ser úteis na depuração.

Visualização das ferramentas

Cada cliente MCP é diferente, mas muitos abreviam as descrições das ferramentas e dos parâmetros nos resumos. Para evitar confundir os modelos dos clientes, mantenha curtas as descrições iniciais (descrição completa em uma linha, com cerca de 80 caracteres).

Durante o desenvolvimento local, o script scripts/simulate_tools.py simula como isso pode aparecer para um cliente MCP:

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

Bugs / solicitações de recursos

Fique à vontade para entrar em contato pelo repositório do GitHub deste projeto ou participar do nosso Discord para falar diretamente conosco. Também aceitamos contato por e-mail (support@fulcradynamics.com).