Skip to content

Servidor MCP do BSP

Conecte qualquer IA compatível com MCP (Claude, GPT, etc.) a dados biológicos do BSP com enforcement de consentimento ativo.

Configuração

Adicione ao claude_desktop_config.json do Claude Desktop:

json
{
  "mcpServers": {
    "bsp": {
      "command": "npx",
      "args": ["-y", "bsp-mcp"],
      "env": {
        "BSP_BEO_DOMAIN": "seunome.bsp",
        "BSP_CONSENT_TOKEN_ID": "tok_...",
        "BSP_NETWORK": "mainnet"
      }
    }
  }
}

Depois pergunte ao Claude: "O que meus exames de sangue dizem sobre minha saúde cardiovascular?"


Variáveis de Ambiente

VariávelObrigatóriaDescrição
BSP_BEO_DOMAINSimSeu domínio .bsp
BSP_CONSENT_TOKEN_IDPara acesso a dadosConsentToken com intent READ_RECORDS
BSP_NETWORKNãomainnet (padrão), testnet, local
BSP_PRIVATE_KEYPara operações de escritaChave privada Ed25519 (hex)
BSP_REGISTRY_URLNãoURL customizada da API

Tools — Leitura

bsp_list_categories

Lista todas as 25 categorias da taxonomia BSP. Dados públicos.

bsp_resolve_biomarker

Consulta um código de biomarcador BSP (ex: BSP-GL-001). Dados públicos.

Verifica configuração de consentimento atual — BEO, token, rede.

bsp_get_biorecords

Lê BioRecords do BEO do usuário. Requer ConsentToken com intent READ_RECORDS.

bsp_get_beo_summary

Visão geral estruturada do perfil biológico do usuário.


Tools — Escrita (requer BSP_PRIVATE_KEY)

bsp_lock_beo

Bloqueio de emergência — congela o BEO imediatamente.

bsp_unlock_beo

Desbloqueia um BEO previamente bloqueado.

bsp_destroy_beo

IRREVERSÍVEL — Erasure permanente (LGPD/GDPR). Requer confirm: true.

bsp_revoke_all_tokens

Emergência — revoga TODOS os ConsentTokens ativos de um BEO.


Segurança

  • Tools de leitura requerem ConsentToken válido (configurado via env)
  • Tools de escrita requerem a chave privada do titular do BEO
  • O servidor MCP assina payloads localmente — chaves nunca saem do processo
  • Consentimento é verificado on-chain pelo contrato AccessControl

Referência CLI · Referência SDK · Referência API