sapiens-mcp weekly downloads statistics

sapiens-mcp

<p align="center"> <a href="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-pt-3e96346c.mp4"><img src="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-pt-497bacfa.jpg" width="720" alt="O sapiens-mcp em 15 segundos: você fala, sua IA executa"></a><br> <a href="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-pt-3e96346c.mp4"><b>Assiste em 15 segundos, com som</b></a> · <a href="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-9x16-pt-b5b02542.mp4">corte vertical</a> · <a href="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-en-e17d0673.mp4">in English</a> </p>

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…