Conecte o Claude (ou ChatGPT, Cursor, e outros) à plataforma e converse com os dados do Núcleo em linguagem natural, respeitando as permissões que você já tem. Você só enxerga o que já veria no site, com a mesma conta e login.
Isto é alfa, de propósito
Estamos construindo e validando a camada semântica. A estabilidade só se conhece com gente usando e dando carga. Você é co-testador: arestas são esperadas, e o seu reporte é exatamente o que faz a ferramenta avançar.
Endereço do conector (use este)
https://nucleoia.vitormr.dev/mcp/semantic
Escape-hatch (só se o cliente rejeitar o conector acima, e nos avise)
https://nucleoia.vitormr.dev/mcp
Passo a passo por cliente
Claude.ai (Web / Desktop)
Abra Configurações → Conectores (ou Integrações).
Adicionar servidor MCP personalizado e cole a URL do conector.
Faça login na sua conta do Núcleo e aprove o acesso (OAuth).
Claude Code (terminal)
Rode: claude mcp add --transport http nucleo https://nucleoia.vitormr.dev/mcp/semantic
Se o fluxo OAuth abrir, aprove no navegador. Pronto.
Fallback (se não abrir OAuth): use um token manual do site (Local Storage, chave sb-ldrfrvwhxsmgaabwmaik-auth-token) como header Bearer. Ele expira em 1 hora; repita para renovar.
Cursor / VS Code
Settings → MCP Servers → Add.
Cole a URL do conector e conclua o login (OAuth).
ChatGPT (beta)
Settings → Apps → Connectors → Advanced → New App.
Nome: Nucleo-IA. Cole a URL e aprove (OAuth). Obs.: "Internal Server Error" aqui costuma ser bug do beta do ChatGPT, não da plataforma.
Outros (Perplexity, Manus, xAI...)
Mesma URL do conector. Transporte: Streamable HTTP. Auth: OAuth 2.0.
Exemplos de uso (linguagem natural)
"Quais são meus próximos eventos?"
"Mostra o board da minha tribo por status."
"Qual minha presença e meu XP no ciclo?"
"Registra minha presença na última reunião." (escrita pede confirmação)
"Tenho alguma avaliação pendente?"
Se algo falhar
Reconecte o servidor MCP no seu cliente (remover e adicionar de novo resolve a maioria dos casos).
Se persistir ou faltar alguma capacidade, tente o escape-hatch (catálogo completo) e nos avise.
Ao reportar, diga: cliente + o que tentou + o erro (print ou copiar-colar).
Achou uma aresta? Reporte
Abra um comentário na issue de feedback do GitHub, ou avise no WhatsApp do grupo. Diga o cliente, o que tentou e o erro.