aicrm-mcp 0.4.0 → 0.6.0

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { mkdir as mkdir2, readFile as readFile3, writeFile as writeFile2 } from "fs/promises";
+import { mkdir as mkdir2, readFile as readFile4, writeFile as writeFile3 } from "fs/promises";
 import { homedir as homedir3, hostname } from "os";
-import path3 from "path";
+import path4 from "path";
 
 // src/client.ts
 var ApiError = class extends Error {
@@ -16,8 +16,8 @@ var ApiError = class extends Error {
 function normalizeUrl(url) {
   return url.replace(/\/+$/, "").replace(/\/api$/, "");
 }
-async function call(base, method, path4, body, token) {
-  const res = await fetch(`${normalizeUrl(base)}/api${path4}`, {
+async function call(base, method, path5, body, token) {
+  const res = await fetch(`${normalizeUrl(base)}/api${path5}`, {
     method,
     headers: {
       ...body !== void 0 ? { "content-type": "application/json" } : {},
@@ -125,12 +125,13 @@ function askHidden(question) {
 }
 
 // src/server.ts
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 import { homedir as homedir2 } from "os";
-import path2 from "path";
+import path3 from "path";
 
 // ../shared/src/constants.ts
-var ROLES = ["admin", "member"];
+var ROLES = ["admin", "manager", "member", "developer"];
+var LEAD_CHANNELS = ["web", "import", "api"];
 var LEAD_STATUSES = ["open", "won", "lost"];
 var LOST_REASONS = ["price", "timing", "competitor", "no_response", "no_fit", "other"];
 var LEAD_SOURCES = ["inbound", "outbound", "referral", "event", "partner", "other"];
@@ -310,6 +311,11 @@ var updateUserSchema = z.object({
   active: z.boolean().optional(),
   workspaceIds: z.array(id).optional()
 });
+var imageDataUrl = z.string().regex(/^data:image\/(png|jpeg|webp);base64,[A-Za-z0-9+/=]+$/, "Envie uma imagem PNG, JPG ou WebP").max(4e5, "Imagem muito grande (m\xE1x. ~300 KB)");
+var profileUpdateSchema = z.object({
+  /** Photo as a data URL, or null to go back to the initials. */
+  avatar: imageDataUrl.nullable()
+});
 var workspaceSchema = z.object({
   name: z.string().trim().min(1, "Informe um nome").max(80),
   visibility: z.enum(VISIBILITIES).default("all")
@@ -318,19 +324,23 @@ var workspaceUpdateSchema = z.object({
   name: z.string().trim().min(1, "Informe um nome").max(80).optional(),
   visibility: z.enum(VISIBILITIES).optional(),
   hiddenFields: z.array(z.enum(HIDEABLE_FIELDS)).transform((a) => [...new Set(a)]).optional(),
-  /** Raster data URL (PNG/JPEG/WebP), or null to remove. SVG is rejected: the browser rasterizes it first. */
-  logo: z.string().regex(/^data:image\/(png|jpeg|webp);base64,[A-Za-z0-9+/=]+$/, "Envie uma imagem PNG, JPG ou WebP").max(4e5, "Imagem muito grande (m\xE1x. ~300 KB)").nullable().optional()
+  /** Standard fields every new lead must fill. */
+  requiredFields: z.array(z.enum(HIDEABLE_FIELDS)).transform((a) => [...new Set(a)]).optional(),
+  /** Raster data URL, or null to remove. */
+  logo: imageDataUrl.nullable().optional()
 });
 var fieldOptions = z.array(z.string().trim().min(1).max(60)).max(100, "No m\xE1ximo 100 op\xE7\xF5es").transform((o) => [...new Set(o)]);
 var leadFieldSchema = z.object({
   label: z.string().trim().min(1, "D\xEA um nome ao campo").max(60),
   type: z.enum(CUSTOM_FIELD_TYPES),
-  options: fieldOptions.default([])
+  options: fieldOptions.default([]),
+  required: z.boolean().default(false)
 }).refine((f) => f.type !== "select" || f.options.length > 0, { message: "Adicione pelo menos uma op\xE7\xE3o", path: ["options"] });
 var leadFieldUpdateSchema = z.object({
   label: z.string().trim().min(1).max(60).optional(),
   options: fieldOptions.optional(),
-  position: z.number().optional()
+  position: z.number().optional(),
+  required: z.boolean().optional()
 });
 var customInput = z.record(z.string().uuid(), z.union([z.string().max(2e3), z.number(), z.boolean(), z.null()]));
 var importTargetSchema = z.custom(
@@ -381,7 +391,7 @@ var leadInputSchema = z.object({
   expectedCloseAt: dateStr.nullish(),
   custom: customInput.optional()
 });
-var leadUpdateSchema = leadInputSchema.omit({ funnelId: true, stageId: true }).partial();
+var leadUpdateSchema = leadInputSchema.omit({ funnelId: true, stageId: true }).extend({ valueCents: z.number().int().min(0).max(1e13) }).partial();
 var moveLeadSchema = z.object({
   funnelId: id.optional(),
   stageId: id
@@ -407,6 +417,8 @@ var leadQuerySchema = z.object({
   status: z.enum(LEAD_STATUSES).optional(),
   q: z.string().max(120).optional(),
   filter: z.enum(["mine", "stale", "no_next_step"]).optional(),
+  /** How leads got in: typed, imported or through the API. */
+  createdVia: z.enum(LEAD_CHANNELS).optional(),
   limit: z.coerce.number().int().min(1).max(1e3).default(500)
 });
 var bulkLeadSchema = z.object({
@@ -415,6 +427,9 @@ var bulkLeadSchema = z.object({
   stageId: id.optional(),
   funnelId: id.optional()
 });
+var bulkDeleteSchema = z.object({
+  leadIds: z.array(id).min(1).max(1e3)
+});
 var importSchema = z.object({
   funnelId: id,
   stageId: id,
@@ -440,6 +455,11 @@ var importSchema = z.object({
     id: id.optional(),
     name: z.string().trim().min(1).max(80),
     columns: z.record(z.string().max(200), importTargetSchema)
+  }).optional(),
+  /** Where the data came from, kept in the lead's history so people can see e.g. which column filled "Valor". */
+  origin: z.object({
+    fileName: z.string().max(200).optional(),
+    valueColumn: z.string().max(200).optional()
   }).optional()
 });
 var commissionTierSchema = z.object({
@@ -471,6 +491,64 @@ var tvLinkSchema = z.object({
   funnelId: id,
   name: z.string().trim().min(1).max(80)
 });
+var API_KEY_KINDS = ["secret", "publishable"];
+var API_KEY_MODES = ["live", "test"];
+var origin = z.string().trim().min(1).max(200).transform((v, ctx2) => {
+  try {
+    return new URL(/^[a-z]+:\/\//i.test(v) ? v : `https://${v}`).origin;
+  } catch {
+    ctx2.addIssue({ code: "custom", message: `Dom\xEDnio inv\xE1lido: ${v}` });
+    return z.NEVER;
+  }
+});
+var apiKeyCreateSchema = z.object({
+  name: z.string().trim().min(1, "D\xEA um nome para a chave").max(60),
+  kind: z.enum(API_KEY_KINDS),
+  mode: z.enum(API_KEY_MODES),
+  /** Workspaces the key reaches (secret keys). Empty = every workspace the creator reaches. */
+  workspaceIds: z.array(id).default([]),
+  /** The only funnel a publishable key creates leads in. */
+  funnelId: id.optional(),
+  /** Sites allowed to use a publishable key. Empty = any site. */
+  allowedOrigins: z.array(origin).max(20).default([])
+}).refine((k) => k.kind !== "publishable" || k.funnelId, { message: "Escolha o funil onde a chave do site cria leads", path: ["funnelId"] });
+var apiScalar = z.union([z.string().max(2e3), z.number(), z.boolean(), z.null()]);
+var apiText = (max) => z.string().trim().max(max).nullish();
+var apiLeadFields = {
+  name: z.string().trim().min(1, "Informe o nome").max(160),
+  email: z.string().trim().toLowerCase().email("Email inv\xE1lido").max(200).nullish().or(z.literal("").transform(() => null)),
+  phone: apiText(40),
+  company: apiText(160),
+  title: apiText(120),
+  value: z.union([z.number().min(0).max(1e11), z.string().max(40)]).nullish(),
+  source: z.enum(LEAD_SOURCES).nullish(),
+  owner: z.string().trim().toLowerCase().email("Use o email de quem vai cuidar do lead").nullish(),
+  nextStep: apiText(200),
+  nextStepAt: dateStr.nullish(),
+  expectedCloseAt: dateStr.nullish(),
+  /** Custom fields by label ("Cidade") or id. */
+  fields: z.record(z.string().max(100), apiScalar).optional(),
+  /** Free extra data (UTMs, landing page…), at most ~8 KB. */
+  metadata: z.record(z.string().max(100), z.unknown()).refine((m) => JSON.stringify(m).length <= 8e3, "metadata muito grande (m\xE1x. 8 KB)").optional()
+};
+var apiLeadCreateSchema = z.object({
+  /** Funnel by name or id. Publishable keys may leave it out: they always use their own funnel. */
+  funnel: z.string().trim().min(1).max(120).optional(),
+  /** Stage by name or id; defaults to the first stage. */
+  stage: z.string().trim().max(120).optional(),
+  /** Only needed when two workspaces have a funnel with the same name. */
+  workspace: z.string().trim().max(120).optional(),
+  /** Id of the lead in your system: sending it again updates the same lead. */
+  externalId: z.string().trim().min(1).max(200).optional(),
+  ...apiLeadFields
+});
+var apiLeadUpdateSchema = z.object({
+  ...apiLeadFields,
+  name: apiLeadFields.name.optional(),
+  stage: z.string().trim().max(120).optional(),
+  status: z.enum(LEAD_STATUSES).optional(),
+  lostReason: z.enum(LOST_REASONS).optional()
+}).refine((u) => u.status !== "lost" || u.lostReason, { message: "Informe lostReason ao marcar como perdido", path: ["lostReason"] });
 var distributionPauseSchema = z.object({
   funnelId: id,
   userId: id
@@ -632,6 +710,31 @@ function guessFieldType(samples) {
   return { type: "text", options: [] };
 }
 
+// ../shared/src/api-errors.ts
+var API_ERROR_HELP = {
+  missing_api_key: 'Mande a chave no cabe\xE7alho: Authorization: Bearer aicrm_sk_\u2026. Com o SDK, basta new AICRM("sua-chave").',
+  invalid_api_key: "A chave est\xE1 errada ou foi revogada. Copie de novo ou gere uma nova em Chaves de API.",
+  secret_key_in_browser: "Chaves secretas n\xE3o podem ir para o site, porque qualquer visitante veria a chave. Crie uma chave do tipo \u201CNo site\u201D (aicrm_pk_) e use ela no navegador.",
+  origin_not_allowed: "Inclua este dom\xEDnio na chave do site, ou crie uma chave nova com o dom\xEDnio certo (ex.: https://seusite.com.br).",
+  publishable_key_not_allowed: "Chaves do site s\xF3 criam leads. Para ler ou alterar, use uma chave secreta no seu servidor.",
+  funnel_required: 'Diga em qual funil o lead entra: { funnel: "Vendas" }. Os nomes est\xE3o em Funis e campos.',
+  funnel_not_found: "Confira o nome do funil em Funis e campos. Mai\xFAsculas e acentos n\xE3o importam. Se o funil \xE9 de outro workspace, a chave precisa ter acesso a ele.",
+  funnel_not_allowed: "A chave do site s\xF3 cria leads no funil dela. Tire o campo funnel ou use a chave certa.",
+  ambiguous_funnel: 'H\xE1 dois funis com esse nome em workspaces diferentes. Mande tamb\xE9m workspace: "Nome do workspace", ou use o id do funil.',
+  workspace_not_found: "Confira o nome do workspace em Funis e campos.",
+  stage_not_found: "Use um dos nomes de etapa listados na mensagem, ou tire o campo stage para cair na primeira etapa.",
+  field_not_found: "Use o nome do campo exatamente como aparece em Funis e campos (mai\xFAsculas e acentos n\xE3o importam).",
+  required_field_missing: "O admin marcou este campo como obrigat\xF3rio. Mande o valor dele no lead.",
+  invalid_field: "O valor n\xE3o combina com o tipo do campo. Veja o exemplo na mensagem.",
+  invalid_value: 'Mande o valor em reais, como n\xFAmero (1500) ou texto ("R$ 1.500,00").',
+  invalid_request: "Algum dado veio no formato errado. A mensagem diz qual.",
+  owner_not_found: "Use o email de algu\xE9m do time que trabalha nesse workspace, ou tire o owner para a distribui\xE7\xE3o decidir.",
+  lead_not_found: "A API s\xF3 enxerga leads criados pela API, e com uma chave do mesmo modo (teste ou produ\xE7\xE3o).",
+  rate_limited: "Muitas requisi\xE7\xF5es em pouco tempo. Espere um minuto. Para cargas grandes, importe uma planilha.",
+  not_found: "Essa rota n\xE3o existe. Veja as rotas em Documenta\xE7\xE3o.",
+  internal_error: "Erro do nosso lado. Tente de novo em instantes."
+};
+
 // ../shared/src/stats/calendar.ts
 function toDateStr(d) {
   return d.toISOString().slice(0, 10);
@@ -736,7 +839,7 @@ function stageAge(stageEnteredAt, limitDays, today, timeZone) {
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import Papa from "papaparse";
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 
 // src/lib.ts
 var norm = (s) => s.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().trim();
@@ -843,7 +946,7 @@ var withApi = (fn) => async (args) => {
   try {
     return await fn(apiFor(creds), args);
   } catch (e) {
-    const msg = e instanceof ApiError && e.status === 401 ? "Sess\xE3o expirada ou revogada. Rode: npx -y aicrm-mcp login" : e instanceof ApiError && e.status === 403 ? `${e.message} (seu usu\xE1rio n\xE3o tem permiss\xE3o para isso \u2014 pe\xE7a a um admin)` : e.message;
+    const msg = e instanceof ApiError && e.status === 401 ? "Sess\xE3o expirada ou revogada. Rode: npx -y aicrm-mcp login" : e instanceof ApiError && e.status === 403 ? `${e.message} (seu usu\xE1rio n\xE3o tem permiss\xE3o para isso \u2014 pe\xE7a a um admin ou Master)` : e.message;
     return { ...text(`Erro: ${msg}`), isError: true };
   }
 };
@@ -882,8 +985,301 @@ function handoffBody(c, source, a) {
 }
 var MONTH = /^\d{4}-\d{2}$/;
 
-// src/tools/admin.ts
+// src/tools/integrate.ts
 import { z as z2 } from "zod";
+
+// src/env-file.ts
+import { appendFile, readFile as readFile2, stat, writeFile as writeFile2 } from "fs/promises";
+import path2 from "path";
+function isEnvFileName(file) {
+  const base = path2.basename(file);
+  return /^\.env(\.[\w.-]+)?$/.test(base) || /\.env$/.test(base);
+}
+var escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function upsertEnv(content, vars) {
+  let out = content;
+  const replaced = [];
+  for (const [key, value] of Object.entries(vars)) {
+    const line = new RegExp(`^[ \\t]*(export[ \\t]+)?${escapeRe(key)}[ \\t]*=.*$`, "m");
+    if (line.test(out)) {
+      out = out.replace(line, `${key}=${value}`);
+      replaced.push(key);
+    } else {
+      out = `${out}${out && !out.endsWith("\n") ? "\n" : ""}${key}=${value}
+`;
+    }
+  }
+  return { content: out, replaced };
+}
+function gitignoreCovers(gitignore, fileName) {
+  return gitignore.split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith("#") && !l.startsWith("!")).some((l) => {
+    const p = l.replace(/^\//, "").replace(/\/$/, "");
+    if (p === fileName) return true;
+    if (!p.includes("*")) return false;
+    return new RegExp(`^${p.split("*").map(escapeRe).join(".*")}$`).test(fileName);
+  });
+}
+var exists = (p) => stat(p).then(() => true, () => false);
+async function gitRoot(dir2) {
+  let d = dir2;
+  for (; ; ) {
+    if (await exists(path2.join(d, ".git"))) return d;
+    const up = path2.dirname(d);
+    if (up === d) return null;
+    d = up;
+  }
+}
+async function writeEnvVars(file, vars, cwd = process.cwd()) {
+  const target = path2.resolve(cwd, file);
+  if (!isEnvFileName(target)) throw new Error(`"${file}" n\xE3o parece um arquivo .env. Use algo como .env ou .env.local.`);
+  if (!await exists(path2.dirname(target))) throw new Error(`A pasta ${path2.dirname(target)} n\xE3o existe.`);
+  const created = !await exists(target);
+  const current = created ? "" : await readFile2(target, "utf8");
+  const { content, replaced } = upsertEnv(current, vars);
+  await writeFile2(target, content, created ? { mode: 384 } : void 0);
+  const name = path2.basename(target);
+  const root = await gitRoot(path2.dirname(target));
+  let gitignore = "Fora de um reposit\xF3rio git: nada a ignorar.";
+  if (root) {
+    const candidates = [path2.join(path2.dirname(target), ".gitignore"), path2.join(root, ".gitignore")];
+    let covered = false;
+    for (const g of candidates) if (await exists(g)) covered ||= gitignoreCovers(await readFile2(g, "utf8"), name);
+    if (covered) gitignore = `${name} j\xE1 est\xE1 no .gitignore.`;
+    else {
+      const g = path2.join(path2.dirname(target), ".gitignore");
+      const before = await exists(g) ? await readFile2(g, "utf8") : "";
+      await appendFile(g, `${before && !before.endsWith("\n") ? "\n" : ""}${name}
+`);
+      gitignore = `Adicionei ${name} ao ${path2.relative(cwd, g) || ".gitignore"} para a chave n\xE3o ir para o git.`;
+    }
+  }
+  return { path: target, created, replaced, gitignore };
+}
+
+// src/tools/integrate.ts
+var SDK_DEFAULT_URL = "https://api.aicrm.dev";
+var schema = (api) => api.get("/integrations/schema");
+function pickFunnel2(workspaces, ref, workspaceRef) {
+  const wss = workspaceRef ? [resolve(workspaces, workspaceRef, "Workspace")] : workspaces;
+  const funnels = wss.flatMap((w) => w.funnels);
+  if (!funnels.length) throw new Error("Voc\xEA n\xE3o tem acesso a nenhum funil. Pe\xE7a a um admin para incluir voc\xEA em um workspace com funil.");
+  return ref ? resolve(funnels, ref, "Funil") : funnels[0];
+}
+var describe = (f) => ({
+  funnel: f.name,
+  funnel_id: f.id,
+  workspace: f.workspace.name,
+  stages: f.stages.map((s) => s.name),
+  default_stage: f.stages[0]?.name ?? null,
+  standard_fields: f.fields.standard.map((x) => ({ key: x.key, label: x.label, type: x.type, required: x.required, ...x.options?.length ? { options: x.options } : {} })),
+  custom_fields: f.fields.custom.map((x) => ({ key: `fields.${x.key}`, label: x.label, type: x.type, required: x.required, ...x.options?.length ? { options: x.options } : {} })),
+  example_payload: { ...f.example, funnel: f.name }
+});
+var help = (code) => code ? API_ERROR_HELP[code] ?? null : null;
+var logOut = (l) => ({
+  id: l.id,
+  when: l.createdAt,
+  request: `${l.method} ${l.path}`,
+  status: l.status,
+  key: l.keyName ? `${l.keyName} (${l.keyMode === "test" ? "teste" : "produ\xE7\xE3o"})` : null,
+  ms: l.durationMs,
+  ...l.errorCode ? { error_code: l.errorCode, how_to_fix: help(l.errorCode) } : {}
+});
+async function createKeyIntoEnv(api, a, cwd = process.cwd()) {
+  const kind = a.kind ?? "secret";
+  const mode = a.mode ?? "test";
+  const envFile = a.env_file ?? ".env";
+  if (mode === "live" && !a.confirm_live)
+    throw new Error("Chave de produ\xE7\xE3o cria leads de verdade para o time. Confirme com a pessoa e chame de novo com confirm_live: true.");
+  if (!isEnvFileName(envFile)) throw new Error(`"${envFile}" n\xE3o parece um arquivo .env. Use algo como .env ou .env.local.`);
+  const envVar = a.env_var ?? (kind === "secret" ? "AICRM_API_KEY" : "AICRM_PUBLISHABLE_KEY");
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(envVar)) throw new Error(`Nome de vari\xE1vel inv\xE1lido: ${envVar}`);
+  const [workspaces, config] = await Promise.all([schema(api), api.get("/integrations/config")]);
+  const body = { name: a.name ?? (kind === "secret" ? "Servidor" : "Site"), kind, mode };
+  if (kind === "publishable") {
+    body.funnelId = pickFunnel2(workspaces, a.funnel).id;
+    body.allowedOrigins = a.allowed_origins ?? [];
+  } else if (a.workspaces?.length) body.workspaceIds = a.workspaces.map((w) => resolve(workspaces, w, "Workspace").id);
+  const key = await api.post("/integrations/keys", body);
+  const vars = { [envVar]: key.token };
+  const url = config.apiUrl !== SDK_DEFAULT_URL ? config.apiUrl : null;
+  if (url && kind === "secret") vars.AICRM_API_URL = url;
+  try {
+    const written = await writeEnvVars(envFile, vars, cwd);
+    return {
+      key: { name: key.name, kind, mode, prefix: `${key.prefix}\u2026` },
+      env_file: written.path,
+      variables: Object.keys(vars),
+      ...written.replaced.length ? { replaced: written.replaced } : {},
+      gitignore: written.gitignore,
+      ...url && kind === "publishable" ? { api_url: url } : {},
+      how_to_use: kind === "secret" ? `No servidor: new AICRM(${envVar === "AICRM_API_KEY" ? "" : `process.env.${envVar}`}) \u2014 o SDK l\xEA ${envVar === "AICRM_API_KEY" ? "AICRM_API_KEY" : "a chave do argumento"}${url ? " e AICRM_API_URL" : ""} sozinho. Nunca leve esta chave para o c\xF3digo do navegador.` : `No site: new AICRM(<${envVar}>${url ? `, { baseUrl: "${url}" }` : ""}). Em Vite use o prefixo VITE_, em Next.js NEXT_PUBLIC_ (passe env_var). A chave p\xFAblica s\xF3 cria leads no funil dela.`,
+      note: "A chave completa foi gravada s\xF3 no arquivo; ela n\xE3o aparece nesta conversa."
+    };
+  } catch (e) {
+    await api.del(`/integrations/keys/${key.id}`).catch(() => {
+    });
+    throw e;
+  }
+}
+function registerIntegrationTools(server) {
+  server.registerTool(
+    "get_integration_schema",
+    {
+      title: "Funis, etapas e campos para integrar",
+      description: "Mostra para onde os leads podem ir: workspaces, funis, etapas e os campos de cada lead (padr\xE3o e personalizados), com quais s\xE3o obrigat\xF3rios e um payload de exemplo pronto para leads.create(). Use antes de escrever o c\xF3digo da integra\xE7\xE3o.",
+      inputSchema: { funnel: z2.string().optional().describe("Nome ou id do funil (sem ele, lista todos)"), workspace: z2.string().optional() },
+      annotations: { readOnlyHint: true }
+    },
+    withApi(async (api, a) => {
+      const wss = await schema(api);
+      if (a.funnel) return text(describe(pickFunnel2(wss, a.funnel, a.workspace)));
+      return text({
+        workspaces: wss.map((w) => ({ workspace: w.name, funnels: w.funnels.map(describe) })),
+        tips: [
+          "Funil, etapa e campos aceitam nome ou id; mai\xFAsculas e acentos n\xE3o importam.",
+          'Campos personalizados v\xE3o em fields, pelo nome: fields: { Cidade: "Recife" }. Dinheiro em reais.',
+          "Use externalId com o id do lead no sistema da pessoa: reenvios atualizam em vez de duplicar."
+        ]
+      });
+    })
+  );
+  server.registerTool(
+    "create_api_key",
+    {
+      title: "Criar chave de API no .env",
+      description: "Cria uma chave da API p\xFAblica e grava direto no arquivo .env do projeto (e garante que o .env est\xE1 no .gitignore). A chave completa nunca volta para voc\xEA: s\xF3 o prefixo. secret (aicrm_sk_) \xE9 para o servidor; publishable (aicrm_pk_) \xE9 para o navegador e s\xF3 cria leads num funil. Comece com mode test. Chave de produ\xE7\xE3o (mode live) s\xF3 com o ok expl\xEDcito da pessoa e confirm_live: true.",
+      inputSchema: {
+        name: z2.string().max(60).optional().describe("Ex.: Checkout, Site institucional"),
+        kind: z2.enum(["secret", "publishable"]).optional().describe("secret (padr\xE3o) no servidor; publishable no navegador"),
+        mode: z2.enum(["test", "live"]).optional().describe("test (padr\xE3o): leads com selo Teste, fora das metas"),
+        funnel: z2.string().optional().describe("Obrigat\xF3rio para publishable: o \xFAnico funil onde a chave cria leads"),
+        workspaces: z2.array(z2.string()).optional().describe("Workspaces que a chave secreta alcan\xE7a (padr\xE3o: todos os seus)"),
+        allowed_origins: z2.array(z2.string()).optional().describe('Dom\xEDnios que podem usar a chave publishable, ex.: ["seusite.com.br"]'),
+        env_file: z2.string().optional().describe("Arquivo .env relativo \xE0 pasta do projeto (padr\xE3o .env)"),
+        env_var: z2.string().optional().describe("Nome da vari\xE1vel (padr\xE3o AICRM_API_KEY ou AICRM_PUBLISHABLE_KEY)"),
+        confirm_live: z2.boolean().optional().describe("true s\xF3 depois que a pessoa confirmou que quer uma chave de produ\xE7\xE3o")
+      }
+    },
+    withApi(async (api, a) => text(await createKeyIntoEnv(api, a)))
+  );
+  server.registerTool(
+    "send_test_lead",
+    {
+      title: "Mandar um lead de teste",
+      description: "Manda o payload de exemplo do funil com a sua chave de teste mais recente, como o c\xF3digo faria, e mostra em que etapa o lead caiu (ou o erro e como corrigir). \xDAtil para conferir a estrutura antes e depois de escrever o c\xF3digo.",
+      inputSchema: { funnel: z2.string().optional(), workspace: z2.string().optional() }
+    },
+    withApi(async (api, a) => {
+      const funnel = pickFunnel2(await schema(api), a.funnel, a.workspace);
+      const r = await api.post(
+        "/integrations/test-event",
+        { funnelId: funnel.id }
+      );
+      if (r.status >= 300) return text({ ok: false, status: r.status, error: r.response.error, how_to_fix: help(r.response.error?.code ?? null) });
+      return text({ ok: true, landed_in: `${r.response.funnel?.name} \u203A ${r.response.stage?.name}`, sent: r.request, lead: r.response });
+    })
+  );
+  server.registerTool(
+    "list_api_logs",
+    {
+      title: "Logs da API",
+      description: "\xDAltimas chamadas \xE0 API feitas com as suas chaves: status, rota e, nos erros, o c\xF3digo e como corrigir. Rode depois de testar o c\xF3digo para ver se o lead entrou ou por que falhou.",
+      inputSchema: { errors_only: z2.boolean().optional(), limit: z2.number().int().min(1).max(100).optional() },
+      annotations: { readOnlyHint: true }
+    },
+    withApi(async (api, a) => {
+      const logs = await api.get(`/integrations/logs?limit=${a.limit ?? 20}${a.errors_only ? "&errors=1" : ""}`);
+      return text(logs.length ? logs.map(logOut) : "Nenhuma chamada ainda. Rode o c\xF3digo (ou send_test_lead) e veja de novo.");
+    })
+  );
+  server.registerTool(
+    "get_api_log",
+    {
+      title: "Detalhe de uma chamada",
+      description: "O que foi enviado e o que a API respondeu numa chamada (id vem de list_api_logs).",
+      inputSchema: { id: z2.string() },
+      annotations: { readOnlyHint: true }
+    },
+    withApi(async (api, a) => {
+      const l = await api.get(`/integrations/logs/${a.id}`);
+      return text({ ...logOut(l), sent: l.requestBody, response: l.responseBody });
+    })
+  );
+  server.registerTool(
+    "get_integration_status",
+    {
+      title: "Onde est\xE1 a integra\xE7\xE3o",
+      description: "Mostra o que j\xE1 foi feito (chave de teste, primeiro lead, chave de produ\xE7\xE3o) e o pr\xF3ximo passo.",
+      inputSchema: {},
+      annotations: { readOnlyHint: true }
+    },
+    withApi(async (api) => {
+      const s = await api.get("/integrations/status");
+      const next = !s.hasTestKey ? "Crie uma chave de teste com create_api_key." : !s.firstLead ? "Escreva o c\xF3digo com o SDK @aicrm/sdk e rode; confira em list_api_logs." : !s.hasLiveKey ? "Quando a pessoa aprovar, crie a chave de produ\xE7\xE3o (create_api_key mode live) e troque no ambiente de produ\xE7\xE3o." : "Integra\xE7\xE3o completa. Se quiser, limpe os leads de teste com clear_test_leads.";
+      return text({
+        test_key: s.hasTestKey,
+        first_lead: s.firstLead ? `${s.firstLead.name} em ${s.firstLead.funnelName} \u203A ${s.firstLead.stageName}${s.firstLead.isTest ? " (teste)" : ""}` : null,
+        live_key: s.hasLiveKey,
+        last_request: s.lastRequest ? logOut(s.lastRequest) : null,
+        next_step: next
+      });
+    })
+  );
+  server.registerTool(
+    "list_api_keys",
+    {
+      title: "Chaves de API",
+      description: "Suas chaves ativas (o admin v\xEA as da empresa), com tipo, modo e \xFAltimo uso. S\xF3 o prefixo: a chave completa s\xF3 aparece ao criar.",
+      inputSchema: {},
+      annotations: { readOnlyHint: true }
+    },
+    withApi(
+      async (api) => text(
+        (await api.get("/integrations/keys")).map((k) => ({
+          name: k.name,
+          kind: k.kind,
+          mode: k.mode,
+          prefix: `${k.prefix}\u2026`,
+          last_used: k.lastUsedAt,
+          ...k.kind === "publishable" ? { allowed_origins: k.allowedOrigins.length ? k.allowedOrigins : "qualquer site" } : {},
+          ...k.createdByName ? { created_by: k.createdByName } : {}
+        }))
+      )
+    )
+  );
+  server.registerTool(
+    "revoke_api_key",
+    {
+      title: "Revogar chave de API",
+      description: "Desativa uma chave na hora: o sistema que a usa para de mandar leads. Pe\xE7a confirma\xE7\xE3o antes.",
+      inputSchema: { key: z2.string().describe("Nome ou prefixo da chave") },
+      annotations: { destructiveHint: true }
+    },
+    withApi(async (api, a) => {
+      const keys = await api.get("/integrations/keys");
+      const k = keys.find((x) => norm(x.prefix).startsWith(norm(a.key.replace(/…$/, "")))) ?? resolve(keys, a.key, "Chave");
+      await api.del(`/integrations/keys/${k.id}`);
+      return text(`Chave ${k.name} (${k.prefix}\u2026) revogada.`);
+    })
+  );
+  server.registerTool(
+    "clear_test_leads",
+    {
+      title: "Apagar leads de teste",
+      description: "Tira do funil os leads criados com as suas chaves de teste. Leads reais n\xE3o s\xE3o afetados. Pe\xE7a confirma\xE7\xE3o antes.",
+      inputSchema: {},
+      annotations: { destructiveHint: true }
+    },
+    withApi(async (api) => {
+      const r = await api.del("/integrations/test-leads");
+      return text(r.deleted ? `${r.deleted} lead(s) de teste apagados.` : "N\xE3o havia leads de teste.");
+    })
+  );
+}
+
+// src/tools/admin.ts
+import { z as z3 } from "zod";
 function registerAdminTools(server) {
   server.registerTool(
     "get_setup_status",
@@ -909,7 +1305,7 @@ function registerAdminTools(server) {
     "list_tv_links",
     {
       title: "Links do modo TV",
-      description: "Lista os links ativos do modo TV (dashboard ao vivo sem login), s\xF3 admins.",
+      description: "Lista os links ativos do modo TV (dashboard ao vivo sem login), s\xF3 admins e Masters (dos funis deles).",
       inputSchema: {},
       annotations: { readOnlyHint: true }
     },
@@ -921,8 +1317,8 @@ function registerAdminTools(server) {
     "create_tv_link",
     {
       title: "Criar link do modo TV",
-      description: "Cria um link do dashboard ao vivo de um funil para abrir numa TV, sem login (s\xF3 admins). Quem tiver o link v\xEA o dashboard \u2014 trate como senha.",
-      inputSchema: { name: z2.string().min(1).max(80).describe("Ex.: TV da sala de vendas"), funnel: z2.string().optional(), workspace: z2.string().optional() }
+      description: "Cria um link do dashboard ao vivo de um funil para abrir numa TV, sem login (admins e Masters). Quem tiver o link v\xEA o dashboard \u2014 trate como senha.",
+      inputSchema: { name: z3.string().min(1).max(80).describe("Ex.: TV da sala de vendas"), funnel: z3.string().optional(), workspace: z3.string().optional() }
     },
     withApi(async (api, a) => {
       const funnel = pickFunnel(await ctx(api), a.funnel, a.workspace);
@@ -934,8 +1330,8 @@ function registerAdminTools(server) {
     "revoke_tv_link",
     {
       title: "Revogar link do modo TV",
-      description: "Desativa um link do modo TV (s\xF3 admins); a TV que usava o link para de mostrar o dashboard.",
-      inputSchema: { link: z2.string().describe("Nome do link") },
+      description: "Desativa um link do modo TV (admins e Masters); a TV que usava o link para de mostrar o dashboard.",
+      inputSchema: { link: z3.string().describe("Nome do link") },
       annotations: { destructiveHint: true }
     },
     withApi(async (api, a) => {
@@ -968,7 +1364,7 @@ function registerAdminTools(server) {
     {
       title: "Revogar token de API",
       description: "Revoga um token de API seu. Se for o token que este MCP est\xE1 usando, a conex\xE3o para de funcionar at\xE9 um novo login.",
-      inputSchema: { token_id: z2.string().uuid() },
+      inputSchema: { token_id: z3.string().uuid() },
       annotations: { destructiveHint: true }
     },
     withApi(async (api, a) => {
@@ -979,9 +1375,9 @@ function registerAdminTools(server) {
 }
 
 // src/tools/distribution.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var br = (d) => `${d.slice(8, 10)}/${d.slice(5, 7)}`;
-var why = (b) => b.reason === "manual" ? "pausado por um admin" : `sem nenhuma a\xE7\xE3o no funil em ${b.day ? br(b.day) : "um dia \xFAtil"}`;
+var why = (b) => b.reason === "manual" ? "pausado pelo Master ou admin" : `sem nenhuma a\xE7\xE3o no funil em ${b.day ? br(b.day) : "um dia \xFAtil"}`;
 var describePlan = (funnel, p) => ({
   funnel,
   automatic_distribution: p.enabled ? "ligada" : "desligada (ligue com update_funnel auto_assign=true)",
@@ -994,13 +1390,13 @@ var describePlan = (funnel, p) => ({
   not_receiving: p.blocked.map((b) => ({ seller: b.name, why: why(b) })),
   leads_without_owner: p.unowned
 });
-var funnelArgs = { funnel: z3.string().optional(), workspace: z3.string().optional() };
+var funnelArgs = { funnel: z4.string().optional(), workspace: z4.string().optional() };
 function registerDistributionTools(server) {
   server.registerTool(
     "get_distribution",
     {
       title: "Distribui\xE7\xE3o de leads",
-      description: "Mostra para quem v\xE3o os pr\xF3ximos leads sem vendedor do funil, a parte de cada um e o motivo (quem fecha mais recebe mais; todos recebem um m\xEDnimo), quem n\xE3o est\xE1 recebendo (pausado por admin ou um dia \xFAtil sem nenhuma a\xE7\xE3o no funil) e quantos leads esperam vendedor. Sem funil, lista os bloqueios de todos os funis. S\xF3 admins.",
+      description: "Mostra para quem v\xE3o os pr\xF3ximos leads sem vendedor do funil, a parte de cada um e o motivo (quem fecha mais recebe mais; todos recebem um m\xEDnimo), quem n\xE3o est\xE1 recebendo (pausado por Master/admin ou um dia \xFAtil sem nenhuma a\xE7\xE3o no funil) e quantos leads esperam vendedor. Sem funil, lista os bloqueios de todos os funis. S\xF3 admins e Masters.",
       inputSchema: funnelArgs,
       annotations: { readOnlyHint: true }
     },
@@ -1019,8 +1415,8 @@ function registerDistributionTools(server) {
     "release_seller",
     {
       title: "Liberar vendedor",
-      description: "Volta a mandar leads novos para um vendedor que foi bloqueado (dia sem a\xE7\xE3o) ou pausado no funil. S\xF3 admins.",
-      inputSchema: { seller: z3.string().describe("Nome ou email"), ...funnelArgs }
+      description: "Volta a mandar leads novos para um vendedor que foi bloqueado (dia sem a\xE7\xE3o) ou pausado no funil. S\xF3 admins e Masters.",
+      inputSchema: { seller: z4.string().describe("Nome ou email"), ...funnelArgs }
     },
     withApi(async (api, a) => {
       const c = await ctx(api);
@@ -1034,8 +1430,8 @@ function registerDistributionTools(server) {
     "pause_seller",
     {
       title: "Pausar vendedor",
-      description: "Para de mandar leads novos para um vendedor no funil (ex.: f\xE9rias), at\xE9 release_seller. Os leads que ele j\xE1 tem continuam com ele. S\xF3 admins. Confirme com a pessoa antes.",
-      inputSchema: { seller: z3.string().describe("Nome ou email"), ...funnelArgs }
+      description: "Para de mandar leads novos para um vendedor no funil (ex.: f\xE9rias), at\xE9 release_seller. Os leads que ele j\xE1 tem continuam com ele. S\xF3 admins e Masters. Confirme com a pessoa antes.",
+      inputSchema: { seller: z4.string().describe("Nome ou email"), ...funnelArgs }
     },
     withApi(async (api, a) => {
       const c = await ctx(api);
@@ -1049,7 +1445,7 @@ function registerDistributionTools(server) {
     "assign_unowned_leads",
     {
       title: "Distribuir leads sem vendedor",
-      description: "Entrega os leads abertos sem vendedor do funil para o time, na propor\xE7\xE3o da distribui\xE7\xE3o por desempenho (get_distribution). S\xF3 admins.",
+      description: "Entrega os leads abertos sem vendedor do funil para o time, na propor\xE7\xE3o da distribui\xE7\xE3o por desempenho (get_distribution). S\xF3 admins e Masters. Admins e Masters nunca recebem.",
       inputSchema: funnelArgs
     },
     withApi(async (api, a) => {
@@ -1061,7 +1457,7 @@ function registerDistributionTools(server) {
 }
 
 // src/tools/goals.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 var describePlan2 = (p) => ({
   name: p.name,
   kind: p.kind === "percent" ? "% sobre a receita (metas de receita)" : "R$ por unidade (metas de quantidade)",
@@ -1084,9 +1480,9 @@ function registerGoalTools(server) {
       title: "Criar ou alterar plano de comiss\xE3o",
       description: "Cria um plano de comiss\xE3o ou, se j\xE1 existir um com o mesmo nome, substitui as faixas (s\xF3 admins). Cada faixa vale a partir de um % de atingimento da meta e a taxa da faixa alcan\xE7ada vale para tudo (acelerador). kind percent: rate em % da receita (para funis com meta de receita). kind per_unit: rate em reais por unidade (para metas de quantidade).",
       inputSchema: {
-        name: z4.string().min(1).max(80),
-        kind: z4.enum(["percent", "per_unit"]),
-        tiers: z4.array(z4.object({ from_attainment_pct: z4.number().min(0).max(1e3), rate: z4.number().min(0) })).min(1).max(10).describe("Ex.: [{from_attainment_pct: 0, rate: 3}, {from_attainment_pct: 100, rate: 6}]")
+        name: z5.string().min(1).max(80),
+        kind: z5.enum(["percent", "per_unit"]),
+        tiers: z5.array(z5.object({ from_attainment_pct: z5.number().min(0).max(1e3), rate: z5.number().min(0) })).min(1).max(10).describe("Ex.: [{from_attainment_pct: 0, rate: 3}, {from_attainment_pct: 100, rate: 6}]")
       }
     },
     withApi(async (api, a) => {
@@ -1105,7 +1501,7 @@ function registerGoalTools(server) {
     {
       title: "Apagar plano de comiss\xE3o",
       description: "Apaga um plano de comiss\xE3o (s\xF3 admins). As metas que o usavam ficam sem comiss\xE3o.",
-      inputSchema: { plan: z4.string() },
+      inputSchema: { plan: z5.string() },
       annotations: { destructiveHint: true }
     },
     withApi(async (api, a) => {
@@ -1119,7 +1515,7 @@ function registerGoalTools(server) {
     {
       title: "Metas do m\xEAs",
       description: "Mostra a meta de cada vendedor num funil e m\xEAs, e o plano de comiss\xE3o ligado. Para o andamento e a proje\xE7\xE3o, use get_dashboard.",
-      inputSchema: { funnel: z4.string().optional(), workspace: z4.string().optional(), month: z4.string().regex(MONTH).optional().describe("YYYY-MM; padr\xE3o: m\xEAs atual") },
+      inputSchema: { funnel: z5.string().optional(), workspace: z5.string().optional(), month: z5.string().regex(MONTH).optional().describe("YYYY-MM; padr\xE3o: m\xEAs atual") },
       annotations: { readOnlyHint: true }
     },
     withApi(async (api, a) => {
@@ -1146,13 +1542,13 @@ function registerGoalTools(server) {
     "set_goals",
     {
       title: "Definir metas",
-      description: 'Define ou altera a meta de vendedores num funil e m\xEAs (s\xF3 admins). target em reais para funis de receita, ou em unidades (vendas/leads na etapa) nos demais. target 0 remove a meta. Sem commission_plan, mant\xE9m o plano que o m\xEAs j\xE1 usa; commission_plan="none" tira a comiss\xE3o.',
+      description: 'Define ou altera a meta de vendedores num funil e m\xEAs (admins e Masters; s\xF3 admins escolhem o plano de comiss\xE3o). target em reais para funis de receita, ou em unidades (vendas/leads na etapa) nos demais. target 0 remove a meta. Sem commission_plan, mant\xE9m o plano que o m\xEAs j\xE1 usa; commission_plan="none" tira a comiss\xE3o.',
       inputSchema: {
-        targets: z4.array(z4.object({ seller: z4.string().describe("Nome ou email"), target: z4.number().min(0) })).min(1),
-        funnel: z4.string().optional(),
-        workspace: z4.string().optional(),
-        month: z4.string().regex(MONTH).optional().describe("YYYY-MM; padr\xE3o: m\xEAs atual"),
-        commission_plan: z4.string().optional()
+        targets: z5.array(z5.object({ seller: z5.string().describe("Nome ou email"), target: z5.number().min(0) })).min(1),
+        funnel: z5.string().optional(),
+        workspace: z5.string().optional(),
+        month: z5.string().regex(MONTH).optional().describe("YYYY-MM; padr\xE3o: m\xEAs atual"),
+        commission_plan: z5.string().optional()
       }
     },
     withApi(
@@ -1188,14 +1584,14 @@ function registerGoalTools(server) {
 }
 
 // src/tools/leads.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 function registerLeadTools(server) {
   server.registerTool(
     "reopen_lead",
     {
       title: "Reabrir lead",
       description: "Volta um lead ganho ou perdido para aberto, na mesma etapa.",
-      inputSchema: { lead_id: z5.string().uuid() }
+      inputSchema: { lead_id: z6.string().uuid() }
     },
     withApi(async (api, a) => {
       const c = await ctx(api);
@@ -1209,12 +1605,12 @@ function registerLeadTools(server) {
       title: "Enviar lead ganho para outro funil",
       description: "Continua um lead GANHO em outro funil (ex.: de Aquisi\xE7\xE3o para Relacionamento/p\xF3s-venda): cria um lead novo, aberto e ligado ao original, na etapa escolhida (padr\xE3o: a primeira). O lead ganho fica onde est\xE1 e continua contando na meta e na comiss\xE3o. O novo lead copia contato e campos, come\xE7a com valor R$ 0 (informe value se j\xE1 houver nova venda prevista) e mant\xE9m o respons\xE1vel (ou use owner). S\xF3 funciona para leads com status won; cada lead s\xF3 pode continuar uma vez em cada funil.",
       inputSchema: {
-        lead_id: z5.string().uuid().describe("Lead ganho"),
-        funnel: z5.string().describe("Funil onde o cliente continua (nome ou id)"),
-        stage: z5.string().optional().describe("Etapa de entrada (padr\xE3o: a primeira)"),
-        workspace: z5.string().optional().describe("Workspace do funil, se for outro (s\xF3 admins)"),
-        owner: z5.string().optional().describe('Respons\xE1vel no novo funil (nome ou email; "none" = sem respons\xE1vel). Padr\xE3o: o mesmo do lead ganho'),
-        value: z5.number().min(0).optional().describe("Valor em reais no novo funil (padr\xE3o: 0)")
+        lead_id: z6.string().uuid().describe("Lead ganho"),
+        funnel: z6.string().describe("Funil onde o cliente continua (nome ou id)"),
+        stage: z6.string().optional().describe("Etapa de entrada (padr\xE3o: a primeira)"),
+        workspace: z6.string().optional().describe("Workspace do funil, se for outro (s\xF3 admins e Masters)"),
+        owner: z6.string().optional().describe('Respons\xE1vel no novo funil (nome ou email; "none" = sem respons\xE1vel). Padr\xE3o: o mesmo do lead ganho'),
+        value: z6.number().min(0).optional().describe("Valor em reais no novo funil (padr\xE3o: 0)")
       }
     },
     withApi(async (api, a) => {
@@ -1229,12 +1625,12 @@ function registerLeadTools(server) {
     "bulk_update_leads",
     {
       title: "Atualizar leads em massa",
-      description: "Reatribui (s\xF3 admins) e/ou move at\xE9 1000 leads de uma vez. Pegue os ids com search_leads. Para mover, informe stage (e funnel, se for outro funil; sem funnel, vale o funil do primeiro lead). Leads que voc\xEA n\xE3o pode editar s\xE3o pulados, assim como leads ganhos numa troca de funil (use handoff_lead para eles).",
+      description: "Reatribui (s\xF3 admins e Masters) e/ou move at\xE9 1000 leads de uma vez. Pegue os ids com search_leads. Para mover, informe stage (e funnel, se for outro funil; sem funnel, vale o funil do primeiro lead). Leads que voc\xEA n\xE3o pode editar s\xE3o pulados, assim como leads ganhos numa troca de funil (use handoff_lead para eles).",
       inputSchema: {
-        lead_ids: z5.array(z5.string().uuid()).min(1).max(1e3),
-        owner: z5.string().optional().describe("Nome ou email do novo respons\xE1vel"),
-        stage: z5.string().optional(),
-        funnel: z5.string().optional()
+        lead_ids: z6.array(z6.string().uuid()).min(1).max(1e3),
+        owner: z6.string().optional().describe("Nome ou email do novo respons\xE1vel"),
+        stage: z6.string().optional(),
+        funnel: z6.string().optional()
       }
     },
     withApi(async (api, a) => {
@@ -1260,8 +1656,8 @@ function registerLeadTools(server) {
     "delete_lead",
     {
       title: "Excluir lead",
-      description: "Apaga um lead e todo o hist\xF3rico dele (s\xF3 admins). N\xE3o d\xE1 para desfazer \u2014 confirme com a pessoa antes. Para tirar do funil sem apagar, prefira mark_lost.",
-      inputSchema: { lead_id: z5.string().uuid() },
+      description: "Apaga um lead e todo o hist\xF3rico dele (s\xF3 admins e Masters). N\xE3o d\xE1 para desfazer \u2014 confirme com a pessoa antes. Para tirar do funil sem apagar, prefira mark_lost.",
+      inputSchema: { lead_id: z6.string().uuid() },
       annotations: { destructiveHint: true }
     },
     withApi(async (api, a) => {
@@ -1273,14 +1669,14 @@ function registerLeadTools(server) {
 }
 
 // src/tools/risks.ts
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 function registerRiskTools(server) {
   server.registerTool(
     "get_lead_risks",
     {
       title: "Leads em risco",
-      description: "Leads abertos parados al\xE9m do prazo da etapa (dias \xFAteis; s\xF3 mudar de etapa zera a contagem). Passou do prazo, o vendedor \xE9 avisado; passou do dobro, \xE9 cr\xEDtico e o admin \xE9 avisado. Mostra o valor em risco, onde trava (etapa), com quem (vendedor) e os mais atrasados. Para listar todos os fora do prazo use search_leads com filter=stale. S\xF3 admins.",
-      inputSchema: { workspace: z6.string().optional() },
+      description: "Leads abertos parados al\xE9m do prazo da etapa (dias \xFAteis; s\xF3 mudar de etapa zera a contagem). Passou do prazo, o vendedor \xE9 avisado; passou do dobro, \xE9 cr\xEDtico e o Master e o admin s\xE3o avisados. Mostra o valor em risco, onde trava (etapa), com quem (vendedor) e os mais atrasados. Para listar todos os fora do prazo use search_leads com filter=stale. S\xF3 admins e Masters.",
+      inputSchema: { workspace: z7.string().optional() },
       annotations: { readOnlyHint: true }
     },
     withApi(async (api, a) => {
@@ -1312,15 +1708,15 @@ function registerRiskTools(server) {
 }
 
 // src/tools/structure.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 var TEMPLATE_KEYS = Object.keys(FUNNEL_TEMPLATES);
-var stageInput = z7.object({
-  name: z7.string().min(1).max(60),
-  probability: z7.number().int().min(0).max(100).describe("Chance (%) de um lead nesta etapa virar venda"),
-  limit_days: z7.number().int().min(1).max(365).nullish().describe(
-    `Prazo da etapa em dias \xFAteis: passou dele, o vendedor \xE9 avisado; passou do dobro, o admin tamb\xE9m. null volta ao padr\xE3o (${DEFAULT_STAGE_LIMIT_DAYS}); omitido mant\xE9m o atual.`
+var stageInput = z8.object({
+  name: z8.string().min(1).max(60),
+  probability: z8.number().int().min(0).max(100).describe("Chance (%) de um lead nesta etapa virar venda"),
+  limit_days: z8.number().int().min(1).max(365).nullish().describe(
+    `Prazo da etapa em dias \xFAteis: passou dele, o vendedor \xE9 avisado; passou do dobro, o Master e o admin tamb\xE9m. null volta ao padr\xE3o (${DEFAULT_STAGE_LIMIT_DAYS}); omitido mant\xE9m o atual.`
   ),
-  was: z7.string().optional().describe("Nome atual da etapa, se voc\xEA est\xE1 renomeando uma existente")
+  was: z8.string().optional().describe("Nome atual da etapa, se voc\xEA est\xE1 renomeando uma existente")
 });
 var describeFunnel = (f, ws) => ({
   name: f.name,
@@ -1330,10 +1726,10 @@ var describeFunnel = (f, ws) => ({
   auto_assign: !!f.autoAssign,
   stages: f.stages.map((s) => `${s.name} (${s.probability}%, prazo ${s.limitDays ?? DEFAULT_STAGE_LIMIT_DAYS} dias \xFAteis${s.limitDays ? "" : " \u2014 padr\xE3o"})`)
 });
-var autoAssignArg = z7.boolean().optional().describe(
-  "Distribui\xE7\xE3o autom\xE1tica: leads cadastrados ou importados por admins sem vendedor v\xE3o, em maior parte, para quem est\xE1 fechando mais (todos recebem). Quem passa um dia \xFAtil sem nenhuma a\xE7\xE3o no funil para de receber at\xE9 um admin liberar (release_seller)."
+var autoAssignArg = z8.boolean().optional().describe(
+  "Distribui\xE7\xE3o autom\xE1tica: leads cadastrados ou importados por admins/Masters sem vendedor v\xE3o, em maior parte, para quem est\xE1 fechando mais (todo vendedor recebe; admins e Masters nunca). Quem passa um dia \xFAtil sem nenhuma a\xE7\xE3o no funil para de receber at\xE9 um Master ou admin liberar (release_seller)."
 );
-var nextFunnelArg = z7.string().nullable().optional().describe('Funil (do mesmo workspace) onde o cliente continua depois de ganho, ex.: "Relacionamento". Sugerido no app ao marcar ganho. null ou "none" remove.');
+var nextFunnelArg = z8.string().nullable().optional().describe('Funil (do mesmo workspace) onde o cliente continua depois de ganho, ex.: "Relacionamento". Sugerido no app ao marcar ganho. null ou "none" remove.');
 var nextFunnelId = (ws, ref) => ref === void 0 ? void 0 : ref === null || norm(ref) === "none" ? null : resolve(ws.funnels, ref, "Funil").id;
 function registerStructureTools(server) {
   server.registerTool(
@@ -1342,9 +1738,9 @@ function registerStructureTools(server) {
       title: "Criar workspace",
       description: "Cria um workspace (s\xF3 admins) \u2014 ex.: um time, regi\xE3o ou unidade. J\xE1 vem com um funil de vendas, a menos que create_funnel=false.",
       inputSchema: {
-        name: z7.string().min(1).max(80),
-        visibility: z7.enum(["all", "own"]).default("all").describe("all = todos veem todos os leads; own = cada vendedor v\xEA s\xF3 os seus"),
-        create_funnel: z7.boolean().default(true)
+        name: z8.string().min(1).max(80),
+        visibility: z8.enum(["all", "own"]).default("all").describe("all = todos veem todos os leads; own = cada vendedor v\xEA s\xF3 os seus"),
+        create_funnel: z8.boolean().default(true)
       }
     },
     withApi(async (api, a) => {
@@ -1359,9 +1755,9 @@ function registerStructureTools(server) {
       title: "Alterar workspace",
       description: "Renomeia um workspace ou muda quem v\xEA quais leads (s\xF3 admins).",
       inputSchema: {
-        workspace: z7.string(),
-        name: z7.string().min(1).max(80).optional(),
-        visibility: z7.enum(["all", "own"]).optional().describe("all = todos veem todos os leads; own = cada vendedor v\xEA s\xF3 os seus")
+        workspace: z8.string(),
+        name: z8.string().min(1).max(80).optional(),
+        visibility: z8.enum(["all", "own"]).optional().describe("all = todos veem todos os leads; own = cada vendedor v\xEA s\xF3 os seus")
       }
     },
     withApi(async (api, a) => {
@@ -1375,7 +1771,7 @@ function registerStructureTools(server) {
     {
       title: "Excluir workspace",
       description: "Apaga um workspace com TODOS os funis e leads dele (s\xF3 admins). N\xE3o d\xE1 para desfazer \u2014 confirme com a pessoa antes.",
-      inputSchema: { workspace: z7.string() },
+      inputSchema: { workspace: z8.string() },
       annotations: { destructiveHint: true }
     },
     withApi(async (api, a) => {
@@ -1390,12 +1786,12 @@ function registerStructureTools(server) {
       title: "Criar funil",
       description: `Cria um funil num workspace (s\xF3 admins). Use um modelo (${TEMPLATE_KEYS.map((k) => `${k} = ${FUNNEL_TEMPLATES[k].label}`).join("; ")}) ou informe stages. goal_kpi define o que conta como meta: revenue (receita ganha), won_count (n\xBA de vendas) ou stage_reached (n\xBA de leads que chegaram a goal_stage).`,
       inputSchema: {
-        name: z7.string().min(1).max(80),
-        workspace: z7.string().optional(),
-        template: z7.enum(TEMPLATE_KEYS).optional(),
-        stages: z7.array(stageInput.omit({ was: true })).min(1).max(20).optional(),
-        goal_kpi: z7.enum(GOAL_KPIS).default("revenue"),
-        goal_stage: z7.string().optional().describe("Etapa que conta como meta (s\xF3 para stage_reached; padr\xE3o: a \xFAltima)"),
+        name: z8.string().min(1).max(80),
+        workspace: z8.string().optional(),
+        template: z8.enum(TEMPLATE_KEYS).optional(),
+        stages: z8.array(stageInput.omit({ was: true })).min(1).max(20).optional(),
+        goal_kpi: z8.enum(GOAL_KPIS).default("revenue"),
+        goal_stage: z8.string().optional().describe("Etapa que conta como meta (s\xF3 para stage_reached; padr\xE3o: a \xFAltima)"),
         next_funnel: nextFunnelArg,
         auto_assign: autoAssignArg
       }
@@ -1425,12 +1821,12 @@ function registerStructureTools(server) {
       title: "Alterar funil",
       description: "Renomeia o funil, troca o KPI de meta ou redefine as etapas (s\xF3 admins). stages \xE9 a lista completa e na ordem: etapas com o mesmo nome (ou com was) s\xE3o mantidas, as novas s\xE3o criadas e as que ficarem de fora s\xE3o removidas \u2014 o que s\xF3 funciona se n\xE3o tiverem leads (mova antes com bulk_update_leads). next_funnel define para onde o cliente vai depois de ganho (ex.: Aquisi\xE7\xE3o \u2192 Relacionamento). auto_assign liga ou desliga a distribui\xE7\xE3o autom\xE1tica de leads. limit_days em cada etapa define o prazo (dias \xFAteis) antes de o lead ser considerado parado.",
       inputSchema: {
-        funnel: z7.string(),
-        workspace: z7.string().optional(),
-        name: z7.string().min(1).max(80).optional(),
-        goal_kpi: z7.enum(GOAL_KPIS).optional(),
-        goal_stage: z7.string().optional(),
-        stages: z7.array(stageInput).min(1).max(20).optional(),
+        funnel: z8.string(),
+        workspace: z8.string().optional(),
+        name: z8.string().min(1).max(80).optional(),
+        goal_kpi: z8.enum(GOAL_KPIS).optional(),
+        goal_stage: z8.string().optional(),
+        stages: z8.array(stageInput).min(1).max(20).optional(),
         next_funnel: nextFunnelArg,
         auto_assign: autoAssignArg
       }
@@ -1468,7 +1864,7 @@ function registerStructureTools(server) {
     {
       title: "Excluir funil",
       description: "Remove um funil (s\xF3 admins). Se ele tiver leads, \xE9 arquivado (some das telas, hist\xF3rico preservado); se estiver vazio, \xE9 apagado. Confirme com a pessoa antes.",
-      inputSchema: { funnel: z7.string(), workspace: z7.string().optional() },
+      inputSchema: { funnel: z8.string(), workspace: z8.string().optional() },
       annotations: { destructiveHint: true }
     },
     withApi(async (api, a) => {
@@ -1480,15 +1876,15 @@ function registerStructureTools(server) {
 }
 
 // src/tools/team.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var wsNames = (c, ids = []) => ids.map((id2) => c.workspaces.find((w) => w.id === id2)?.name ?? id2);
 function registerTeamTools(server) {
   server.registerTool(
     "list_users",
     {
       title: "Listar usu\xE1rios",
-      description: "Lista as pessoas da organiza\xE7\xE3o: papel (admin/member), se est\xE1 ativa, convite pendente e workspaces de cada uma.",
-      inputSchema: { include_inactive: z8.boolean().default(false) },
+      description: "Lista as pessoas da organiza\xE7\xE3o: papel (admin, manager = Master, member = vendedor), se est\xE1 ativa, convite pendente e workspaces de cada uma.",
+      inputSchema: { include_inactive: z9.boolean().default(false) },
       annotations: { readOnlyHint: true }
     },
     withApi(async (api, a) => {
@@ -1509,12 +1905,12 @@ function registerTeamTools(server) {
     "invite_user",
     {
       title: "Convidar usu\xE1rio",
-      description: "Convida uma pessoa para a organiza\xE7\xE3o (s\xF3 admins) e devolve o link de convite (vale 7 dias) para voc\xEA enviar a ela. member = vendedor (v\xEA os workspaces em que est\xE1); admin = v\xEA e configura tudo.",
+      description: "Convida uma pessoa para a organiza\xE7\xE3o (admins; Masters s\xF3 convidam vendedores para os workspaces deles) e devolve o link de convite (vale 7 dias) para voc\xEA enviar a ela. member = vendedor (v\xEA os workspaces em que est\xE1 e recebe leads distribu\xEDdos); manager = Master (lidera o time nos workspaces dele: v\xEA todos os leads, importa e distribui, define metas, convida vendedores; n\xE3o recebe leads automaticamente); admin = v\xEA e configura tudo.",
       inputSchema: {
-        name: z8.string().min(2),
-        email: z8.string().email(),
-        role: z8.enum(["member", "admin"]).default("member"),
-        workspaces: z8.array(z8.string()).optional().describe("Nomes dos workspaces (padr\xE3o: o primeiro)")
+        name: z9.string().min(2),
+        email: z9.string().email(),
+        role: z9.enum(["member", "manager", "admin"]).default("member"),
+        workspaces: z9.array(z9.string()).optional().describe("Nomes dos workspaces (padr\xE3o: o primeiro)")
       }
     },
     withApi(async (api, a) => {
@@ -1533,8 +1929,8 @@ function registerTeamTools(server) {
     "resend_invite",
     {
       title: "Gerar novo link de convite",
-      description: "Gera um novo link de convite para algu\xE9m (s\xF3 admins) \u2014 \xFAtil se o anterior expirou. O link antigo deixa de valer.",
-      inputSchema: { user: z8.string().describe("Nome ou email") }
+      description: "Gera um novo link de convite para algu\xE9m (admins; Masters s\xF3 para vendedores do time) \u2014 \xFAtil se o anterior expirou. O link antigo deixa de valer.",
+      inputSchema: { user: z9.string().describe("Nome ou email") }
     },
     withApi(async (api, a) => {
       const c = await ctx(api);
@@ -1547,13 +1943,13 @@ function registerTeamTools(server) {
     "update_user",
     {
       title: "Alterar usu\xE1rio",
-      description: "Muda nome, papel, workspaces ou desativa/reativa algu\xE9m (s\xF3 admins). Desativar encerra as sess\xF5es e tokens da pessoa; os leads continuam com ela at\xE9 serem reatribu\xEDdos (bulk_update_leads).",
+      description: "Muda nome, papel, workspaces ou desativa/reativa algu\xE9m (admins; Masters s\xF3 ajustam workspaces e ativa\xE7\xE3o de vendedores do time, sem mudar papel). Desativar encerra as sess\xF5es e tokens da pessoa; os leads continuam com ela at\xE9 serem reatribu\xEDdos (bulk_update_leads).",
       inputSchema: {
-        user: z8.string().describe("Nome ou email"),
-        name: z8.string().min(2).optional(),
-        role: z8.enum(["member", "admin"]).optional(),
-        active: z8.boolean().optional(),
-        workspaces: z8.array(z8.string()).optional().describe("Lista completa de workspaces da pessoa (substitui a atual)")
+        user: z9.string().describe("Nome ou email"),
+        name: z9.string().min(2).optional(),
+        role: z9.enum(["member", "manager", "admin"]).optional(),
+        active: z9.boolean().optional(),
+        workspaces: z9.array(z9.string()).optional().describe("Lista completa de workspaces da pessoa (substitui a atual)")
       }
     },
     withApi(async (api, a) => {
@@ -1588,11 +1984,25 @@ function registerManageTools(server) {
 }
 
 // src/server.ts
+var DEVELOPER_INSTRUCTIONS = "Voc\xEA est\xE1 conectado ao AICRM como Desenvolvedor: seu trabalho \xE9 integrar o sistema desta pessoa ao CRM pela API p\xFAblica, com o SDK @aicrm/sdk. Voc\xEA n\xE3o v\xEA leads nem o time, s\xF3 a estrutura (get_integration_schema), suas chaves e os logs. Roteiro: 1) get_integration_schema; 2) ache no c\xF3digo de onde v\xEAm os leads e mostre \xE0 pessoa o mapeamento campo \u2192 campo do CRM (inclusive os obrigat\xF3rios) antes de escrever; 3) create_api_key em modo test, que grava a chave no .env sem mostr\xE1-la; 4) npm i @aicrm/sdk e escreva o c\xF3digo com externalId; 5) rode e confira em list_api_logs, corrigindo pelos how_to_fix; 6) s\xF3 com o ok da pessoa, create_api_key mode live (confirm_live) e clear_test_leads. Chave secreta (aicrm_sk_) nunca vai para o navegador: no site use publishable. Se a skill aicrm-integrate estiver instalada, siga-a.";
+async function currentRole() {
+  const creds = await loadCredentials();
+  if (!creds) return "";
+  if (creds.user.role) return creds.user.role;
+  return apiFor(creds).get("/auth/me").then((m) => m.user.role, () => "");
+}
 async function startServer() {
+  const role = await currentRole();
+  if (role === "developer") {
+    const dev = new McpServer({ name: "aicrm", version: "0.6.0" }, { instructions: DEVELOPER_INSTRUCTIONS });
+    registerIntegrationTools(dev);
+    await dev.connect(new StdioServerTransport());
+    return;
+  }
   const server = new McpServer(
-    { name: "aicrm", version: "0.4.0" },
+    { name: "aicrm", version: "0.6.0" },
     {
-      instructions: 'AICRM \xE9 um CRM de vendas. Workspaces cont\xEAm funis; funis cont\xEAm etapas e leads. Status do lead: open, won, lost. Workspaces, funis, etapas e vendedores podem ser referenciados por nome. Valores monet\xE1rios est\xE3o em reais (BRL). Use get_dashboard/get_forecast para metas e proje\xE7\xF5es estat\xEDsticas (Monte Carlo bayesiano). Para "o que eu fa\xE7o hoje?", use get_today_plan: lista os leads que mais ajudam a bater a meta, com motivo e a\xE7\xE3o sugerida. Cada workspace pode ter campos personalizados (ex.: Cidade, Porte) e esconder campos padr\xE3o: veja list_fields. Em create_lead/update_lead, preencha-os em custom_fields usando o nome do campo. Lead ganho n\xE3o troca de funil: para levar o cliente adiante (ex.: Aquisi\xE7\xE3o \u2192 Relacionamento), use handoff_lead ou next_funnel em mark_won, que criam um lead novo ligado ao ganho. Antes de importar um CSV desconhecido, rode import_leads_csv com dry_run=true para revisar o mapeamento de colunas. Admins tamb\xE9m gerenciam time (invite_user, update_user), estrutura (create_workspace, create_funnel, update_funnel), metas e comiss\xF5es (set_goals, save_commission_plan) e modo TV. Funis com auto_assign distribuem leads sem vendedor por desempenho; quem passa um dia \xFAtil sem nenhuma a\xE7\xE3o no funil para de receber at\xE9 um admin liberar: veja get_distribution, release_seller e pause_seller. O servidor aplica as permiss\xF5es do usu\xE1rio logado: se uma a\xE7\xE3o for negada, explique que precisa de um admin. A\xE7\xF5es destrutivas (delete_*, archive_field, revoke_*) exigem confirma\xE7\xE3o expl\xEDcita da pessoa antes.'
+      instructions: 'AICRM \xE9 um CRM de vendas. Workspaces cont\xEAm funis; funis cont\xEAm etapas e leads. Status do lead: open, won, lost. Workspaces, funis, etapas e vendedores podem ser referenciados por nome. Valores monet\xE1rios est\xE3o em reais (BRL). Use get_dashboard/get_forecast para metas e proje\xE7\xF5es estat\xEDsticas (Monte Carlo bayesiano). Para "o que eu fa\xE7o hoje?", use get_today_plan: lista os leads que mais ajudam a bater a meta, com motivo e a\xE7\xE3o sugerida. Cada workspace pode ter campos personalizados (ex.: Cidade, Porte) e esconder campos padr\xE3o: veja list_fields. Em create_lead/update_lead, preencha-os em custom_fields usando o nome do campo. Lead ganho n\xE3o troca de funil: para levar o cliente adiante (ex.: Aquisi\xE7\xE3o \u2192 Relacionamento), use handoff_lead ou next_funnel em mark_won, que criam um lead novo ligado ao ganho. Antes de importar um CSV desconhecido, rode import_leads_csv com dry_run=true para revisar o mapeamento de colunas. Pap\xE9is: admin configura tudo (estrutura, campos, comiss\xF5es, pap\xE9is); manager (Master) lidera o time s\xF3 nos workspaces dele: v\xEA todos os leads, importa e distribui, reatribui e exclui leads, define metas (set_goals), pausa/libera vendedores, usa modo TV e convida vendedores; member \xE9 o vendedor. Admins e Masters n\xE3o recebem leads automaticamente (distribui\xE7\xE3o e rod\xEDzio v\xE3o s\xF3 para vendedores), mas podem assumir um lead de prop\xF3sito. Funis com auto_assign distribuem leads sem vendedor por desempenho; quem passa um dia \xFAtil sem nenhuma a\xE7\xE3o no funil para de receber at\xE9 um Master ou admin liberar: veja get_distribution, release_seller e pause_seller. O servidor aplica as permiss\xF5es do usu\xE1rio logado: se uma a\xE7\xE3o for negada, explique que precisa de um admin ou Master. A\xE7\xF5es destrutivas (delete_*, archive_field, revoke_*) exigem confirma\xE7\xE3o expl\xEDcita da pessoa antes.'
     }
   );
   server.registerTool(
@@ -1632,15 +2042,15 @@ async function startServer() {
       title: "Buscar leads",
       description: "Busca leads por texto e filtros. filter: mine (meus), stale (passaram do prazo da etapa, em dias \xFAteis), no_next_step (sem pr\xF3ximo passo).",
       inputSchema: {
-        query: z9.string().optional().describe("Texto em nome, empresa ou email"),
-        workspace: z9.string().optional(),
-        funnel: z9.string().optional(),
-        stage: z9.string().optional(),
-        owner: z9.string().optional().describe("Nome ou email do respons\xE1vel"),
-        status: z9.enum(["open", "won", "lost"]).optional(),
-        filter: z9.enum(["mine", "stale", "no_next_step"]).optional(),
-        field_filters: z9.record(z9.string(), z9.string()).optional().describe('Filtra por campos personalizados: { "Cidade": "Recife" }. Texto: cont\xE9m; demais tipos: igual (datas em dd/mm/aaaa, sim/n\xE3o).'),
-        limit: z9.number().int().min(1).max(200).default(25)
+        query: z10.string().optional().describe("Texto em nome, empresa ou email"),
+        workspace: z10.string().optional(),
+        funnel: z10.string().optional(),
+        stage: z10.string().optional(),
+        owner: z10.string().optional().describe("Nome ou email do respons\xE1vel"),
+        status: z10.enum(["open", "won", "lost"]).optional(),
+        filter: z10.enum(["mine", "stale", "no_next_step"]).optional(),
+        field_filters: z10.record(z10.string(), z10.string()).optional().describe('Filtra por campos personalizados: { "Cidade": "Recife" }. Texto: cont\xE9m; demais tipos: igual (datas em dd/mm/aaaa, sim/n\xE3o).'),
+        limit: z10.number().int().min(1).max(200).default(25)
       },
       annotations: { readOnlyHint: true }
     },
@@ -1675,7 +2085,7 @@ async function startServer() {
     {
       title: "Detalhes do lead",
       description: "Retorna todos os campos de um lead e o hist\xF3rico (movimenta\xE7\xF5es e notas).",
-      inputSchema: { lead_id: z9.string().uuid() },
+      inputSchema: { lead_id: z10.string().uuid() },
       annotations: { readOnlyHint: true }
     },
     withApi(async (api, a) => {
@@ -1708,17 +2118,17 @@ async function startServer() {
     })
   );
   const leadFields = {
-    name: z9.string().optional(),
-    company: z9.string().optional(),
-    email: z9.string().optional(),
-    phone: z9.string().optional(),
-    title: z9.string().optional(),
-    value: z9.number().min(0).optional().describe("Valor do neg\xF3cio em reais"),
-    source: z9.enum(LEAD_SOURCES).optional(),
-    next_step: z9.string().optional(),
-    next_step_date: z9.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
-    expected_close: z9.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
-    custom_fields: z9.record(z9.string(), z9.union([z9.string(), z9.number(), z9.boolean(), z9.null()])).optional().describe('Campos personalizados do workspace pelo nome: { "Cidade": "Recife", "Faturamento": 50000 }. Dinheiro em reais; null limpa o campo. Veja list_fields.')
+    name: z10.string().optional(),
+    company: z10.string().optional(),
+    email: z10.string().optional(),
+    phone: z10.string().optional(),
+    title: z10.string().optional(),
+    value: z10.number().min(0).optional().describe("Valor do neg\xF3cio em reais"),
+    source: z10.enum(LEAD_SOURCES).optional(),
+    next_step: z10.string().optional(),
+    next_step_date: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    expected_close: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    custom_fields: z10.record(z10.string(), z10.union([z10.string(), z10.number(), z10.boolean(), z10.null()])).optional().describe('Campos personalizados do workspace pelo nome: { "Cidade": "Recife", "Faturamento": 50000 }. Dinheiro em reais; null limpa o campo. Veja list_fields.')
   };
   const toBody = (a) => Object.fromEntries(
     Object.entries({
@@ -1738,8 +2148,8 @@ async function startServer() {
     "create_lead",
     {
       title: "Criar lead",
-      description: "Cria um lead. Sem funil/etapa, usa o primeiro funil do workspace e a primeira etapa. O respons\xE1vel padr\xE3o \xE9 voc\xEA, exceto quando um admin cria sem owner num funil com distribui\xE7\xE3o autom\xE1tica (auto_assign): a\xED o AICRM escolhe o vendedor pelo desempenho (veja get_distribution).",
-      inputSchema: { ...leadFields, name: z9.string(), workspace: z9.string().optional(), funnel: z9.string().optional(), stage: z9.string().optional(), owner: z9.string().optional() }
+      description: "Cria um lead. Sem funil/etapa, usa o primeiro funil do workspace e a primeira etapa. Vendedor: o respons\xE1vel padr\xE3o \xE9 voc\xEA. Admin ou Master sem owner: o AICRM escolhe um vendedor pelo desempenho (veja get_distribution); se ningu\xE9m puder receber, o lead fica sem respons\xE1vel.",
+      inputSchema: { ...leadFields, name: z10.string(), workspace: z10.string().optional(), funnel: z10.string().optional(), stage: z10.string().optional(), owner: z10.string().optional() }
     },
     withApi(async (api, a) => {
       const c = await ctx(api);
@@ -1762,7 +2172,7 @@ async function startServer() {
     {
       title: "Atualizar lead",
       description: 'Atualiza campos de um lead (s\xF3 os informados; texto vazio "" limpa um campo padr\xE3o). Use owner para reatribuir, ou owner="none" para deixar sem respons\xE1vel.',
-      inputSchema: { lead_id: z9.string().uuid(), ...leadFields, owner: z9.string().optional() }
+      inputSchema: { lead_id: z10.string().uuid(), ...leadFields, owner: z10.string().optional() }
     },
     withApi(async (api, a) => {
       const c = await ctx(api);
@@ -1782,8 +2192,8 @@ async function startServer() {
     "move_lead",
     {
       title: "Mover lead",
-      description: "Move um lead para outra etapa \u2014 e opcionalmente para outro funil (entre workspaces: s\xF3 admins). Lead ganho n\xE3o muda de funil (a venda precisa continuar contando onde foi fechada): para lev\xE1-lo a outro funil, use handoff_lead.",
-      inputSchema: { lead_id: z9.string().uuid(), stage: z9.string().describe("Nome ou id da etapa de destino"), funnel: z9.string().optional().describe("Funil de destino (padr\xE3o: o atual)") }
+      description: "Move um lead para outra etapa \u2014 e opcionalmente para outro funil (entre workspaces: s\xF3 admins e Masters). Lead ganho n\xE3o muda de funil (a venda precisa continuar contando onde foi fechada): para lev\xE1-lo a outro funil, use handoff_lead.",
+      inputSchema: { lead_id: z10.string().uuid(), stage: z10.string().describe("Nome ou id da etapa de destino"), funnel: z10.string().optional().describe("Funil de destino (padr\xE3o: o atual)") }
     },
     withApi(async (api, a) => {
       const c = await ctx(api);
@@ -1800,12 +2210,12 @@ async function startServer() {
       title: "Marcar como ganho",
       description: "Marca o lead como ganho. Informe value (R$) se o valor fechado for diferente do cadastrado. Para j\xE1 continuar o cliente em outro funil (ex.: Relacionamento), informe next_funnel: \xE9 criado um lead novo ligado ao ganho, na mesma opera\xE7\xE3o. Se o funil tiver um funil seguinte configurado, a resposta avisa \u2014 pergunte \xE0 pessoa antes de usar handoff_lead.",
       inputSchema: {
-        lead_id: z9.string().uuid(),
-        value: z9.number().min(0).optional(),
-        next_funnel: z9.string().optional().describe("Funil onde o cliente continua depois do ganho"),
-        next_stage: z9.string().optional().describe("Etapa de entrada no pr\xF3ximo funil (padr\xE3o: a primeira)"),
-        next_owner: z9.string().optional().describe("Respons\xE1vel no pr\xF3ximo funil (padr\xE3o: o mesmo)"),
-        next_value: z9.number().min(0).optional().describe("Valor em reais no pr\xF3ximo funil (padr\xE3o: 0)")
+        lead_id: z10.string().uuid(),
+        value: z10.number().min(0).optional(),
+        next_funnel: z10.string().optional().describe("Funil onde o cliente continua depois do ganho"),
+        next_stage: z10.string().optional().describe("Etapa de entrada no pr\xF3ximo funil (padr\xE3o: a primeira)"),
+        next_owner: z10.string().optional().describe("Respons\xE1vel no pr\xF3ximo funil (padr\xE3o: o mesmo)"),
+        next_value: z10.number().min(0).optional().describe("Valor em reais no pr\xF3ximo funil (padr\xE3o: 0)")
       }
     },
     withApi(async (api, a) => {
@@ -1833,7 +2243,7 @@ async function startServer() {
     {
       title: "Marcar como perdido",
       description: "Marca o lead como perdido com um motivo: price, timing, competitor, no_response, no_fit, other.",
-      inputSchema: { lead_id: z9.string().uuid(), reason: z9.enum(LOST_REASONS), note: z9.string().optional() }
+      inputSchema: { lead_id: z10.string().uuid(), reason: z10.enum(LOST_REASONS), note: z10.string().optional() }
     },
     withApi(async (api, a) => {
       const c = await ctx(api);
@@ -1846,7 +2256,7 @@ async function startServer() {
     {
       title: "Adicionar nota",
       description: "Adiciona uma nota \xE0 linha do tempo do lead.",
-      inputSchema: { lead_id: z9.string().uuid(), note: z9.string().min(1) }
+      inputSchema: { lead_id: z10.string().uuid(), note: z10.string().min(1) }
     },
     withApi(async (api, a) => {
       await api.post(`/leads/${a.lead_id}/notes`, { body: a.note });
@@ -1858,7 +2268,7 @@ async function startServer() {
     {
       title: "Dashboard de metas",
       description: "Metas do time e de cada vendedor no m\xEAs, com probabilidade de bater (Monte Carlo), proje\xE7\xE3o, ritmo, cobertura de pipeline, comiss\xE3o e KPIs descritivos.",
-      inputSchema: { funnel: z9.string().optional(), workspace: z9.string().optional(), month: z9.string().regex(/^\d{4}-\d{2}$/).optional().describe("YYYY-MM; padr\xE3o: m\xEAs atual") },
+      inputSchema: { funnel: z10.string().optional(), workspace: z10.string().optional(), month: z10.string().regex(/^\d{4}-\d{2}$/).optional().describe("YYYY-MM; padr\xE3o: m\xEAs atual") },
       annotations: { readOnlyHint: true }
     },
     withApi(async (api, a) => {
@@ -1894,7 +2304,7 @@ async function startServer() {
     {
       title: "Vai bater a meta?",
       description: "Proje\xE7\xE3o detalhada de um vendedor: probabilidade de bater a meta, intervalo de 80%, ritmo atual vs necess\xE1rio e comiss\xE3o projetada.",
-      inputSchema: { seller: z9.string().describe("Nome ou email do vendedor"), funnel: z9.string().optional(), month: z9.string().regex(/^\d{4}-\d{2}$/).optional() },
+      inputSchema: { seller: z10.string().describe("Nome ou email do vendedor"), funnel: z10.string().optional(), month: z10.string().regex(/^\d{4}-\d{2}$/).optional() },
       annotations: { readOnlyHint: true }
     },
     withApi(async (api, a) => {
@@ -1917,12 +2327,12 @@ async function startServer() {
     "get_today_plan",
     {
       title: "Plano do dia",
-      description: 'Plano do dia: os leads abertos que mais ajudam o vendedor a bater a meta hoje, em ordem, com o motivo e a a\xE7\xE3o sugerida (WhatsApp, pr\xF3ximo passo ou mover de etapa). Use quando a pessoa perguntar "o que eu fa\xE7o hoje?", "por onde come\xE7o?" ou "quais leads priorizar?". Por padr\xE3o \xE9 o plano de quem est\xE1 logado; admins podem pedir o de outro vendedor.',
+      description: 'Plano do dia: os leads abertos que mais ajudam o vendedor a bater a meta hoje, em ordem, com o motivo e a a\xE7\xE3o sugerida (WhatsApp, pr\xF3ximo passo ou mover de etapa). Use quando a pessoa perguntar "o que eu fa\xE7o hoje?", "por onde come\xE7o?" ou "quais leads priorizar?". Por padr\xE3o \xE9 o plano de quem est\xE1 logado; admins e Masters podem pedir o de outro vendedor.',
       inputSchema: {
-        funnel: z9.string().optional(),
-        workspace: z9.string().optional(),
-        seller: z9.string().optional().describe("Nome ou email do vendedor (s\xF3 admins veem o plano de outra pessoa)"),
-        limit: z9.number().int().min(5).max(10).optional().describe("Quantos leads sugerir (5 a 10; padr\xE3o 7)")
+        funnel: z10.string().optional(),
+        workspace: z10.string().optional(),
+        seller: z10.string().optional().describe("Nome ou email do vendedor (s\xF3 admins e Masters veem o plano de outra pessoa)"),
+        limit: z10.number().int().min(5).max(10).optional().describe("Quantos leads sugerir (5 a 10; padr\xE3o 7)")
       },
       annotations: { readOnlyHint: true }
     },
@@ -1968,7 +2378,7 @@ async function startServer() {
     {
       title: "Campos do workspace",
       description: "Mostra os campos de lead de um workspace: campos padr\xE3o (e quais est\xE3o escondidos), campos personalizados com tipo e op\xE7\xF5es, e os modelos de importa\xE7\xE3o de CSV salvos.",
-      inputSchema: { workspace: z9.string().optional() },
+      inputSchema: { workspace: z10.string().optional() },
       annotations: { readOnlyHint: true }
     },
     withApi(async (api, a) => {
@@ -2000,10 +2410,10 @@ async function startServer() {
       title: "Criar campo personalizado",
       description: "Cria um campo de lead no workspace (s\xF3 admins). Tipos: text, number, money (R$), date, select (lista \u2014 exige options), boolean (sim/n\xE3o), url.",
       inputSchema: {
-        label: z9.string().min(1).max(60).describe("Nome do campo, ex.: Cidade"),
-        type: z9.enum(CUSTOM_FIELD_TYPES),
-        options: z9.array(z9.string()).optional().describe("Op\xE7\xF5es da lista (tipo select)"),
-        workspace: z9.string().optional()
+        label: z10.string().min(1).max(60).describe("Nome do campo, ex.: Cidade"),
+        type: z10.enum(CUSTOM_FIELD_TYPES),
+        options: z10.array(z10.string()).optional().describe("Op\xE7\xF5es da lista (tipo select)"),
+        workspace: z10.string().optional()
       }
     },
     withApi(async (api, a) => {
@@ -2019,10 +2429,10 @@ async function startServer() {
       title: "Editar campo personalizado",
       description: "Renomeia um campo ou troca as op\xE7\xF5es de uma lista (s\xF3 admins). O tipo n\xE3o muda depois de criado. Renomear n\xE3o quebra modelos de importa\xE7\xE3o.",
       inputSchema: {
-        field: z9.string().describe("Nome ou id do campo"),
-        label: z9.string().min(1).max(60).optional(),
-        options: z9.array(z9.string()).optional().describe("Lista completa de op\xE7\xF5es (substitui a atual)"),
-        workspace: z9.string().optional()
+        field: z10.string().describe("Nome ou id do campo"),
+        label: z10.string().min(1).max(60).optional(),
+        options: z10.array(z10.string()).optional().describe("Lista completa de op\xE7\xF5es (substitui a atual)"),
+        workspace: z10.string().optional()
       }
     },
     withApi(async (api, a) => {
@@ -2038,7 +2448,7 @@ async function startServer() {
     {
       title: "Remover campo personalizado",
       description: "Remove um campo das telas e importa\xE7\xF5es (s\xF3 admins). Os valores j\xE1 preenchidos ficam guardados, mas deixam de aparecer.",
-      inputSchema: { field: z9.string().describe("Nome ou id do campo"), workspace: z9.string().optional() },
+      inputSchema: { field: z10.string().describe("Nome ou id do campo"), workspace: z10.string().optional() },
       annotations: { destructiveHint: true }
     },
     withApi(async (api, a) => {
@@ -2055,9 +2465,9 @@ async function startServer() {
       title: "Mostrar/esconder campos padr\xE3o",
       description: `Esconde ou volta a mostrar campos padr\xE3o que o workspace n\xE3o usa (s\xF3 admins). Podem ser escondidos: ${HIDEABLE_FIELDS.join(", ")}. Nome e valor ficam sempre vis\xEDveis.`,
       inputSchema: {
-        hide: z9.array(z9.enum(HIDEABLE_FIELDS)).optional(),
-        show: z9.array(z9.enum(HIDEABLE_FIELDS)).optional(),
-        workspace: z9.string().optional()
+        hide: z10.array(z10.enum(HIDEABLE_FIELDS)).optional(),
+        show: z10.array(z10.enum(HIDEABLE_FIELDS)).optional(),
+        workspace: z10.string().optional()
       }
     },
     withApi(async (api, a) => {
@@ -2073,7 +2483,7 @@ async function startServer() {
     {
       title: "Renomear modelo de importa\xE7\xE3o",
       description: "Renomeia um modelo de importa\xE7\xE3o de CSV (admins ou quem criou o modelo).",
-      inputSchema: { template: z9.string().describe("Nome ou id do modelo"), name: z9.string().min(1).max(80), workspace: z9.string().optional() }
+      inputSchema: { template: z10.string().describe("Nome ou id do modelo"), name: z10.string().min(1).max(80), workspace: z10.string().optional() }
     },
     withApi(async (api, a) => {
       const c = await ctx(api);
@@ -2088,7 +2498,7 @@ async function startServer() {
     {
       title: "Apagar modelo de importa\xE7\xE3o",
       description: "Apaga um modelo de importa\xE7\xE3o (admins ou quem criou). Leads j\xE1 importados n\xE3o mudam.",
-      inputSchema: { template: z9.string().describe("Nome ou id do modelo"), workspace: z9.string().optional() },
+      inputSchema: { template: z10.string().describe("Nome ou id do modelo"), workspace: z10.string().optional() },
       annotations: { destructiveHint: true }
     },
     withApi(async (api, a) => {
@@ -2105,15 +2515,17 @@ async function startServer() {
       title: "Importar CSV",
       description: 'Importa leads de um arquivo CSV local. As colunas s\xE3o ligadas aos campos do workspace (padr\xE3o e personalizados); se a planilha j\xE1 foi importada antes, o modelo salvo \xE9 reaproveitado. Use dry_run=true para ver o mapeamento, colunas ignoradas (com tipo sugerido para criar campo) e problemas antes de gravar. Ajuste com columns: { "Coluna do CSV": "Nome do campo" | "ignorar" }.',
       inputSchema: {
-        path: z9.string().describe("Caminho do arquivo CSV (aceita ~)"),
-        funnel: z9.string().optional(),
-        workspace: z9.string().optional(),
-        stage: z9.string().optional(),
-        owner_mode: z9.enum(["me", "auto", "round_robin", "column"]).default("me").describe("me = voc\xEA; auto = distribuir por desempenho (quem fecha mais recebe mais, s\xF3 admins); round_robin = distribuir igualmente; column = coluna 'respons\xE1vel' (email)"),
-        duplicate: z9.enum(["skip", "update"]).default("skip"),
-        columns: z9.record(z9.string(), z9.string()).optional().describe('For\xE7a o destino de colunas: { "Munic\xEDpio": "Cidade", "Obs": "ignorar" }. Aceita campo padr\xE3o (Nome, Empresa, Email\u2026) ou personalizado.'),
-        dry_run: z9.boolean().default(false).describe("S\xF3 mostra o mapeamento e os problemas, sem importar"),
-        template_name: z9.string().max(80).optional().describe("Salva o mapeamento com este nome para as pr\xF3ximas importa\xE7\xF5es")
+        path: z10.string().describe("Caminho do arquivo CSV (aceita ~)"),
+        funnel: z10.string().optional(),
+        workspace: z10.string().optional(),
+        stage: z10.string().optional(),
+        owner_mode: z10.enum(["me", "auto", "round_robin", "column"]).optional().describe(
+          "Padr\xE3o: auto para admins e Masters (eles n\xE3o ficam com a base), me para vendedores. me = voc\xEA; auto = distribuir por desempenho entre os vendedores (quem fecha mais recebe mais); round_robin = distribuir igualmente entre os vendedores; column = coluna 'respons\xE1vel' (email). auto, round_robin e column s\xF3 para admins e Masters."
+        ),
+        duplicate: z10.enum(["skip", "update"]).default("skip"),
+        columns: z10.record(z10.string(), z10.string()).optional().describe('For\xE7a o destino de colunas: { "Munic\xEDpio": "Cidade", "Obs": "ignorar" }. Aceita campo padr\xE3o (Nome, Empresa, Email\u2026) ou personalizado.'),
+        dry_run: z10.boolean().default(false).describe("S\xF3 mostra o mapeamento e os problemas, sem importar"),
+        template_name: z10.string().max(80).optional().describe("Salva o mapeamento com este nome para as pr\xF3ximas importa\xE7\xF5es")
       }
     },
     withApi(
@@ -2123,8 +2535,8 @@ async function startServer() {
         const stage = resolve(funnel.stages, a.stage, "Etapa") ?? funnel.stages[0];
         const ws = c.workspaces.find((w) => w.id === funnel.workspaceId);
         const hidden = ws?.hiddenFields ?? [];
-        const file = path2.resolve(a.path.replace(/^~(?=$|\/)/, homedir2()));
-        const parsed = Papa.parse(await readFile2(file, "utf8"), { header: true, skipEmptyLines: "greedy", transformHeader: (h) => h.trim() });
+        const file = path3.resolve(a.path.replace(/^~(?=$|\/)/, homedir2()));
+        const parsed = Papa.parse(await readFile3(file, "utf8"), { header: true, skipEmptyLines: "greedy", transformHeader: (h) => h.trim() });
         const headers = (parsed.meta.fields ?? []).filter(Boolean);
         const [fields, templates] = await Promise.all([listFields(api, funnel.workspaceId), listTemplates(api, funnel.workspaceId)]);
         const match = matchTemplate(headers, templates);
@@ -2195,16 +2607,18 @@ async function startServer() {
         }
         const template = a.template_name ? { id: match?.template.name === a.template_name ? match.template.id : void 0, name: a.template_name, columns: mapping } : match && !changedFromTemplate ? { id: match.template.id, name: match.template.name, columns: mapping } : void 0;
         const me = await api.get("/auth/me");
+        const ownerMode = a.owner_mode ?? (me.user.role === "member" ? "me" : "auto");
         const res = await api.post(
           "/imports",
           {
             funnelId: funnel.id,
             stageId: stage.id,
-            ownerMode: a.owner_mode === "me" ? "fixed" : a.owner_mode,
-            ownerId: a.owner_mode === "me" ? me.user.id : void 0,
+            ownerMode: ownerMode === "me" ? "fixed" : ownerMode,
+            ownerId: ownerMode === "me" ? me.user.id : void 0,
             duplicate: a.duplicate,
             rows,
-            template
+            template,
+            origin: { fileName: path3.basename(a.path).slice(0, 200), valueColumn: headers.find((h) => mapping[h] === "std:value") }
           }
         );
         return text({
@@ -2220,9 +2634,19 @@ async function startServer() {
     )
   );
   registerManageTools(server);
+  if (role === "admin") registerIntegrationTools(server);
   await server.connect(new StdioServerTransport());
 }
 
+// src/skills.ts
+var SKILLS = ["aicrm", "aicrm-integrate"];
+function parseSkillArgs(args) {
+  const positional = args.filter((a, i) => !a.startsWith("--") && args[i - 1] !== "--dir");
+  const install = positional.includes("install");
+  const name = positional.find((a) => a !== "install") ?? "aicrm";
+  return { install, name };
+}
+
 // src/cli.ts
 var HELP = `AICRM MCP
 
@@ -2230,9 +2654,10 @@ Uso:
   aicrm-mcp login [--url https://seu-aicrm] [--email voce@empresa.com]
   aicrm-mcp logout
   aicrm-mcp whoami
-  aicrm-mcp skill                    imprime o SKILL.md (guia para agentes)
-  aicrm-mcp skill install [--project | --dir <pasta>]
-                                     instala em ~/.claude/skills/aicrm (ou no projeto atual)
+  aicrm-mcp skill [nome]             imprime o SKILL.md (guia para agentes)
+  aicrm-mcp skill install [nome] [--project | --dir <pasta>]
+                                     instala em ~/.claude/skills/<nome> (ou no projeto atual)
+      skills: aicrm (operar o CRM) \xB7 aicrm-integrate (integrar um sistema pela API)
   aicrm-mcp            inicia o servidor MCP (stdio) \u2014 use no seu cliente MCP
 
 Configurar:
@@ -2245,7 +2670,7 @@ function flag(name) {
 }
 async function login() {
   const existing = await loadCredentials();
-  const url = normalizeUrl(flag("url") ?? process.env.AICRM_URL ?? await ask("URL do AICRM", existing?.url ?? "http://localhost:5173"));
+  const url = normalizeUrl(flag("url") ?? process.env.AICRM_URL ?? await ask("URL do AICRM", existing?.url ?? "https://aicrm.dev"));
   const email2 = flag("email") ?? await ask("Email", existing?.user.email || void 0);
   const password2 = await askHidden("Senha");
   try {
@@ -2261,6 +2686,10 @@ async function login() {
     console.log(`
 Agora adicione ao seu cliente:
   claude mcp add aicrm -- npx -y aicrm-mcp`);
+    if (res.user.role === "developer")
+      console.log(`
+E instale o guia de integra\xE7\xE3o no projeto:
+  npx -y aicrm-mcp skill install aicrm-integrate --project`);
   } catch (e) {
     console.error(`
 \u2717 ${e.message}`);
@@ -2288,14 +2717,18 @@ async function whoami() {
     process.exit(1);
   }
 }
-var SKILL_PATH = new URL("../skill/aicrm/SKILL.md", import.meta.url);
 async function skill() {
-  const content = await readFile3(SKILL_PATH, "utf8");
-  if (process.argv[3] !== "install") return void process.stdout.write(content);
-  const base = flag("dir") ?? (process.argv.includes("--project") ? path3.join(process.cwd(), ".claude", "skills") : path3.join(homedir3(), ".claude", "skills"));
-  const target = path3.join(base, "aicrm", "SKILL.md");
-  await mkdir2(path3.dirname(target), { recursive: true });
-  await writeFile2(target, content);
+  const { install, name } = parseSkillArgs(process.argv.slice(3));
+  if (!SKILLS.includes(name)) {
+    console.error(`Skill desconhecido: ${name}. Dispon\xEDveis: ${SKILLS.join(", ")}`);
+    process.exit(1);
+  }
+  const content = await readFile4(new URL(`../skill/${name}/SKILL.md`, import.meta.url), "utf8");
+  if (!install) return void process.stdout.write(content);
+  const base = flag("dir") ?? (process.argv.includes("--project") ? path4.join(process.cwd(), ".claude", "skills") : path4.join(homedir3(), ".claude", "skills"));
+  const target = path4.join(base, name, "SKILL.md");
+  await mkdir2(path4.dirname(target), { recursive: true });
+  await writeFile3(target, content);
   console.log(`\u2713 Skill instalado em ${target}`);
 }
 var cmd = process.argv[2];