sapiens-mcp

sapiens-mcp

Servidor MCP pra operar o Sapiens Sintéticos direto do Claude Code, na sua própria conta. Você pede no Claude ("gera uma imagem disso", "escreve um artigo sobre aquilo") e ele faz, gastando as suas Sinapses, salvando no seu perfil.

Pré-requisito

Uma conta no Sapiens Sintéticos. Conta e login acontecem só no site (Google ou email), nunca por aqui. Não tem conta? Crie em sapiensinteticos.com.

Instalar (Claude Code)

claude mcp add sapiens -- npx -y sapiens-mcp

Precisa de Node 18+. A URL do backend já vem embutida; não precisa configurar nada.

Conectar sua conta

• Abra sapiensinteticos.com/conectar-claude logado e gere o código (XXXX-XXXX, vale 5 min).

• No Claude Code, peça pra logar (ele chama a ferramenta de login), ou rode direto:

  sapiens_meta com action: "login" e code: "XXXX-XXXX"

O token vale 90 dias e renova sozinha a cada uso; fica salvo em ~/.sapiens-mcp/session.json. Pra sair: sapiens_meta action=logout, que revoga a chave no servidor e apaga o arquivo local.

O que dá pra pedir (e o custo em Sinapses)

O que	Custo
Gerar imagem (vai pra sua galeria)	~400-500
Escrever artigo na voz Sapiens (no seu perfil)	400
Voz / narração (Helen TTS)	500
Letra de música / render (Musicator)	300 / 3000
Arte de persona (MBTI)	450
Repertório, listar/editar seus artigos, ver saldo	grátis

O Claude avisa o custo antes de gastar, e geração que falha é estornada. Publicar no blog editorial, Coluna Sapiens e o pipeline são exclusivos do dono da plataforma.

Troubleshooting

• "sessionToken expirado" / "Conta Sapiens não conectada". A chave venceu (90 dias sem uso) ou nunca foi salva. Abra sapiensinteticos.com/conectar-claude logado, gere um código novo e rode sapiens_meta action=login code=XXXX-XXXX.
• Ferramenta some ou some capacidade nova depois de atualizar. O client roda via npx -y sapiens-mcp (sem versão fixa) e pode ter ficado preso num cache antigo. Confira o que está rodando com sapiens_meta action=version (mostra a versão do binário + a última do npm + upToDate). Se upToDate:false, limpe o cache do npx e reinicie o client.
• "Argumentos inválidos". A mensagem já diz qual campo faltou ou saiu errado; refaça a chamada com o que ela pede. Não repita a mesma chamada que falhou (3 falhas seguidas fazem o client marcar o servidor como indisponível por ~1 min, um disjuntor anti-loop).
• Saldo baixo antes de gerar. sapiens_meta action=credits (ou action=subscription pro detalhe por bucket) mostra quanto sobra antes de gastar em imagem/música/vídeo.

Privacidade

O servidor só conversa com o backend público do Sapiens (Convex). Sua identidade vem sempre do token de login, nunca de parâmetros soltos. Cada conta só mexe no que é dela.

Sobre o Sapiens Sintéticos

O Sapiens Sintéticos é um Studio de IA que constrói Studios: modelo de pensamento na Era Sintética, método e ferramenta na mão, pra cada pessoa montar o próprio sistema de criação, com voz e régua próprias. O método da casa é o Método Sapiens: um caminho pra tirar ideia do papel que começa pelo que te move, e não pela brecha de mercado.

Em inglês o projeto assina Synthetic Sapiens: an AI studio that builds studios. The missing skill is not using AI, it is inventing the system the AI feeds. That system is a studio of your own, the personal computer of the Synthetic Era.

Site oficial: sapiensinteticos.com · Manifesto: /manifesto · Contexto pra máquina: /llms.txt

Feito por BorderLess. Licença MIT.