sapiens-mcp 1.79.1 → 1.80.0

package/README.md

@@ -68,6 +68,8 @@ Tem crédito na fal ou na Kie? Ponha a chave no `env` do servidor, no config do
 
 No Claude Code: `claude mcp add sapiens --env FAL_KEY=sua-chave -- npx -y sapiens-mcp`. 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 a chave da fal e da Kie em campos próprios, que ficam guardados 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

package/dist/canal.js

@@ -0,0 +1,16 @@
+/**
+ * Por onde este processo chegou na máquina da pessoa. Muda como se atualiza:
+ *
+ * - "npm" (padrão): `npx -y sapiens-mcp` no config do cliente. Versão nova =
+ *   limpar o cache do npx ou pinar a versão.
+ * - "mcpb": a extensão do Claude Desktop (tools/mcp-sapiens/scripts/mcpb.mjs).
+ *   O manifesto dela põe SAPIENS_MCP_CANAL=mcpb no ambiente. Versão nova =
+ *   baixar o arquivo de novo e abrir: o Claude Desktop troca a extensão.
+ */
+export const CANAL = process.env.SAPIENS_MCP_CANAL === "mcpb" ? "mcpb" : "npm";
+/**
+ * Endereço estável da extensão no CDN da casa. O scripts/mcpb.mjs sobe aqui a
+ * cada release e purga o cache da borda; a página /conectar-claude aponta pro
+ * mesmo arquivo.
+ */
+export const MCPB_URL = "https://sapiensinteticos.b-cdn.net/mcpb/sapiens.mcpb";

package/dist/tools/meta.js

@@ -2,6 +2,8 @@ import { z } from "zod";
 import { convexQuery, convexMutation, convexAction, getSessionToken, saveSessionToken, clearSessionToken, describeConvexError, isRemoteContext, } from "../convexClient.js";
 import { getMcpVersion } from "../version.js";
 import { setTierFromIsAdmin } from "../tier.js";
+import { CANAL, MCPB_URL } from "../canal.js";
+import { valorDeChave } from "./pontes.js";
 /**
  * Versão do MCP realmente rodando (fonte única em ../version.js, lê o
  * package.json em runtime). Serve pra flagrar client preso em cache antigo do npx.
@@ -316,7 +318,9 @@ export async function meta(args) {
                     running: ver.version,
                     latest: ver.latest,
                     howToFix: [
-                        `Atualizar o pacote: pinar sapiens-mcp@${ver.latest} na config do MCP, ou limpar o cache do npx e reiniciar o agent (restart sozinho não basta, o cache sobrevive).`,
+                        CANAL === "mcpb"
+                            ? `Baixar a extensão nova (${MCPB_URL}) e abrir o arquivo: o Claude Desktop troca a versão da extensão e as chaves já guardadas ficam.`
+                            : `Atualizar o pacote: pinar sapiens-mcp@${ver.latest} na config do MCP, ou limpar o cache do npx e reiniciar o agent (restart sozinho não basta, o cache sobrevive).`,
                         "Ou conectar pelo MCP remoto em sapiensinteticos.com/conectar-claude: ele sai do site, então está sempre na última versão e nunca desatualiza.",
                     ],
                     note: "AVISE O USUÁRIO já na primeira resposta. Client atrasado chama rotas antigas e falha de um jeito que parece erro do Sapiens (ex: filme que 'foi adicionado' e não entrou no Repertório).",
@@ -447,9 +451,12 @@ export async function meta(args) {
             version,
             latest,
             upToDate,
+            canal: CANAL,
             runtime: `node ${process.version}`,
             note: latest && upToDate === false
-                ? `Rodando ${version}, mas a última no npm é ${latest}: o client está ATRASADO (provável cache do npx). Pra atualizar: pinar sapiens-mcp@${latest} na config do MCP ou recriar o container (restart sozinho não basta).`
+                ? CANAL === "mcpb"
+                    ? `Rodando ${version} pela extensão do Claude Desktop, e a última é ${latest}. Pra atualizar: baixar a extensão nova (${MCPB_URL}) e abrir o arquivo; as chaves já guardadas ficam.`
+                    : `Rodando ${version}, mas a última no npm é ${latest}: o client está ATRASADO (provável cache do npx). Pra atualizar: pinar sapiens-mcp@${latest} na config do MCP ou recriar o container (restart sozinho não basta).`
                 : latest && upToDate
                     ? `Na última versão (${version}).`
                     : `Versão do binário rodando agora: ${version}. Não consegui consultar o npm pra comparar (offline/timeout).`,
@@ -554,10 +561,7 @@ export async function meta(args) {
         const remoto = isRemoteContext();
         const detectadas = remoto
             ? []
-            : PONTES.filter((p) => p.envVars.some((nome) => {
-                const valor = process.env[nome];
-                return typeof valor === "string" && valor.trim().length >= 8;
-            })).map((p) => p.key);
+            : PONTES.filter((p) => p.envVars.some((nome) => Boolean(valorDeChave(nome)))).map((p) => p.key);
         const naPortaLocal = detectadas.filter((k) => PORTA_LOCAL.includes(k));
         return {
             regra: "A chave de provedor NUNCA passa pelo Sapiens: ela mora no ambiente da máquina da pessoa e quem chama o motor é um processo de lá (o harness dela, ou o sapiens-mcp instalado pela sapiens_pontes). A casa entra com a ficha do personagem (sapiens_character action=get: passportPrompt + imageUrls) e recebe a peça de volta pelo ingest, que grava motor, prompt verbatim, custo real e personagem. Com a chave dela, gerar custa zero em Sinapses: ela paga o preço do provedor, sem margem da casa. Passo a passo: sapiens_skill action=get name=pontes.",

package/dist/tools/pontes.js

@@ -5,6 +5,7 @@ import path from "node:path";
 import { createHash, randomBytes } from "node:crypto";
 import { describeConvexError, getSessionToken, isRemoteContext, } from "../convexClient.js";
 import { findMinorMarkers } from "../pisoDeIdade.js";
+import { CANAL } from "../canal.js";
 import { gallery } from "./gallery.js";
 /**
  * A PORTA LOCAL DAS PONTES (27/09/2026): gerar no provedor com a chave da
@@ -135,11 +136,26 @@ export const pontesSchema = z.object({
 // ---------------------------------------------------------------------------
 // A chave: lida do ambiente, nunca devolvida.
 // ---------------------------------------------------------------------------
+/**
+ * O valor de uma variável de chave, ou undefined quando não há chave de verdade.
+ * Na extensão do Claude Desktop (.mcpb) a chave chega pelo manifesto como
+ * "${user_config.fal_key}": campo opcional deixado em branco pode chegar vazio
+ * OU como o próprio texto do molde, e o molde não é chave (mandar ele pro
+ * provedor seria um 401 com cara de chave errada).
+ */
+export function valorDeChave(nome) {
+    const valor = process.env[nome]?.trim();
+    if (!valor || valor.length < 8)
+        return undefined;
+    if (/^\$\{[^}]*\}$/.test(valor))
+        return undefined;
+    return valor;
+}
 function segredosConfigurados() {
     const out = new Set();
     for (const nome of NOMES_DE_CHAVE) {
-        const valor = process.env[nome]?.trim();
-        if (!valor || valor.length < 8)
+        const valor = valorDeChave(nome);
+        if (!valor)
             continue;
         out.add(valor);
         // A chave da fal é "id:segredo": um erro que ecoa só o id ainda identifica
@@ -163,9 +179,11 @@ function limpo(valor) {
 }
 function chaveDo(provedor) {
     const { nome, envVar } = BALCOES[provedor];
-    const valor = process.env[envVar]?.trim();
-    if (!valor || valor.length < 8) {
-        throw new Error(`Não achei a ${envVar} nesta máquina. Ponha a chave da ${nome} no "env" do sapiens, no config do seu cliente MCP, e reinicie o cliente: ${ENDERECO_SUAS_CHAVES}. A chave fica no seu computador; nunca mande ela no chat.`);
+    const valor = valorDeChave(envVar);
+    if (!valor) {
+        throw new Error(CANAL === "mcpb"
+            ? `A extensão do Sapiens está sem a chave da ${nome}. No Claude Desktop, abra Configurações, Extensões, Sapiens Sintéticos, cole a chave no campo da ${nome} e salve. Ela fica guardada no seu computador; nunca mande ela no chat.`
+            : `Não achei a ${envVar} nesta máquina. Ponha a chave da ${nome} no "env" do sapiens, no config do seu cliente MCP, e reinicie o cliente: ${ENDERECO_SUAS_CHAVES}. A chave fica no seu computador; nunca mande ela no chat.`);
     }
     return valor;
 }
@@ -728,16 +746,15 @@ async function status(args) {
 function balcoes() {
     return {
         regra: "A chave mora no env do config do seu cliente MCP, nesta máquina, e sai daqui só pro provedor. A casa não recebe, não guarda e não vê. Gerar com a sua chave custa zero em Sinapses: você paga o preço do provedor, sem margem da casa.",
-        balcoes: Object.keys(BALCOES).map((k) => {
-            const v = process.env[BALCOES[k].envVar]?.trim();
-            return {
-                provedor: k,
-                nome: BALCOES[k].nome,
-                variavel: BALCOES[k].envVar,
-                configurada: Boolean(v && v.length >= 8),
-            };
-        }),
-        comoConfigurar: `No config do cliente MCP, no bloco do sapiens: "env": { "FAL_KEY": "<sua chave da fal>", "KIE_API_KEY": "<sua chave da Kie>" }. Depois reinicie o cliente. Passo a passo por cliente: ${ENDERECO_SUAS_CHAVES}`,
+        balcoes: Object.keys(BALCOES).map((k) => ({
+            provedor: k,
+            nome: BALCOES[k].nome,
+            variavel: BALCOES[k].envVar,
+            configurada: Boolean(valorDeChave(BALCOES[k].envVar)),
+        })),
+        comoConfigurar: CANAL === "mcpb"
+            ? "Na extensão do Claude Desktop: Configurações, Extensões, Sapiens Sintéticos. Os campos da fal e da Kie ficam ali, e o que você colar fica guardado no seu computador."
+            : `No config do cliente MCP, no bloco do sapiens: "env": { "FAL_KEY": "<sua chave da fal>", "KIE_API_KEY": "<sua chave da Kie>" }. Depois reinicie o cliente. No Claude Desktop, a extensão (.mcpb) põe a chave num campo, sem editar config. Passo a passo por cliente: ${ENDERECO_SUAS_CHAVES}`,
         ondeAcharOModelo: "fal: o id do endpoint na página do modelo em fal.ai/models (ex: 'fal-ai/flux/dev'). Kie: o 'model' da página do modelo no Market da Kie. O input é o corpo que a mesma página descreve.",
         outrosBalcoes: "Sogni, Krea, Magnific, WaveSpeed, Replicate e a própria placa seguem pelo seu harness + sapiens_gallery action=ingest (catálogo em sapiens_meta action=pontes).",
     };

package/dist/version.js

@@ -11,9 +11,12 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
  *
  * Antes disto a versão vivia em 3 literais independentes (package.json + 2 no
  * index.ts) sincronizados por um regex no release.sh — um bump off-path
- * dessincronizava em silêncio. Agora package.json é a única fonte.
+ * dessincronizava em silêncio. Agora package.json é a única fonte (a extensão
+ * recebe o mesmo número, copiado dele no build).
  */
 export function getMcpVersion() {
+    if (typeof __SAPIENS_MCP_VERSION__ === "string")
+        return __SAPIENS_MCP_VERSION__;
     try {
         const pkgPath = path.resolve(__dirname, "..", "package.json");
         const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.79.1",
+  "version": "1.80.0",
   "mcpName": "com.sapiensinteticos/sapiens",
   "description": "MCP server pra operar o Sapiens Sintéticos (sapiensinteticos.com) pelo Claude Code: gerar imagem, escrever artigo, voz, música e mais, na sua conta. Login pelo código de sapiensinteticos.com/conectar-claude.",
   "type": "module",
@@ -55,7 +55,9 @@
     "zod-to-json-schema": "^3.23.5"
   },
   "devDependencies": {
+    "@anthropic-ai/mcpb": "^2.1.2",
     "@types/node": "^22.10.0",
+    "esbuild": "^0.28.2",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2"
   }