# sapiens-mcp ![Helen Ailith numa mesa escura, antebracos vestidos por um exoesqueleto de luz verde, movendo placas de luz com as maos abertas](https://sapiensinteticos.b-cdn.net/borderlessprotocol/2026/07/1785430717302_e8p3i4.webp)

O sapiens-mcp em 15 segundos: você fala, sua IA executa
Assiste em 15 segundos, com som · corte vertical · in English

Servidor MCP pra operar o [Sapiens Sintéticos](https://sapiensinteticos.com) 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](https://sapiensinteticos.com). ## Instalar (Claude Code) ```bash 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 ![Helen segurando uma chave de luz verde entre duas portas: um retangulo de luz sem moldura e um terminal fisico](https://sapiensinteticos.b-cdn.net/borderlessprotocol/2026/07/1785430826064_avwjib.webp) 1. Abra **[sapiensinteticos.com/conectar-claude](https://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) ![Helen com um braco estendido, orbitada por uma lente, rolos de filme, um vinil, um caderno aberto e um microfone de estudio](https://sapiensinteticos.b-cdn.net/borderlessprotocol/2026/07/1785430870745_waml5a.webp) | 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 ou no Replicate? 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. ```json { "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" } } } } ``` 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](https://sapiensinteticos.b-cdn.net/mcpb/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](https://www.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 ou Replicate), 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](https://www.sapiensinteticos.com) · Manifesto: [/manifesto](https://www.sapiensinteticos.com/manifesto) · Contexto pra máquina: [/llms.txt](https://www.sapiensinteticos.com/llms.txt) --- Feito por [BorderLess](https://sapiensinteticos.com). Licença MIT.