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

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

2. 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.

Gerar com a sua chave (0 Sinapse)

Tem crédito na fal, na Kie, na WaveSpeed, no Replicate ou na OpenRouter? Ponha a chave no env do servidor, no config do seu cliente (só as que você tem), e a sapiens_pontes gera no provedor com ela e traz a peça pro seu acervo. Você paga o preço do provedor; a casa cobra zero em cima.

{
  "mcpServers": {
    "sapiens": {
      "command": "npx",
      "args": ["-y", "sapiens-mcp"],
      "env": {
        "FAL_KEY": "cole-aqui-a-chave-da-fal",
        "KIE_API_KEY": "cole-aqui-a-chave-da-kie",
        "WAVESPEED_API_KEY": "cole-aqui-a-chave-da-wavespeed",
        "REPLICATE_API_TOKEN": "cole-aqui-o-token-do-replicate",
        "OPENROUTER_API_KEY": "cole-aqui-a-chave-da-openrouter"
      }
    }
  }
}

No Claude Code: claude mcp add sapiens --env FAL_KEY=sua-chave -- npx -y sapiens-mcp (um --env por chave). Depois é só pedir: "gera um retrato da Vera na fal com a minha chave".

No Claude Desktop tem um caminho sem config: a extensão sapiens.mcpb. Abra o arquivo e o Claude pede cada chave num campo próprio, que fica guardado no cofre do sistema. Versão nova é baixar o arquivo de novo e abrir.

A chave fica na sua máquina e sai dela só pro provedor: não vai em argumento, não volta em resultado, não passa pelo servidor do Sapiens. Por isso a sapiens_pontes existe só aqui, no servidor instalado; o conector remoto (claude.ai, ChatGPT) não recebe chave. Os jobs ficam em ~/.sapiens-mcp/pontes-jobs.json, e o mesmo pedido repetido em 30 minutos devolve o job que já existe em vez de cobrar de novo.

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 conversa com o backend público do Sapiens (Convex) e, só quando você gera com a sua chave, com o provedor dela (fal, Kie, WaveSpeed, Replicate ou OpenRouter), direto da sua máquina. 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.